Войти
 | |
| Разработчик (и) | Apache Software Foundation |
|---|---|
| Первоначальный выпуск | 8 января, 2001; 19 лет назад (2001-01-08) |
| Стабильный выпуск | 2.13.3 / 10 мая 2020 г.; 5 месяцев назад (2020-05-10) |
| Репозиторий | Репозиторий Log4j |
| Написано на | Java |
| Операционная система | Кросс-платформенная |
| Тип | Ведение журнала |
| Лицензия | Лицензия Apache 2.0 |
| Веб-сайт | ведение журнала.apache.org / log4j /2.x/ |
Apache Log4j - это Java -на основе утилиты журналирования. Первоначально он был написан Ceki Gülcü и является частью проекта Apache Software Foundation. Log4j - одна из нескольких платформ ведения журналов Java..
Gülcü с тех пор начал проекты SLF4J и Logback с намерением предложить преемника Log4j.
Команда Apache Log4j создала преемника Log4j 1 с номером версии 2. Log4j 2 был разработан с упором на проблемы Log4j 1.2, 1.3, java.util.logging и Logback, а также устраняет проблемы, которые появились в тех рамках. Кроме того, Log4j 2 предлагает архитектуру плагинов, которая делает его более расширяемым, чем его предшественник. Log4j 2 не имеет обратной совместимости с версиями 1.x, хотя доступен «адаптер».
5 августа 2015 года Комитет по управлению проектами Apache Logging Services объявил, что срок службы Log4j 1 подошел к концу и пользователям Log4j 1 рекомендуется перейти на Apache Log4j 2.
Apache Log4j 2 является преемником Log4j 1, который был выпущен как Версия GA выпущена в июле 2014 года. Фреймворк был переписан с нуля и основан на существующих решениях для ведения журналов, включая Log4j 1 и java.util.logging. Основные отличия от Log4j 1:
Одной из наиболее узнаваемых особенностей Log4j 2 является производительность «Асинхронных регистраторов». Log4j 2 использует LMAX Disruptor. Библиотека снижает потребность в блокировке ядра и увеличивает производительность журналирования в 12 раз. Например, в той же среде Log4j 2 может записывать более 18 000 000 сообщений в секунду, тогда как другие платформы, такие как Logback и Log4j 1, просто записывают < 2,000,000 messages per second.
В следующей таблице определены встроенные уровни журнала и сообщения в Log4j в порядке убывания важности. В левом столбце приводится обозначение уровня журнала в Log4j, а в правом столбце приводится краткое описание каждого уровня журнала.
| Уровень | Описание |
|---|---|
| ВЫКЛ | Наивысший возможный ранг, предназначенный для отключения регистрации. |
| FATAL | Серьезные ошибки, вызывающие преждевременное завершение работы. Ожидайте, что они будут немедленно видны на консоли состояния. |
| ОШИБКА | Другие ошибки времени выполнения или непредвиденные условия. Ожидайте, что они будут немедленно видны на консоли состояния. |
| ПРЕДУПРЕЖДЕНИЕ | Использование устаревших API-интерфейсов, неправильное использование API, «почти» ошибки, другие нежелательные или неожиданные ситуации выполнения, но не обязательно «неправильные». Ожидайте, что они будут немедленно видны на консоли состояния. |
| ИНФОРМАЦИЯ | Интересные события выполнения (запуск / завершение работы). Ожидайте, что они будут сразу же видны на консоли, поэтому будьте консервативны и сведите к минимуму. |
| DEBUG | Подробная информация о потоке через систему. Ожидайте, что они будут записаны только в журналы. Вообще говоря, большинство строк, регистрируемых вашим приложением, следует записывать как DEBUG. |
| TRACE | Самая подробная информация. Ожидайте, что они будут записаны только в журналы. Начиная с версии 1.2.12. |
Log4j 2 позволяет пользователям определять свои собственные уровни журнала. Инструмент генератора исходного кода предназначен для создания регистраторов, которые поддерживают настраиваемые уровни журнала, идентичные уровням встроенного журнала. Пользовательские уровни журнала могут дополнять или заменять встроенные уровни журнала.
Log4j можно настроить через файл конфигурации или через код Java. Файлы конфигурации могут быть записаны в формате XML, JSON, YAML или файл свойств. В конфигурации вы можете определить три основных компонента: регистраторы, приложения и макеты. Настройка ведения журнала через файл имеет то преимущество, что его можно включить или выключить, не изменяя приложение, использующее Log4j. Например, приложению можно разрешить запуск с выходом из системы, пока не возникнет проблема, а затем снова включить ведение журнала, просто изменив файл конфигурации.
Регистраторы называются адресатами сообщений журнала. Это имена, известные приложению Java. Каждый регистратор независимо настраивается относительно того, какой уровень ведения журнала (FATAL, ERROR и т. Д.) Он в настоящее время регистрирует. В ранних версиях Log4j они назывались категорией и приоритетом, но теперь они называются регистратором и уровнем соответственно. Регистратор может отправлять сообщения журнала нескольким приложениям.
Фактические выходы выполняются Appenders . Доступно множество приложений с описательными именами, например FileAppender, RollingFileAppender, ConsoleAppender, SocketAppender, SyslogAppender и SMTPAppender. В Log4j 2 добавлены приложения, которые записывают в Apache Flume, Java Persistence API, Apache Kafka, NoSQL в базы данных, Память- сопоставленные файлы, файлы произвольного доступа и конечные точки ZeroMQ. К любому регистратору можно подключить несколько приложений, поэтому можно записывать одну и ту же информацию на несколько выходов; например, в файл локально и в прослушиватель сокета на другом компьютере.
Приложения используют Макеты для форматирования записей журнала. Популярным способом форматирования файлов журнала по одной строке за раз является PatternLayout, который использует строку шаблона, очень похожую на функцию C / C ++ printf. Существуют также средства форматирования HTMLLayout и XMLLayout для использования, когда форматы HTML или XML более удобны соответственно. Log4j 2 добавил макеты для CSV, Graylog Extended Log Format (GELF), JSON, YAML и RFC-5424.
В Log4j 2, Фильтры могут быть определены в элементах конфигурации, чтобы дать более детальный контроль над тем, какие записи журнала должны обрабатываться какими регистраторами и добавителями. В дополнение к фильтрации по уровню журнала и сопоставлению регулярных выражений в строке сообщения, Log4j 2 добавил пакетные фильтры, временные фильтры, фильтрацию по другим атрибутам событий журнала, таким как маркеры или карта контекста потока и фильтры сценария JSR 223.
Для отладки некорректной конфигурации:
statusзначение TRACE для отправки выходных данных внутреннего журнала состояния на стандартный выход. Чтобы включить регистрацию состояния до того, как конфигурация будет найдена, используйте свойство Java VM -Dorg.apache.logging.log4j.simplelog.StatusLogger.level = trace.- Dlog4j.debug.Чтобы узнать, где был загружен файл конфигурации log4j2.xml, из inspect getClass (). GetResource ("/ log4j2.xml").
Также существует неявное "ненастроенное" или "по умолчанию" "конфигурация Log4j, это конфигурация Java-приложения, оснащенного Log4j, в котором отсутствует какая-либо конфигурация Log4j. Это выводит на стандартный вывод предупреждение о том, что программа не настроена, и URL-адрес веб-сайта Log4j, на котором можно найти подробную информацию о предупреждении и конфигурации. Помимо вывода этого предупреждения ненастроенное приложение Log4j будет печатать только записи журнала ERROR или FATAL в стандартном формате.
target / test.log % d% p% c {1.} [% T]% m% n
Портал компьютерного программирования 
Портал бесплатного программного обеспечения с открытым исходным кодом 
