{"animal":"walrus","level":"info","msg":"A group of walrus emerges from the ocean","size":10,"time":"2014-03-10 19:57:38.562264131 -0400 EDT"}

{"level":"warning","msg":"The group's number increased tremendously!", "number":122,"omg":true,"time":"2014-03-10 19:57:38.562471297 -0400 EDT"}

{"animal":"walrus","level":"info","msg":"A giant walrus appears!", "size":10,"time":"2014-03-10 19:57:38.562500591 -0400 EDT"}

{"animal":"walrus","level":"info","msg":"Tremendously sized cow enters the ocean.", "size":9,"time":"2014-03-10 19:57:38.562527896 -0400 EDT"}

{"level":"fatal","msg":"The ice breaks!","number":100,"omg":true, "time":"2014-03-10 19:57:38.562543128 -0400 EDT"}

time="2015-03-26T01:27:38-04:00" level=debug msg="Started observing beach" animal=walrus number=8
time="2015-03-26T01:27:38-04:00" level=info msg="A group of walrus emerges from the ocean" animal=walrus size=10
time="2015-03-26T01:27:38-04:00" level=warning msg="The group's number increased tremendously!" number=122 omg=true
time="2015-03-26T01:27:38-04:00" level=debug msg="Temperature changes" temperature=-4
time="2015-03-26T01:27:38-04:00" level=panic msg="It's over 9000!" animal=orca size=9009
time="2015-03-26T01:27:38-04:00" level=fatal msg="The ice breaks!" err=&{0x2082280c0 map[animal:orca size:9009] 2015-03-26 01:27:38.441574009 -0400 EDT panic It's over 9000!} Мы обнаружили, что этот API заставляет вас думать о логировании таким образом, который создаёт гораздо более полезные сообщения. Мы были в бесчисленных ситуациях, когда всего лишь одно добавленное поле к уже существующему сообщению журнала сэкономило бы нам часы. Вызов WithFields является необязательным.

В общем, при использовании Logrus использование любых функций семейства printf следует рассматривать как подсказку о том, что вы должны добавить поле, однако вы всё равно можете использовать функции семейства printf с Logrus.

#### Стандартные поля

Часто бывает полезно всегда иметь поля, прикреплённые к сообщениям журнала в приложении или его частях. Например, вы можете захотеть всегда регистрировать request_id и user_ip в контексте запроса. Вместо того чтобы писать log.WithFields(log.Fields{"request_id": request_id, "user_ip": user_ip}) на каждой строке, вы можете создать logrus.Entry для передачи:

```go
requestLogger := log.WithFields(log.Fields{"request_id": request_id, "user_ip": user_ip})
requestLogger.Info("something happened on that request") # will log request_id and user_ip
requestLogger.Warn("something not great happened")

import (
  log "github.com/sirupsen/logrus"
  "gopkg.in/gemnasium/logrus-airbrake-hook.v2" // the package is named "airbrake"
  logrus_syslog "github.com/sirupsen/logrus/hooks/syslog"
  "log/syslog"
)

func init() {

  // Используйте перехватчик Airbrake, чтобы сообщать об ошибках, которые имеют уровень серьёзности Error или выше, службе отслеживания исключений. Вы можете создавать собственные перехватчики, см. раздел «Перехватчики».
  log.AddHook(airbrake.NewHook(123, "xyz", "production"))

  hook, err := logrus_syslog.NewSyslogHook("udp", "localhost:514", syslog.LOG_INFO, "")
  if err != nil {
    log.Error("Unable to connect to local syslog daemon")
  } else {
    log.AddHook(hook)
  }
}

log.Trace("Something very low level.")
log.Debug("Useful debugging information.")
log.Info("Something noteworthy happened!")
log.Warn("You should probably take a look at this.")
log.Error("Something failed but I'm not quitting.")
// Calls os.Exit(1) after logging
log.Fatal("Bye.")
// Calls panic() after logging
log.Panic("I'm bailing.")

// Будет регистрировать всё, что является информацией или выше (предупреждение, ошибка, фатальная ошибка, паника). По умолчанию.
log.SetLevel(log.InfoLevel)

Эта конфигурация предназначена для использования `logrus`, но JSON в
производстве в основном полезен только если вы выполняете агрегацию журналов с помощью таких инструментов, как
Splunk или Logstash.

#### Форматировщики

Встроенные форматировщики журналов:

* `logrus.TextFormatter`. Регистрирует событие в цвете, если stdout является tty, в противном случае
без цвета.
* *Примечание:* чтобы принудительно выводить цветной вывод, когда нет TTY, установите поле `ForceColors`
в `true`. Чтобы принудительно отключить цветной вывод, даже если есть TTY, установите поле `DisableColors` в `true`. Для Windows см.
[github.com/mattn/go-colorable](https://github.com/mattn/go-colorable).
* По умолчанию уровни усекаются до 4 символов. Чтобы отключить
усечение, установите для поля `DisableLevelTruncation` значение `true`.
* При выводе на TTY часто бывает полезно визуально сканировать вниз по столбцу, где все уровни имеют одинаковую ширину. Установка поля `PadLevelText` в `true` включает это поведение, добавляя отступ к тексту уровня.
* Все параметры перечислены в [сгенерированных документах](https://godoc.org/github.com/sirupsen/logrus#TextFormatter).
* `logrus.JSONFormatter`. Записывает поля в формате JSON.
* Все опции перечислены в [сгенерированных документах](https://godoc.org/github.com/sirupsen/logrus#JSONFormatter).

Сторонние форматировщики журналов:

* [`FluentdFormatter`](https://github.com/joonix/log). Форматирует записи, которые могут быть проанализированы Kubernetes и Google Container Engine.
* [`GELF`](https://github.com/fabienm/go-logrus-formatters). Форматирует записи в соответствии со спецификацией Graylog's [GELF 1.1](http://docs.graylog.org/en/2.4/pages/gelf.html).
* [`logstash`](https://github.com/bshuster-repo/logrus-logstash-hook). Записывает поля как события [Logstash](http://logstash.net).
* [`prefixed`](https://github.com/x-cray/logrus-prefixed-formatter). Отображает источник записи вместе с альтернативным макетом.
* [`zalgo`](https://github.com/aybabtme/logzalgo). Вызов силы Зальго.
* [`nested-logrus-formatter`](https://github.com/antonfisher/nested-logrus-formatter). Преобразует поля logrus в вложенную структуру.
* [`powerful-logrus-formatter`](https://github.com/zput/zxcTool). Получает имя файла, номер строки журнала и имя последней функции при печати журнала; сохраняет журнал в файлы.
* [`caption-json-formatter`](https://github.com/nolleh/caption_json_formatter). Форматер сообщений logrus с добавлением удобочитаемой подписи.

Вы можете определить свой собственный форматировщик, реализовав интерфейс `Formatter`, требующий метода `Format`. `Формат` принимает `*Entry`. `entry.Data` — это тип `Fields` (`map[string]interface{}`) со всеми вашими полями, а также с полями по умолчанию (см. раздел «Записи» выше):

```go
type MyJSONFormatter struct {
}

лог.SetFormatter(new(MyJSONFormatter))

func (f *MyJSONFormatter) Format(entry *Entry) ([]byte, error) {
// Обратите внимание, что это не включает Time, Level и Message, которые доступны в
// Entry. Обратитесь к `godoc` за информацией об этих полях или прочитайте исходный код официальных регистраторов.
serialized, err := json.Marshal(entry.Data)
  if err != nil {
    return nil, fmt.Errorf("Не удалось маршалировать поля в JSON, %w", err)
  }
return append(serialized, '\n'), nil
}

w := logger.Writer()
defer w.Close()

srv := http.Server{
    // создать стандартный регистратор log.Logger, который записывает в
    // logrus.Logger.
    ErrorLog: log.New(w, "", 0),
}

import(
  "github.com/sirupsen/logrus"
  "github.com/sirupsen/logrus/hooks/test"
  "github.com/stretchr/testify/assert"
  "testing"
)

func TestSomething(t*testing.T){
  logger, hook := test.NewNullLogger()
  logger.Error("Helloerror")

  assert.Equal(t, 1, len(hook.Entries))
  assert.Equal(t, logrus.ErrorLevel, hook.LastEntry().Level)
  assert.Equal(t, "Helloerror", hook.LastEntry().Message)

  hook.Reset()
  assert.Nil(t, hook.LastEntry())
}

...
handler := func() {
  // корректно завершаем работу...
}
logrus.RegisterExitHandler(handler)
...