spryker/newrelic-rabbitmq-agent

NewRelic RabbitMQ监控代理镜像

镜像概述

本镜像基于newrelic/infrastructure-bundle:2.5.0构建，集成了NewRelic基础设施代理和RabbitMQ监控插件（nri-rabbitmq）。通过环境变量配置，自动生成NewRelic许可证配置和RabbitMQ监控参数，实现对RabbitMQ服务的性能、队列、交换机等关键指标的监控，并将数据发送至NewRelic平台。

核心功能与特性

• 自动配置生成：通过环境变量动态生成NewRelic许可证配置文件（/etc/newrelic-infra.yml）和RabbitMQ监控集成配置文件（/etc/newrelic-infra/integrations.d/rabbitmq-config.yml）
• 灵活参数配置：支持通过环境变量设置RabbitMQ连接信息（端点、端口、用户名、密码）及监控范围（队列、交换机正则匹配）
• 官方基础镜像：基于NewRelic官方基础设施捆绑镜像，确保监控代理的稳定性和兼容性
• 即插即用：无需手动编写配置文件，通过环境变量即可完成监控配置

使用场景

• 需要对RabbitMQ集群或单节点进行性能监控的环境
• 希望将RabbitMQ监控数据集成到NewRelic平台进行统一管理和告警的场景
• 容器化部署的RabbitMQ服务，需通过Docker方式快速集成监控能力

使用方法与配置说明

环境变量配置

Docker Run部署示例

bash
docker run -d \
  --name newrelic-rabbitmq-monitor \
  -e NR_LICENSE_KEY="your_newrelic_license_key" \
  -e RABBITMQ_ENDPOINT="rabbitmq.example.com" \
  -e RABBITMQ_PORT="5672" \
  -e RABBITMQ_USERNAME="admin" \
  -e RABBITMQ_PASSWORD="password" \
  -e RABBITMQ_QUEUES_REGEXES="^order.*,^payment.*" \
  -e RABBITMQ_EXCHANGE_REGEXES="^amq\..*" \
  docker.xuanyuan.run/your-image-name:tag

Docker Compose部署示例

yaml
version: '3'
services:
  newrelic-rabbitmq-monitor:
    image: docker.xuanyuan.run/your-image-name:tag
    container_name: newrelic-rabbitmq-monitor
    environment:
      - NR_LICENSE_KEY=your_newrelic_license_key
      - RABBITMQ_ENDPOINT=rabbitmq
      - RABBITMQ_PORT=5672
      - RABBITMQ_USERNAME=admin
      - RABBITMQ_PASSWORD=password
      - RABBITMQ_QUEUES_REGEXES=^order.*,^payment.*
      - RABBITMQ_EXCHANGE_REGEXES=^amq\..*
    restart: unless-stopped
    # 如需访问宿主机或其他容器的RabbitMQ，可根据网络模式调整
    network_mode: bridge

工作原理

1. 容器启动时，entrypoint.sh脚本会读取环境变量，生成/etc/newrelic-infra.yml（包含NewRelic许可证密钥）
2. 同时生成/etc/newrelic-infra/integrations.d/rabbitmq-config.yml，配置RabbitMQ监控插件（nri-rabbitmq）的连接参数和监控范围
3. 启动NewRelic基础设施服务（newrelic-infra-service），该服务会加载上述配置，通过nri-rabbitmq插件采集RabbitMQ监控数据并发送至NewRelic平台

注意事项

• 确保NR_LICENSE_KEY有效且具有相应的监控权限
• RabbitMQ用户需具备足够的权限（如monitoring标签）以允许插件采集监控数据
• 正则表达式配置（RABBITMQ_QUEUES_REGEXES和RABBITMQ_EXCHANGE_REGEXES）为空时，将监控所有队列和交换机
• 如需自定义更多NewRelic配置，可通过挂载配置文件覆盖默认生成的配置