Перейти к основному содержимому
Версия: Пульт 2.3.0

agent2

agent2 — опциональный компонент мониторинга для сбора метрик с наблюдаемых хостов и передачи данных в систему. Его разворачивают, когда нужно опрашивать серверы, виртуальные машины и другие узлы через Agent 2.

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

Добавьте сервис агента в docker-compose.yml на хосте, где должен работать агент:

services:
  pult-agent:
    image: registry.pult.chislitellab.ru:8123/releases/2.3.0/agent2-redos8:7.4.9
    container_name: pult-agent2
    restart: always
    env_file:
      - .env_agent
    ports:
      - "30050:10050"

Порт 30050:10050 пробрасывает пассивный порт агента (10050) на хост. При необходимости измените внешний порт.

Параметры подключения к серверу Пульта задаются в файле .env_agent в зависимости от режима работы агента.

Режимы работы агента​

  • Passive mode — сервер Пульта инициирует опрос агента (пассивные проверки). Агент слушает порт 10050.
  • Active mode — агент самостоятельно подключается к серверу Пульта и передаёт данные (активные проверки).

Выберите один из вариантов файла .env_agent ниже.

Passive mode​

Создайте файл .env_agent:

ZBX_HOSTNAME=pult-agent
ZBX_SERVER_HOST=pult-server,0.0.0.0/0
ZBX_ACTIVE_ALLOW=false
ZBX_PASSIVE_ALLOW=true
#ZBX_SERVER_PORT=10051
ZBX_TIMEOUT=10
ZBX_STARTAGENTS=100
ZBX_DEBUGLEVEL=5

В passive mode в ZBX_SERVER_HOST указываются адреса серверов, которым разрешён опрос агента: имя сервиса pult-server (если агент в той же docker-сети, что и сервер) и подсеть 0.0.0.0/0 (при необходимости — замените на конкретные IP серверов Пульта).

Active mode​

Создайте файл .env_agent:

ZBX_HOSTNAME=pult-agent
ZBX_SERVER_HOST=<server_external_ip>
ZBX_ACTIVE_ALLOW=true
#ZBX_PASSIVE_ALLOW=false
ZBX_SERVER_PORT=10051
ZBX_TIMEOUT=10
ZBX_STARTAGENTS=100
ZBX_DEBUGLEVEL=5

В active mode в ZBX_SERVER_HOST укажите внешний IP-адрес или DNS-имя сервера Пульта, доступное с хоста агента. Порт 10051 — порт сервера Пульта для активных проверок.

Запуск​

docker compose up -d pult-agent

Имя хоста ZBX_HOSTNAME должно совпадать с именем узла, созданного в интерфейсе Пульта.