Конфигурация уровня логирования в API 1.7 с slf4j-simple

Быстрый ответ

Чтобы быстро установить уровень логирования для slf4j-simple, примените следующую настройку:

-Dorg.slf4j.simpleLogger.defaultLogLevel=debug

Для более детальной кастомизации используйте файл свойств:

-Dorg.slf4j.simpleLogger.propertiesFile=mylogger.properties

В файле mylogger.properties настройте основные параметры:

org.slf4j.simpleLogger.defaultLogLevel=info
org.slf4j.simpleLogger.showDateTime=true
org.slf4j.simpleLogger.dateTimeFormat=yyyy-MM-dd HH:mm:ss

Эти параметры можно отрегулировать в соответствии с потребностями проекта.

Конфигурирование файла simplelogger.properties

Основные свойства

Для управления настройками slf4j-simple измените содержимое файла simplelogger.properties:

• org.slf4j.simpleLogger.logFile определяет цель логирования — файл лога или консоль.
• org.slf4j.simpleLogger.showThreadName активирует отображение имён потоков, что полезно при диагностике проблем, связанных с многопоточностью.
• org.slf4j.simpleLogger.levelInBrackets обрамляет уровни логирования скобками для улучшения визуального восприятия.
• org.slf4j.simpleLogger.showShortLogName укорачивает имена логов, экономя место на экране и улучшая читаемость.

Каждый раз при запуске приложения настройки логирования сбрасываются. В такие моменты захочется выпить чашечку кофе ☕ и начать всё с чистого листа.

Подробнее об этом расскажет наш спикер на видео

Форматирование даты и времени

Для настройки отображения временных меток используйте шаблоны SimpleDateFormat:

org.slf4j.simpleLogger.dateTimeFormat=HH:mm:ss.SSS

В случае ночных сбоев в коде, временные маркеры, точные до миллисекунд, не позволят переложить вину на других.

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

slf4j-simple не дает возможности менять уровни логирования в реальном времени. Для этой цели лучше использовать Log4j bridge или Logback.

Визуализация

Настройка slf4j-simple напоминает настройку для старинного радиоприёмника (📻):

          🎚️ Регулятор громкости
==============================
| Trace | Debug | Info | Warn | Error |
         📻 <---(🔧)--- Настраивайте здесь

Перемещение кнопки (🔧) позволит задать нужный уровень логирования:

# Установим уровень 'Info'
-Dorg.slf4j.simpleLogger.defaultLogLevel=info

📻 После этого приложение начнёт транслировать логи начиная с уровня Info и выше.

Профессиональное устранение проблем

Загрузка файла со свойствами

Если файл simplelogger.properties не загружается, убедитесь, что он расположен в classpath приложения:

-Dorg.slf4j.simpleLogger.propertiesFile=path/to/your/simplelogger.properties

Стабильность логирования

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

Иерархия уровней логирования

Иерархия уровней логирования объясняется строгой последовательностью:

# Только предупреждения и ошибки будут записаны
org.slf4j.simpleLogger.defaultLogLevel=warn

С такими настройками логи уровней DEBUG и TRACE будут проигнорированы.

Основные правила и ловушки логирования

Разграничивание профилей

Используйте разные файлы свойств для различных сред: разработка, тестирование и производственная среда.

Ловушка избыточного логирования

Избыточное логирование может засорить журналы и снизить производительность. Скорректируйте использование уровней TRACE и DEBUG.

Ошибки в формате даты и времени

Неправильно заданный шаблон dateTimeFormat может вызвать ошибки. Проверяйте шаблоны с помощью SimpleDateFormat.

Полезные материалы

1. Глава 3: Конфигурация — официальное руководство по Logback.
2. Часто задаваемые вопросы SLF4J — ответы на распространённые вопросы.
3. GitHub – qos-ch/slf4j: Простой фасад логирования для Java — исходный код SLF4J.
4. Log4j Bridge — инструкции по использованию моста между log4j и SLF4J.