Документация / API / Java / Адаптер для Log4j

---

Адаптер Zidium для Log4j — это open source проект. Участвуйте, чтобы сделать его лучше!

https://github.com/Zidium/Log4jAdapter

Добавьте раздел в ваш pom.xml:

<dependency>
    <groupId>net.zidium</groupId>
    <artifactId>log4jAdapter</artifactId>
    <version>1.0.0</version>
</dependency>

Используйте самую новую доступную версию.

В личном кабинете создайте новый компонент и скопируйте его Id (GUID).

Создайте в проекте файл zidium.properties. Он должен находиться в одной папке с выполняемым jar-файлом.

В файле zidium.properties укажите название вашего аккаунта и ключ доступа к Api:

account=MYACCOUNT
secretKey=7031880B-CCCD-4A05-A4DE-6AFADCD7BE6F

Добавьте секции в файл log4j2.xml:

<?xml version="1.0" encoding="utf-8"?>
<Configuration packages="net.zidium.log4jAdapter">
    <Appenders>
        <ZidiumLogs name="ZidiumLogs" />
        <ZidiumEvents name="ZidiumEvents" />
    </Appenders>
    <Loggers>
        <Root>
            <AppenderRef ref="ZidiumLogs" />
            <AppenderRef ref="ZidiumEvents" level="error" />
        </Root>
    </Loggers>
</Configuration>

Адаптер использует функционал Zidium Api компонент по умолчанию (defaultComponent). Его нужно назначить в самом начале вашего приложения:

IComponentControl component = ZidiumClient.getDefault().getComponentControl("..."); // Укажите Id созданного компонента
LoggerToComponentMap.setDefaultComponent(component);

Важно! Перед завершением приложения нужно выполнить запись всех закешированных данных:

ZidiumClient.getDefault().getEventManager().flush();
ZidiumClient.getDefault().getLogManager().flush();

Для отправки ошибок в Zidium - просто запишите ошибку в лог:

try {
    ...
}
catch (Exception exception) {
    LogManager.getLogger().error(exception);
}

Для отправки сообщений лога в Zidium - просто выполняется запись сообщений в лог:

LogManager.getLogger().info("Message");