Конфигурация log-файлов агента

Конфигурация log-файлов агента выполняется в файле:

  • %programfiles%/SAYMON Agent/conf/logback-winservice.xml (Windows).

  • /opt/saymon-agent/conf/logback-daemon.xml (Linux/Mac OS).

Логирование выполняется на уровне INFO. При необходимости возможно дополнительно настроить debug-режим.

Агент выполняет ротацию логов раз в день, старые логи архивируются.

Архивация происходит в момент поступления в лог новой информации от агента. Если новых записей нет, архивация не выполняется.

Базовое логирование

Пример секции настроек базового логирования:

<appender name="FILE-INFO" class="RollingFileAppender">
    <file>log/saymon-agent.info.log</file>
    <rollingPolicy class="TimeBasedRollingPolicy">
        <!-- Daily rollover -->
        <fileNamePattern>log/saymon-agent.info.%d{yyyy-MM-dd}.log.zip</fileNamePattern>
        <!-- Keep 10 days' worth of history -->
        <maxHistory>10</maxHistory>
        <!-- Limit total size of all archive logs to 50 MB. -->
        <totalSizeCap>50MB</totalSizeCap>
    </rollingPolicy>
    <encoder class="PatternLayoutEncoder">
        <pattern>%d{dd.MM.yyyy HH:mm:ss.SSS} [%-15thread] %-5level %logger{36} - %msg %kvp%n%rootException</pattern>
    </encoder>
</appender>

где

  • <file>log/saymon-agent.info.log</file> — размещение log-файла;

  • <fileNamePattern>…​ .zip</fileNamePattern> — указание на архивацию файлов в формат .zip;

  • <maxHistory>10</maxHistory> — длительность хранения файлов в днях;

  • <totalSizeCap>50MB</totalSizeCap> — ограничение дискового пространства для хранения логов.

Полная информация о настройках доступна в документации по Logback.

Активация debug-режима

Для активации debug-режима необходимо:

  1. Заменить содержимое файла конфигурации log-файлов агента содержимым файла

    • logback-winservice-debug.xml (Windows);

    • logback-daemon-debug.xml (Linux/Mac OS).

      В этом файле находится секция настроек debug-режима:

      <appender name="FILE-DEBUG" class="RollingFileAppender">
      ...
      </appender>
      Файл с секцией настроек debug-режима находится в той же папке, что и файл конфигурации log-файлов агента.
  2. Перезапустить агента:

    • служба SaymonAgent (Windows);

    • служба saymon-agent (Linux/Mac OS).

Параметры и структура секции debug-режима аналогичны секции базового логирования.