add note on caller-reporting overhead to README

This commit is contained in:
Dave Clendenan 2016-12-02 09:52:11 -08:00
parent 5840194571
commit 802fba19a4
1 changed files with 6 additions and 0 deletions

View File

@ -75,6 +75,12 @@ This adds the caller as 'method' like so:
time="2015-03-26T01:27:38-04:00" level=fatal method=arcticcreatures.migrate msg="a penguin swims by" animal=penguin time="2015-03-26T01:27:38-04:00" level=fatal method=arcticcreatures.migrate msg="a penguin swims by" animal=penguin
``` ```
Note that this does add measurable overhead - the cost will depend on the of Go, but is between 20 and 40% in recent tests with 1.6 and 1.7. You can validate this in your environment via benchmarks:
```
go test -bench=.*CallerTracing
```
#### Example #### Example
The simplest way to use Logrus is simply the package-level exported logger: The simplest way to use Logrus is simply the package-level exported logger: