re
/
logrus
forked from mirror/logrus
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

readme: add comments

This commit is contained in:
Simon Eskildsen 2014-03-10 19:30:06 -04:00
parent 23c5312e67
commit d3ee06cc28
1 changed files with 5 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
README.md
View File

@ -5,7 +5,7 @@ completely API compatible with the standard library logger.
#### Fields #### Fields
Logrus encourages careful, informative logging. It encourages the use of logging Logrus encourages careful, structured logging. It encourages the use of logging
fields instead of long, unparseable error messages. For example, instead of: fields instead of long, unparseable error messages. For example, instead of:
`log.Fatalf("Failed to send event %s to topic %s with key %d")`, you should log `log.Fatalf("Failed to send event %s to topic %s with key %d")`, you should log
the much more discoverable: the much more discoverable:
@ -30,13 +30,15 @@ seen as a hint you want to add a field, however, you can still use the
#### Hooks #### Hooks
You can add hooks for logging levels. For example to send errors to an exception You can add hooks for logging levels. For example to send errors to an exception
tracking service: tracking service on `LevelError`, `LevelFatal` and `LevelPanic`.
```go ```go
log = logrus.New() log = logrus.New()
type AirbrakeHook struct {} type AirbrakeHook struct {}
// `Fire()` takes the entry that the hook is fired for. `entry.Data[]` contains
// the fields for the entry. See the Fields section of the README.
func (hook *AirbrakeHook) Fire(entry *Entry) (error) { func (hook *AirbrakeHook) Fire(entry *Entry) (error) {
err := airbrake.Notify(errors.New(entry.String())) err := airbrake.Notify(errors.New(entry.String()))
if err != nil { if err != nil {
@ -49,6 +51,7 @@ func (hook *AirbrakeHook) Fire(entry *Entry) (error) {
return nil return nil
} }
// `Levels()` returns a slice of `LevelTypes` the hook is fired for.
func (hook *AirbrakeHook) Levels() []logrus.LevelType { func (hook *AirbrakeHook) Levels() []logrus.LevelType {
return []logrus.LevelType{ return []logrus.LevelType{
logrus.LevelError, logrus.LevelError,