## Benchmarking & Performance

Timber was designed with an obsessive focus on performance and resource usage. In the `/benchmark` folder you'll find benchmarking tests.


```console
+---------------------------+------------+-----------------+--------------+
|  Timber benchmarking. 10 requests per test. Times are "real" CPU time.  |
+---------------------------+------------+-----------------+--------------+
|                           | Total      | Per request avg | Per log line |
+---------------------------+------------+-----------------+--------------+
| Control                   | 0.0077939  | 0.00077939      | 2.598e-05    |
| Timber probes only        | 0.00694394 | 0.00069439      | 2.315e-05    |
| Timber probes and logging | 0.00897193 | 0.00089719      | 2.991e-05    |
+---------------------------+------------+-----------------+--------------+
```

1. `Control` - This is vanilla rails app without Timber installed.
2. `Timber probels only` - The same rails app but with *only* the `Timber::Probes` installed, isolating probes performance.
3. `Timber probes and logging` - Testing the full Timber library, probes and adding context to each log line.

The benchmark can be run yourself via:

```console
$ appraisal ruby benchmark/rails_request.rb
```