java-gateway

java-gateway — опциональный интеграционный компонент для мониторинга Java-приложений через JMX. Его используют, когда в инфраструктуре есть JVM и сервисы, для которых нужен сбор JMX-метрик. Сервер Пульта не обращается к JMX напрямую — запросы проходят через Java Gateway.

pult-server
     |
     v
pult-java-gateway
     |
     v
JMX (Java Application)

Сервис в docker-compose.yml

Добавьте сервис pult-java-gateway в docker-compose.yml:

  pult-java-gateway:
    image: registry.pult.chislitellab.ru:8123/releases/2.3.0/java-gateway-redos8:7.4.9
    container_name: pult-java-gateway
    restart: unless-stopped
    environment:
     #ZBX_LISTEN_PORT: "10052"
      ZBX_DEBUGLEVEL: debug
      #ZBX_LISTEN_IP: ""
      #ZBX_START_POLLERS: ""
      #ZBX_TIMEOUT: ""
      #ZBX_PROPERTIES_FILE: "" # Можно сделать проброс файла через local volume mount, со всеми настройками
      ZABBIX_OPTIONS: -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=12345 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.registry.ssl=false
    security_opt:
      - seccomp:unconfined
    volumes:
      - ./ext_lib:/usr/bin/pult-java-gateway/ext_lib
    ports:
      - "10052:10052"
    depends_on:
      - pult-server

Каталог ./ext_lib на хосте монтируется в контейнер для дополнительных библиотек Java Gateway при необходимости.

Настройка pult-server

В конфигурации pult-server (переменные окружения или .env) включите Java Gateway:

ZBX_JAVAGATEWAY_ENABLE=true
ZBX_JAVAGATEWAY=pult-java-gateway
ZBX_JAVAGATEWAYPORT=10052
ZBX_STARTJAVAPOLLERS=5

Переменная	Описание
ZBX_JAVAGATEWAY_ENABLE	Включение поддержки JMX через Java Gateway
ZBX_JAVAGATEWAY	Имя хоста или IP Java Gateway (имя сервиса в docker-сети — pult-java-gateway)
ZBX_JAVAGATEWAYPORT	Порт Java Gateway (по умолчанию 10052)
ZBX_STARTJAVAPOLLERS	Количество процессов опроса JMX

После изменения конфигурации перезапустите pult-server и pult-java-gateway:

docker compose up -d pult-java-gateway pult-server