forked from jshiffer/matterbridge
62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Package log implements a simple structured logging API inspired by Logrus, designed with centralization in mind. Read more on [Medium](https://medium.com/@tjholowaychuk/apex-log-e8d9627f4a9a#.rav8yhkud).
|
|||
|
|
|
|||
|
|
## Handlers
|
|||
|
|
|
|||
|
|
- __apexlogs__ – handler for [Apex Logs](https://apex.sh/logs/)
|
|||
|
|
- __cli__ – human-friendly CLI output
|
|||
|
|
- __discard__ – discards all logs
|
|||
|
|
- __es__ – Elasticsearch handler
|
|||
|
|
- __graylog__ – Graylog handler
|
|||
|
|
- __json__ – JSON output handler
|
|||
|
|
- __kinesis__ – AWS Kinesis handler
|
|||
|
|
- __level__ – level filter handler
|
|||
|
|
- __logfmt__ – logfmt plain-text formatter
|
|||
|
|
- __memory__ – in-memory handler for tests
|
|||
|
|
- __multi__ – fan-out to multiple handlers
|
|||
|
|
- __papertrail__ – Papertrail handler
|
|||
|
|
- __text__ – human-friendly colored output
|
|||
|
|
- __delta__ – outputs the delta between log calls and spinner
|
|||
|
|
|
|||
|
|
## Example
|
|||
|
|
|
|||
|
|
Example using the [Apex Logs](https://apex.sh/logs/) handler.
|
|||
|
|
|
|||
|
|
```go
|
|||
|
|
package main
|
|||
|
|
|
|||
|
|
import (
|
|||
|
|
"errors"
|
|||
|
|
"time"
|
|||
|
|
|
|||
|
|
"github.com/apex/log"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
func main() {
|
|||
|
|
ctx := log.WithFields(log.Fields{
|
|||
|
|
"file": "something.png",
|
|||
|
|
"type": "image/png",
|
|||
|
|
"user": "tobi",
|
|||
|
|
})
|
|||
|
|
|
|||
|
|
for range time.Tick(time.Millisecond * 200) {
|
|||
|
|
ctx.Info("upload")
|
|||
|
|
ctx.Info("upload complete")
|
|||
|
|
ctx.Warn("upload retry")
|
|||
|
|
ctx.WithError(errors.New("unauthorized")).Error("upload failed")
|
|||
|
|
ctx.Errorf("failed to upload %s", "img.png")
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
[](https://semaphoreci.com/tj/log)
|
|||
|
|
[](https://godoc.org/github.com/apex/log)
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
<a href="https://apex.sh"><img src="http://tjholowaychuk.com:6000/svg/sponsor"></a>
|