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

Обзор

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

Обзор файлов

Если вы получили Java gateway из исходных кодов, у вас должен быть набор shell-скриптов, JAR- и конфигурационных файлов в каталоге $PREFIX/sbin/zabbix_java. Назначение этих файлов кратко описано ниже.

bin/zabbix-java-gateway-$VERSION.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, 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.

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

   ./startup.sh

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

   ./shutdown.sh

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

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

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

JavaGateway=192.168.3.14
JavaGatewayPort=10052

По умолчанию, сервер нe запускает процессы, связанные с мониторингом 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. Обратитесь к Руководству по SLF4 для получения более подробных сведений.

Мониторинг JMX

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