Уровни логирования

Процесс логирования настраивается и имеет несколько уровней:
  • DEBUG - фиксируются события с уровнями: DEBUG, INFO, WARNING, ERROR, CRITICAL;
  • INFO - фиксируются события с уровнями: INFO, WARNING, ERROR, CRITICAL;
  • WARNING - фиксируются события с уровнями: WARNING, ERROR, CRITICAL;
  • ERROR - фиксируются события с уровнями: ERROR и CRITICAL;
  • CRITICAL - фиксируются события с уровнем CRITICAL.
Описание уровней сообщений о событиях, попадающих в лог файлы:
  • DEBUG - подробное и детальное логирование всей системной информации для последующего использования в отладке;
  • INFO - подтверждение, информация о событиях, не приводящих к ошибкам в работе модулей;
  • WARNING - информация о событиях, которые могут привести к ошибкам в работе модулей;
  • ERROR - информация об ошибках, возникших в работе модулей;
  • CRITICAL - информация о критических ошибках, возникших в работе модулей.
Настройка уровня логирования осуществляется:
Настройка уровней детализации сообщений о событиях производится в секции:
  • LOG_LEVEL

    Параметр выставляется в соответствии с необходимым уровнем логирования: DEBUG, INFO, WARNING, ERROR, CRITICAL.

У каждого модуля может быть задан свой уровень детализации сообщений о событиях.

Важно

Последовательность применения значения этого параметра: сначала применяется настройка из общего файла настроек для всех модулей, затем применяются настройки из индивидуальных файлов настроек каждого модуля. В случае наличия одинаковых секций в обоих файлах настроек – значение из индивидуального файла настроек каждого из модулей имеет приоритет над значением в общем файле.

Примечание

С описанием процесса логирования, предоставляемого платформой OpenStack, можно ознакомиться в соответствующем разделе официальной документации.

Логирование Sentry

Для модулей CloudManager, Dashboard, Monitor, RSserver и Scheduler предусмотрена возможность централизованного логирования при помощи системы мониторинга ошибок Sentry.

Для того, чтобы включить отправку сообщений об ошибках в Sentry, необходимо:

  1. Установить библиотеку Raven:

    pip3 install raven
    
  2. В файле конфигурации соответствующего модуля выставить следующие значения:

    SENTRY:
        ENABLED: True
        DSN: http://1d91324a511a54791a396f4fadca925ec:1a35b43635bf4dce9d0d59ae08d8bf99@my.sentry.loc/2
    

Ротация логов

Процесс ротации логов настраивается и имеет несколько типов:
  • size - осуществляет ротацию, основываясь на размере файла логирования;
  • interval - осуществляет ротацию в определенный интервал;
  • None - ротация не осуществляется.
Настройка типа ротации осуществляется:
Настройка ротации логов производится в следующих параметрах секции DEFAULT:
  • log_rotation_type

    Параметр выставляется в соответствии с необходимым типом ротации: size, interval, None.

  • max_logfile_count

    Параметр указывает на макисмальное возможное количество файлов логирования.

  • log_rotate_interval_type

    Параметр выставляется в соответствии с необходимым типом интервала ротации: Seconds, Minutes, Hours, Days, Weekday, Midnight.

  • log_rotate_interval

    Параметр выставляется в соответствии с необходимым интервалом ротации.

  • max_logfile_size_mb

    Параметр указывает на макисмальный размер файла логирования

У каждого модуля могут быть заданы свои настройки ротации логов.

Пример настройки ротации логов по размеру:

[DEFAULT]
log_rotation_type = size
max_logfile_size_mb = 1024  # MB
max_logfile_count = 30

В данном примере ротация логов будет происходить при достижении размера файла в 1 ГБ, при этом хранится не более 30 файлов.

Пример настройки ротации логов по интервалу:

[DEFAULT]
log_rotation_type = interval
log_rotate_interval = 12
log_rotate_interval_type = Hours
max_logfile_count = 60

В данном примере ротация логов происходит раз в 12 часов, при этом хранится не более 60 файлов.

Важно

Последовательность применения значения этого параметра: сначала применяется настройка из общего файла настроек для всех модулей, затем применяются настройки из индивидуальных файлов настроек каждого модуля. В случае наличия одинаковых секций в обоих файлах настроек – значение из индивидуального файла настроек каждого из модулей имеет приоритет над значением в общем файле.