Ведение журнала Elasticsearch: Включение и настройка уровней журнала

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

Настройка уровней ведения журнала

Elasticsearch использует Log4j2 для ведения журналов, что позволяет настраивать уровни журналов для различных компонентов. По умолчанию установлен уровень журнала "INFO", но для получения более подробных журналов его можно изменить на "DEBUG" или "TRACE". Для настройки уровней журнала необходимо изменить файл `log4j2.properties`, расположенный в директории `config` установки Elasticsearch.

Ниже приводится пошаговое руководство по настройке уровней журналов в Elasticsearch

1. Откройте файл `log4j2.properties` в текстовом редакторе.
2. Найдите строку, начинающуюся с `logger.action.level`. Эта строка задает уровень журнала для модуля действий. По умолчанию она должна выглядеть следующим образом:
   logger.action.level = info

   1	logger.action.level = info

3. При необходимости измените уровень журнала на "DEBUG" или "TRACE". Например, чтобы установить уровень журнала на "DEBUG", измените строку следующим образом:
   logger.action.level = debug

   1	logger.action.level = debug

4. Сохраните изменения и перезапустите Elasticsearch, чтобы новый уровень журнала вступил в силу.
   Вы также можете настроить уровни журналов для других компонентов, добавив новые строки в файл `log4j2.properties`. Например, чтобы установить уровень журнала для модуля discovery на "DEBUG", добавьте следующую строку:
   logger.discovery.level = debug

   1	logger.discovery.level = debug

Настройка форматов журналов

По умолчанию журналы Elasticsearch оформляются в виде обычного текста, но при необходимости можно настроить их на использование формата JSON. Чтобы изменить формат журнала, необходимо модифицировать файл "log4j2.properties".

Вот как настроить журналы Elasticsearch на использование формата JSON

1. Откройте файл `log4j2.properties` в текстовом редакторе.
2. Найдите строку, начинающуюся с `appender.console.layout.type`. По умолчанию она должна выглядеть следующим образом:
   appender.console.layout.type = PatternLayout

   1	appender.console.layout.type = PatternLayout

3. Измените тип макета на "JsonLayout". Измените строку следующим образом:
   appender.console.layout.type = JsonLayout

   1	appender.console.layout.type = JsonLayout

4. Сохраните изменения и перезапустите Elasticsearch, чтобы новый формат журнала вступил в силу.

Настройка ротации журналов

Elasticsearch автоматически ротирует файлы журналов при достижении ими определенного размера или возраста. По умолчанию файлы журналов ротируются ежедневно или по достижении ими размера 100 МБ. Настройки ротации журналов можно задать в файле `log4j2.properties`.

Вот как настроить ротацию журнала в Elasticsearch

1. Откройте файл `log4j2.properties` в текстовом редакторе.
2. Найдите строку, начинающуюся с `appender.rolling.strategy.type`. По умолчанию она должна выглядеть следующим образом:
   appender.rolling.strategy.type = DefaultRolloverStrategy

   1	appender.rolling.strategy.type = DefaultRolloverStrategy

3. Измените параметр `appender.rolling.strategy.max`, чтобы задать максимальное количество сохраняемых лог-файлов. Например, для хранения до 30 файлов журнала измените строку следующим образом:
   appender.rolling.strategy.type = DefaultRolloverStrategy appender.rolling.strategy.max = 30

   1 2	appender.rolling.strategy.type = DefaultRolloverStrategy appender.rolling.strategy.max = 30

4. Найдите строку, начинающуюся с `appender.rolling.policies.type`. По умолчанию она должна выглядеть следующим образом:
   appender.rolling.policies.type = Policies

   1	appender.rolling.policies.type = Policies

5. Измените параметры `appender.rolling.policies.time.type` и `appender.rolling.policies.time.interval` для установки интервала ротации журналов. Например, для ротации журналов каждые 12 часов измените строки следующим образом:
   appender.rolling.policies.type = Policies appender.rolling.policies.time.type = TimeBasedTriggeringPolicy appender.rolling.policies.time.interval = 12

   1 2 3

   appender.rolling.policies.type = Policies appender.rolling.policies.time.type = TimeBasedTriggeringPolicy appender.rolling.policies.time.interval = 12

6. Сохраните изменения и перезапустите Elasticsearch, чтобы новые настройки ротации журнала вступили в силу.

Заключение

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