Логирование сервера приложений.#

Общий обзор#

Логирование в проекте осуществляется с использованием Logback. Конфигурация логирования задается в XML-файлах, расположенных в каталоге {{workspace}}/application/config/.

Структура конфигурационных файлов#

{{workspace}}/
└── application/
    └── config/
        ├── logback-LoggerContext.xml  # Основной файл конфигурации системных логов
        ├── logback-LoggerContext-ext.xml # Проектные настройки системных логов
        ├── logback-LoggerContext-session.xml  # Основной файл конфигурации логов сессии
        ├── logback-LoggerContext-session-ext.xml # Проектные настройки логов сессии

! Внимание!
Логирование в проекте настроено с учетом системных и сессионных логов.
Изменение основных файлов конфигурации запрещено, но пользователь может вносить свои изменения через файлы logback-LoggerContext-ext.xml и logback-LoggerContext-session-ext.xml.

Основные конфигурационные файлы#

  1. logback-LoggerContext.xml

    • Основной файл конфигурации логирования.

    • Отвечает за запись системных логов.

    • Фиксирует сообщения начиная с уровня INFO и выше.

    • Изменение этого файла не допускается.

  2. logback-LoggerContext-session.xml

    • Конфигурация логирования текущей сессии.

    • Фиксирует сообщения начиная с уровня WARN и выше.

    • Изменение этого файла не допускается.

Расширяемые файлы конфигурации#

Если требуется изменить настройки логирования, пользователь может использовать специальные файлы расширений:

  1. logback-LoggerContext-ext.xml

    • Подключается к logback-LoggerContext.xml.

    • Позволяет добавить или изменить настройки логирования системных событий.

  2. logback-LoggerContext-session-ext.xml

    • Подключается к logback-LoggerContext-session.xml.

    • Позволяет добавить или изменить настройки логирования текущей сессии.

Пример добавления кастомного логгера#

Чтобы добавить кастомный логгер в файл logback-LoggerContext-ext.xml, можно использовать следующий шаблон:

 <included> 
     <appender name="FILEOUT-EXT" class="ch.qos.logback.core.rolling.RollingFileAppender"> 
         <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"> 
             <fileNamePattern>/opt/global/globalserver/logs/global3.%d{yyyy-MM-dd_HH}.log</fileNamePattern> 
         </rollingPolicy> 
         <encoder> 
             <pattern>%d{HH:mm:ss.SSS} [%thread] %logger - %msg%n</pattern> 
         </encoder> 
     </appender> 
	
	
	 <root level="INFO"> 
	 <appender-ref ref="FILEOUT-EXT"/> 
	 </root> 
 </included>