Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

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

Обзор

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

Обзор файлов

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

bin/zabbix-java-gateway-$ВЕРСИЯ.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 для получения сведений о том, как указать эту и другие опции.

Выполнив настройки, вы можете запустить 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

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