1 Настройка для исходных кодов

Обзор

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

Обзор файлов

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

bin/zabbix-java-gateway-$VERSION.jar

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

lib/logback-core-0.9.27.jar
       lib/logback-classic-0.9.27.jar
       lib/slf4j-api-1.6.1.jar
       lib/android-json-4.3_r3.1.jar

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

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

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

$ ./shutdown.sh

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

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

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

JavaGateway=192.168.3.14
       JavaGatewayPort=10052

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

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 для получения более подробных сведений.

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

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

JMX мониторинг

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