Документация / API / Java / API

---

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

https://github.com/Zidium/ApiJava

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

<dependency>
    <groupId>net.zidium</groupId>
    <artifactId>apijava</artifactId>
    <version>1.0.3</version>
</dependency>

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

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

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

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

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

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

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

client.getEventManager().flush();
client.getLogManager().flush();

IUnitTestControl unitTest = component.getOrCreateUnitTest("Проверка", "Тип проверки");
unitTest.SendResult(UnitTestResult.Success);

component.sendMetric("HDD", 1024);

ZidiumEvent eventData = new ZidiumEvent();
eventData.setMessage("Текст события");
eventData.setTypeDisplayName("Тип события");
eventData.setImportance(EventImportance.SUCCESS);
component.addEvent(eventData);

try {
    ...
}   
catch (Exception exception) {
    client.addError("Текст ошибки", exception);
}

Важно! Несмотря на то, что можно напрямую отправлять ошибки через Api, мы рекомендуем использовать
адаптер для log4j,
так как это более удобно и не требует изменений в существующем коде.

ILog log = component.getLog();
log.info("Текст лога");

Важно! Несмотря на то, что можно напрямую отправлять лог через Api, мы рекомендуем использовать
адаптер для log4j,
так как это более удобно и не требует изменений в существующем коде.