ruimarinho/nsq-dogstatsd

nsq-dogstatsd

镜像概述

nsq-dogstatsd是一款将nsq统计数据通过http://docs.datadoghq.com/guides/dogstatsd/%E5%8F%91%E9%80%81%E5%88%B0https://%5B***]

核心功能

• 收集nsq节点（直接连接nsqd）或集群（通过nsqlookupd）的统计数据
• 将metrics以标签化方式发送到Datadog，支持全局标签和metrics排除规则
• 可配置数据采集间隔，适配不同监控需求
• 兼容Datadog Agent内置的DogStatsD或独立运行的DogStatsD服务

使用场景

• 实时监控nsq集群的运行状态（如频道深度、后端队列深度等）
• 创建自定义Datadog仪表盘，直观展示nsq关键指标
• 设置异常警报（如频道深度过高），及时发现并处理潜在问题

配置说明

前置条件

需运行DogStatsD服务（可通过Datadog Agent内置或独立部署）。独立部署示例：

sh
docker run --rm --name dogstatsd -h $(hostname) -p 8125:8125/udp -e API_KEY=<你的Datadog API密钥> datadog/docker-dd-agent:latest-dogstatsd

镜像使用

通过Docker运行

连接到nsqlookupd实例（采集集群数据）：

sh
docker run --rm ruimarinho/nsq-dogstatsd -lookupd-http-address 127.0.0.1:4161 -interval 5s -tag environment:development

直接连接到nsqd节点：

sh
docker run --rm ruimarinho/nsq-dogstatsd -nsqd-http-address 127.0.0.1:4151

参数说明

• -dogstatsd-address: DogStatsD服务地址（默认：127.0.0.1:8125）
• -exclude-metrics: 排除特定metrics的正则表达式（可多次指定）
• -interval: 数据采集间隔（如5s）
• -lookupd-http-address: nsqlookupd地址（可多次指定）
• -nsqd-http-address: nsqd地址（可多次指定）
• -tag: 添加全局标签（如environment:prod，可多次指定）
• -version: 显示版本信息

监控设置

在Datadog中创建监控警报的步骤：

1. 选择指标：如nsq.channel.depth，按channel、topic、node分组
2. 设置阈值：触发条件为过去5分钟平均值超过100
3. 配置通知：设置警报主题和通知对象，及时响应异常

许可证

MIT