Установка из исходных кодов

Обзор

Если установлен из исходных кодов, следующая информация поможет вам в настройке Zabbix Java gateway.

Обзор файлов

Если вы получили Java gateway из исходных кодов, вы должны были получить набор скриптов командной строки, JAR и файлы конфигурации в папке $ПРЕФИКС/sbin/zabbix_java. Суть этих файлов отражена ниже.

bin/zabbix-java-gateway-$ВЕРСИЯ.jar

Собственно JAR файл Java gateway.

lib/logback-core-1.5.16.jar
lib/logback-classic-1.5.16.jar
lib/slf4j-api-2.0.16.jar
lib/android-json-4.3_r3.1.jar

Зависимости Java gateway: Logback [en], SLF4J [en] и библиотека Android JSON [en].

lib/logback.xml  
lib/logback-console.xml

Файлы конфигурации для Logback.

shutdown.sh  
startup.sh

Скрипты для удобства запуска и остановки Java gateway.

settings.sh

Файл конфигурации, который используется вышеупомянутыми скриптами запуска и остановки.

Настройка и запуск Java gateway

По умолчанию Java gateway слушает порт 10052. Если вы планируете работу Java gateway на другом порту, то вы можете указать его в скрипте settings.sh. Смотрите описание файла конфигурации Java gateway для получения сведений о том, как указать эту и другие опции.

Порт 10052 не зарегистрирован в IANA [en].

Выполнив настройки, вы можете запустить Java gateway, выполнив скрипт startup.sh:

./startup.sh

Точно так же, если вам более не требуется Java gateway, выполните скрипт shutdown.sh для остановки Java gateway:

./shutdown.sh

Обратите внимание, что в отличие от сервера или прокси, Java-шлюз является легковесным и не требует базы данных.

Настройка сервера для использования с Java gateway

После запуска Java gateway необходимо указать серверу Zabbix, где найти Zabbix Java gateway. Для этого в файле конфигурации сервера задаются параметры JavaGateway и JavaGatewayPort. Если узел сети, на котором работает приложение JMX, контролируется через прокси Zabbix, то параметры подключения следует указывать в файле конфигурации прокси.

JavaGateway=192.168.3.14
JavaGatewayPort=10052

По умолчанию сервер не запускает никаких процессов, связанных с мониторингом JMX. Однако если вы хотите использовать его, необходимо указать количество предварительно порожденных экземпляров Java pollers. Это делается так же, как и при указании обычных pollers и trappers.

StartJavaPollers=5

Не забудьте перезапустить сервер или прокси после завершения настройки.

Отладка Java gateway

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

По умолчанию Java gateway записывает журнал в файл /tmp/zabbix_java.log с уровнем журналирования «info». Бывает, что этой информации недостаточно и требуется информация уровня журналирования «debug». Чтобы увеличить уровень журналирования, отредактируйте файл lib/logback.xml и измените атрибут level тега <root> на значение debug:

<root level="debug">
  <appender-ref ref="FILE" />
</root>

Обратите внимание, что в отличие от Zabbix сервера или Zabbix прокси, вам не нужно перезапускать Zabbix Java gateway после изменения файла logback.xml — изменения в файле logback.xml подхватятся автоматически. Когда вы завершите отладку, вы можете вернуть уровень журналирования обратно в «info».

Если вы хотите записывать журнал в другой файл или на совершенно другой носитель, такой как база данных, настройте файл logback.xml в соответствии с вашими потребностями. Обратитесь к Руководству по Logback [en] для получения более подробных сведений.

Иногда в целях отладки полезно запустить Java gateway как консольное приложение, а не как демон. Чтобы это сделать, закомментируйте переменную PID_FILE в settings.sh. Если PID_FILE не указан, скрипт startup.sh запускает Java gateway как консольное приложение, при этом Logback использует файл lib/logback-console.xml, который не только выводит журнал в консоль, но и имеет уровень журналирования «debug».

В заключение, отметим, поскольку Java gateway использует для журналирования SLF4J, вы можете заменить Logback выбранным вами фреймворком, поместив соответствующий JAR файл в каталог lib. Обратитесь к Руководству по SLF4 [en] для получения более подробных сведений.

Мониторинг JMX

Смотрите страницу JMX мониторинга для получения более подробных сведений.