Documentation
Table of Contents
1 Настройка для исходных кодов
Обзор
Если вы установили из исходных кодов, следующая информация вам поможет настроить Zabbix Java gateway.
Обзор файлов
Если вы получили Java gateway из исходных кодов, у вас в конечном итоге должна быть коллекция скриптов командной строки, JAR файлы и файлы конфигурации в $ПРЕФИКС/sbin/zabbix_java. Назначение этих файлов изложено ниже.
Собственно 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.
Файлы конфигурации для Logback.
Скрипты для удобства запуска и остановки Java gateway.
Файл конфигурации, который используется вышеупомянутыми скриптами запуска и остановки.
Настройка и запуск Java gateway
По умолчанию, Java gateway слушает порт 10052. Если вы планируете работу Java gateway на другом порту, то вы можете указать его в скрипте settings.sh. Смотрите описание файла конфигурации Java gateway для получения сведений о том как указать эту и другие опции.
Порт 10052 не зарегистрирован в IANA [en].
Как только вы выберите подходящие настройки, вы можете запустить Java gateway, выполнив скрипт запуска:
Точно так же, если вам более не требуется Java gateway, выполните скрипт завершения работы для остановки Java gateway:
Обратите внимание, что в отличии от сервера и прокси, Java gateway легковесный и не требует наличия базы данных.
Настройка сервера для использования с Java gateway
Когда Java gateway запущен и работает, вы должны указать Zabbix серверу где искать Zabbix Java gateway. Чтобы это сделать, укажите параметры JavaGateway и JavaGatewayPort в файле конфигурации сервера. Если же узел сети на котором работает JMX приложение наблюдается через Zabbix прокси, то параметры соединения указываются в файле конфигурации прокси вместо сервера.
По умолчанию, сервер не запускает процессы связанные с мониторингом JMX. Если же вы хотите использовать этот тип мониторинга, то вам нужно указать количество экземпляров Java поллеров. Вы можете это сделать таким же способом как и изменение количества поллеров и трапперов.
Не забудьте перезапустить сервер или прокси после того как закончите изменение настроек.
Отладка Java gateway
В случае возникновения каких-либо проблем с Java gateway или в случае, если сообщение об ошибке элемента данных в веб-интерфейсе недостаточно информативно, вы можете обратиться к файлу журнала Java gateway.
По умолчанию, Java gateway записывает журнал в файл /tmp/zabbix_java.log с уровнем журналирования "info". Бывает, что этой информации недостаточно и требуется информация уровня журналирования "debug". Чтобы увеличить уровень журналирования, отредактируйте файл lib/logback.xml и измените атрибут level тега <root> на "debug":
Обратите внимание, что в отличии от 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 мониторинга для получения более детальных сведений.