Интеграция с RabbitMQ

info

Перевод в процессе / Translation in progress. See русская версия.

Интеграция опрашивает HTTP-API плагина rabbitmq_management, публикует в Flaree метрики очередей, каналов, соединений и consumer-lag.

Предварительные требования

• RabbitMQ 3.11 или новее с включённым плагином rabbitmq_management:

  rabbitmq-plugins enable rabbitmq_management

• Пользователь flaree_agent с ролью monitoring:

  rabbitmqctl add_user flaree_agent '<your-password>'
  rabbitmqctl set_user_tags flaree_agent monitoring
  rabbitmqctl set_permissions -p / flaree_agent "^$" "^$" ".*"

• Сетевая доступность из агента до management-порта (по умолчанию TCP 15672).

Минимальная конфигурация

integrations:
  rabbitmq:
    enabled: true
    url: http://rabbit:15672
    username: flaree_agent
    password: ${RABBITMQ_PASSWORD}

Полная конфигурация

integrations:
  rabbitmq:
    enabled: true
    url: https://rabbit:15672
    username: flaree_agent
    password: ${RABBITMQ_PASSWORD}
    tls_ca: /etc/flaree/certs/rabbit-ca.pem
    request_timeout: 10s
    interval: 30s
    vhosts:
      - "/"
      - "/billing"
    queues:
      include:
        - "orders.*"
      exclude:
        - "amq.*"

Ключ	Тип	По умолчанию	Описание
url	url	—	Базовый URL management-API.
username / password	string	—	Реквизиты монитора, пароль из ${ENV_VAR}.
tls_ca	path	—	CA-сертификат для HTTPS.
interval	duration	30s	Периодичность опроса.
vhosts[]	array	["/"]	Виртуальные хосты для сбора.
queues.include / queues.exclude	array	[]	Regex-фильтры очередей.

Проверка работы

1. Выполнить запрос overview из-под агента, чтобы подтвердить доступность API и корректность пароля.
2. Убедиться, что метрика flaree_agent_rabbitmq_up равна 1 на эндпоинте агента.

curl -u flaree_agent:${RABBITMQ_PASSWORD} http://rabbit:15672/api/overview | head
curl -sS http://127.0.0.1:9100/metrics | grep flaree_agent_rabbitmq_up

Troubleshooting

• Если данных нет, пройдите чек-лист на странице нет данных.
• Типовые причины: отключённый плагин rabbitmq_management, пользователь без тега monitoring, self-signed TLS без tls_ca.