Соглашения по ведению журнала

etcd использует библиотеку zap для ведения журнала вывода приложения, категоризированного по уровням. Уровень сообщения в журнале определяется в соответствии со следующими соглашениями:

• Логи DebugLevel обычно объёмные и обычно отключены в рабочей среде.

  • Примеры:
    • Отправка обычного сообщения удалённому узлу
    • Запись записи журнала на диск

• Уровень InfoLevel является уровнем ведения журнала по умолчанию.

  • Примеры:
    • Конфигурация при запуске
    • Начало создания снимка
    • Добавление нового узла в кластер
    • Добавление нового пользователя в подсистему аутентификации

• Журналы уровня Warn более важны, чем Info, но не требуют индивидуального человеческого контроля.

  • Примеры:
    • Неудача при отправке сообщения Raft удалённому узлу
    • Неудача при получении сообщения heartbeat в течение заданного тайм-аута выборов

• Журналы уровня ошибок имеют высокий приоритет. Если приложение работает без сбоев, оно не должно генерировать журналы уровня ошибок.

  • Примеры:
    • Неудача выделения дискового пространства для WAL

• PanicLevel записывает сообщение, а затем вызывает панику.

  • Примеры:
    • Сбой при кодировании сообщений Raft

• FatalLevel записывает сообщение, а затем вызывает os.Exit(1).

  • Примеры:
    • Неудача при сохранении снимка Raft