Уровни логирования¶
- Процесс логирования настраивается и имеет несколько уровней:
- 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, необходимо:
Установить библиотеку Raven:
pip3 install raven
В файле конфигурации соответствующего модуля выставить следующие значения:
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 файлов.
Важно
Последовательность применения значения этого параметра: сначала применяется настройка из общего файла настроек для всех модулей, затем применяются настройки из индивидуальных файлов настроек каждого модуля. В случае наличия одинаковых секций в обоих файлах настроек – значение из индивидуального файла настроек каждого из модулей имеет приоритет над значением в общем файле.