В этой статье разберёмся, что такое уровни логирования в Log4j, как устроен их порядок и приоритет, а также как настраивать пользовательские фильтры. Если вы когда-нибудь настраивали сервер, ловили баги на проде или просто хотели понять, почему ваши логи превращаются в бесконечный поток бессмысленных сообщений, — эта статья для вас. Мы не будем пересказывать документацию, а разложим всё по полочкам, чтобы вы могли быстро внедрить грамотное логирование, не утонув в тоннах ненужной информации. В конце — практические советы, примеры, схемы, а также нестандартные лайфхаки для автоматизации и скриптов. Погнали!

Как это работает? — Уровни Log4j простым языком

Log4j — это библиотека для логирования на Java, но её концепции давно стали стандартом для многих языков и платформ. Основная фишка — уровни логирования (log levels). Они позволяют фильтровать сообщения по важности, чтобы не захламлять логи и не пропустить критичные ошибки.

• Уровень — это приоритет сообщения. Чем выше уровень, тем важнее событие.
• Log4j обрабатывает только те сообщения, которые равны или выше заданного уровня.
• Фильтры позволяют ещё тоньше настраивать, что попадёт в лог, а что — нет.

Вот базовые уровни Log4j (от самого низкого к самому высокому):

Уровень	Приоритет	Описание	Когда использовать
ALL	0	Логируются все сообщения	Для отладки, когда нужно увидеть абсолютно всё
TRACE	1	Очень подробная отладка (шаги, детали)	Глубокая отладка, редко на проде
DEBUG	2	Отладочная информация	Разработка, тестирование
INFO	3	Информационные сообщения	Обычная работа приложения
WARN	4	Предупреждения (что-то не так, но не критично)	Потенциальные проблемы
ERROR	5	Ошибки, которые не останавливают приложение	Важные сбои
FATAL	6	Критические ошибки, после которых приложение не может продолжать работу	Падения, аварии
OFF	7	Логирование отключено	Когда логи не нужны вообще

Всё просто: если у вас стоит уровень INFO, то в лог попадут только сообщения INFO, WARN, ERROR, FATAL. Всё, что ниже (DEBUG, TRACE), — игнорируется.

Как быстро и просто всё настроить?

В Log4j всё крутится вокруг конфигов. Можно использовать XML, JSON, YAML или properties-файлы. Вот пример самого простого конфига на properties:


# log4j2.properties
status = error
name = PropertiesConfig

appender.console.type = Console
appender.console.name = STDOUT
appender.console.layout.type = PatternLayout
appender.console.layout.pattern = %d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n

rootLogger.level = info
rootLogger.appenderRefs = stdout
rootLogger.appenderRef.stdout.ref = STDOUT


• rootLogger.level = info — задаёт уровень логирования по умолчанию.
• Можно настраивать уровни для отдельных пакетов или классов:


logger.myapp.name = com.example.myapp
logger.myapp.level = debug


Теперь всё, что в com.example.myapp, будет логироваться с уровнем DEBUG, а остальное — с INFO.

Пользовательские фильтры: гибкость на стероидах

Фильтры позволяют ещё тоньше контролировать, что попадёт в лог. Например, можно логировать только сообщения, содержащие определённый текст, или только из определённого потока.


appender.console.filter.threshold.type = ThresholdFilter
appender.console.filter.threshold.level = error


Этот фильтр пропустит только ERROR и выше. Можно комбинировать фильтры, использовать RegexFilter, ScriptFilter и даже писать свои на Java или Groovy.

Примеры, схемы, практические советы

Кейс 1: Логи захламлены, не видно ошибок

• Проблема: В логах тонны DEBUG и INFO, а ошибки теряются.
• Решение: Поднять уровень rootLogger до WARN или ERROR.
• Рекомендация: Для продакшена используйте минимум INFO, а лучше WARN. Для отладки — DEBUG или TRACE, но только временно!

Кейс 2: Нужно отследить баг в одном модуле

• Проблема: Глобальный уровень — INFO, но нужен DEBUG для одного пакета.
• Решение: В конфиге добавить отдельный logger для нужного пакета с уровнем DEBUG.
• Рекомендация: Не бойтесь миксовать уровни для разных частей приложения.

Кейс 3: Логи растут как на дрожжах, места не хватает

• Проблема: Огромные логи, быстро забивается диск.
• Решение: Использовать фильтры, ротацию логов, хранить только WARN и выше.
• Рекомендация: Настройте RollingFileAppender и фильтры по уровню.

Сценарий	Уровень rootLogger	Фильтры	Результат
Разработка	DEBUG	Нет	Всё видно, много шума
Продакшн	WARN	ThresholdFilter: WARN	Только важные сообщения
Поиск бага	INFO	Logger для пакета: DEBUG	Детализация только где надо

Команды и примеры конфигов

Log4j — это не shell-утилита, но вот типовые команды для работы с логами на сервере:


# Просмотр последних 100 строк лога
tail -n 100 /var/log/myapp/app.log

# Поиск ошибок
grep ERROR /var/log/myapp/app.log

# Ротация логов (logrotate)
logrotate /etc/logrotate.d/myapp


Пример конфигурации с ротацией и фильтрами:


appender.rolling.type = RollingFile
appender.rolling.name = RollingFile
appender.rolling.fileName = logs/app.log
appender.rolling.filePattern = logs/app-%d{yyyy-MM-dd}-%i.log.gz
appender.rolling.layout.type = PatternLayout
appender.rolling.layout.pattern = %d %p %c{1.} [%t] %m%n
appender.rolling.policies.type = Policies
appender.rolling.policies.time.type = TimeBasedTriggeringPolicy
appender.rolling.policies.time.interval = 1
appender.rolling.policies.size.type = SizeBasedTriggeringPolicy
appender.rolling.policies.size.size = 100MB
appender.rolling.filter.threshold.type = ThresholdFilter
appender.rolling.filter.threshold.level = warn

rootLogger.level = info
rootLogger.appenderRefs = rolling
rootLogger.appenderRef.rolling.ref = RollingFile


Похожие решения, программы и утилиты

• Log4j 2.x — официальный сайт
• Logback — альтернатива от автора Log4j
• SLF4J — фасад для логирования, работает с Log4j, Logback и др.
• Spring Boot Logging — интеграция логирования в Spring Boot
• Filebeat — для сбора и отправки логов в Elasticsearch

Статистика и сравнение с другими решениями

Система	Гибкость уровней	Фильтры	Производительность	Расширяемость
Log4j 2	Максимальная	Да (скрипты, regex, кастомные)	Высокая	Плагины, API
Logback	Высокая	Да	Очень высокая	Плагины
java.util.logging	Средняя	Ограниченные	Средняя	Мало расширяем

Log4j 2 — лидер по гибкости и возможностям фильтрации. Logback чуть быстрее, но уступает по расширяемости. java.util.logging — для простых задач, но кастомизации мало.

Интересные факты и нестандартные способы использования

• Можно писать фильтры на Groovy или JavaScript прямо в конфиге Log4j 2 — для сложных сценариев фильтрации.
• Log4j 2 поддерживает асинхронное логирование — это ускоряет работу на нагруженных серверах.
• Можно отправлять логи не только в файлы, но и в Kafka, JMS, Elasticsearch, email и даже Slack.
• С помощью фильтров можно реализовать “секретные” логи — например, логировать только события от определённых пользователей или IP-адресов.
• Log4j 2 умеет динамически менять уровни логирования без перезапуска приложения (JMX, API, hot reload).

Новые возможности для автоматизации и скриптов

• Фильтры позволяют автоматически отсекать шум и отправлять только важные события в системы мониторинга (например, Prometheus, Zabbix, Grafana).
• Можно на лету менять уровни логирования через API — удобно для автоматических скриптов и CI/CD.
• Логи можно парсить и анализировать с помощью Filebeat, Logstash, Graylog — фильтры Log4j помогают уменьшить объём данных для передачи.
• С помощью скриптов можно автоматически архивировать или удалять старые логи, основываясь на уровне сообщений.

Вывод — заключение и рекомендации

Грамотная настройка уровней логирования и фильтров в Log4j — это не только про чистоту логов, но и про производительность, безопасность и удобство поддержки серверов. Не стоит логировать всё подряд — это быстро превращается в ад для админа и разработчика. Используйте уровни логирования по назначению: DEBUG и TRACE — только для отладки, INFO — для обычной работы, WARN и ERROR — для продакшена. Не забывайте про фильтры: они позволяют тонко настраивать, что попадёт в логи, а что — нет. Экспериментируйте с асинхронным логированием и кастомными фильтрами — это реально ускоряет работу и экономит ресурсы.

Если вы ищете быстрый и надёжный сервер для своих проектов — посмотрите VPS или выделенные серверы на этом блоге. А если остались вопросы по настройке Log4j — пишите в комментарии, разберём кейсы!

Официальная документация Log4j 2: https://logging.apache.org/log4j/2.x/manual/architecture.html

---

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

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