dogstatsd

datadog/dogstatsd Docker Image

datadog

独立的DogStatsD镜像,用于自定义指标收集。

6 次收藏下载次数: 0状态:社区镜像维护者:datadog仓库类型:镜像最近更新:

DogStatsD 独立镜像技术文档

一、镜像概述

1.1 主要用途

DogStatsD 独立镜像是基于 StatsD 协议的轻量级指标聚合器,专为自定义指标收集设计。作为 Datadog 生态的一部分,它能够独立部署(无需完整 Datadog Agent),负责接收、聚合应用程序发送的自定义指标,并将其高效转发至 Datadog 平台,适用于容器化、微服务等场景的指标集中管理。

二、核心功能与特性

2.1 核心功能

  • StatsD 协议支持:兼容标准 StatsD 指标类型(计数 count、计量 gauge、定时 timing、直方图 histogram 等),支持自定义指标上报。
  • 独立部署能力:无需依赖完整 Datadog Agent,降低资源占用,简化部署流程。
  • 高效指标聚合:本地聚合指标(如计算平均值、百分位),减少网络传输量,提升数据处理效率。
  • Datadog 集成:原生支持与 Datadog 平台对接,自动处理指标格式转换与上报。

2.2 特性

  • 轻量级设计:基于 Alpine 基础镜像,体积小、启动快,适合资源受限环境。
  • 灵活配置:通过环境变量自定义端口、标签、目标 Datadog 站点等参数。
  • 版本兼容:6.x 与 7.x 版本间无破坏性变更,版本号同步 Datadog Agent 主版本。

三、使用场景与适用范围

3.1 典型使用场景

  • 微服务架构指标收集:在分布式系统中,集中接收各服务实例发送的自定义业务指标(如订单量、接口延迟)。
  • 资源受限环境:相比完整 Datadog Agent,减少 CPU/内存占用,适合边缘节点、轻量容器等场景。
  • 自定义应用监控:为非标准监控场景(如业务指标、自定义性能指标)提供标准化数据入口。
  • 容器/K8s 环境集成:与 Docker、Kubernetes 等容器编排平台无缝集成,通过 DaemonSet 或独立 Pod 部署,覆盖集群内所有应用指标。

四、使用方法

4.1 镜像标签说明

标签格式说明
latest最新稳定版本
7 / 7.X.XAgent 7 系列版本(当前主版本)
6.X.X历史 Agent 6 系列版本(兼容无破坏性变更)

注意:6.x 与 7.x 版本间无功能破坏性变更,版本号仅同步 Datadog Agent 主版本策略。

4.2 部署示例

4.2.1 Docker 命令部署

通过 docker run 快速启动容器,需映射 UDP 端口(默认 8125)并配置必要环境变量:

bash
docker run -d \
  --name dogstatsd \
  -p 8125:8125/udp \  # DogStatsD 默认 UDP 端口
  -e DD_API_KEY=<your_datadog_api_key> \  # 替换为实际 API Key
  -e DD_SITE=datadoghq.com \  # 可选,指定 Datadog 站点(如欧洲区为 datadoghq.eu)
  -e DD_TAGS="env:prod,app:my-service" \  # 可选,全局标签(键值对格式,逗号分隔)
  gcr.io/datadoghq/dogstatsd:latest  # 或指定标签如 7

4.2.2 Docker Compose 部署

创建 docker-compose.yml 配置文件:

yaml
version: '3'
services:
  dogstatsd:
    image: ***-gcr.xuanyuan.run/datadoghq/dogstatsd:7  # 指定 7 系列版本
    container_name: dogstatsd
    ports:
      - "8125:8125/udp"  # 暴露 UDP 端口接收指标
    environment:
      - DD_API_KEY=<your_datadog_api_key>  # 必填,Datadog API Key
      - DD_SITE=datadoghq.com  # 可选,默认 datadoghq.com
      - DD_TAGS="env:prod,team:backend"  # 可选,全局标签
      - DD_DOGSTATSD_PORT=8125  # 可选,自定义监听端口(默认 8125)
    restart: unless-stopped  # 确保服务持续运行

启动命令:docker-compose up -d

4.3 配置参数(环境变量)

环境变量描述默认值必填
DD_API_KEYDatadog API 密钥,用于认证并将指标发送至 Datadog 平台无是
DD_SITEDatadog 站点域名,根据部署地区选择(如美国区 datadoghq.com、欧洲区 datadoghq.eu)datadoghq.com否
DD_TAGS全局标签,格式为 key:value,多标签用逗号分隔(如 env:prod,app:api),将附加到所有指标无否
DD_DOGSTATSD_PORTDogStatsD 监听端口(UDP)8125否
DD_DOGSTATSD_NON_LOCAL_TRAFFIC是否允许非本地流量(如跨容器/主机指标发送),设为 true 开启false否
DD_AGGREGATOR_BUCKETS指标聚合时间窗口(秒),控制指标本地缓存与聚合周期10否

五、支持与反馈

5.1 问题排查与支持

如遇部署或运行问题,可通过 https://www.datadoghq.com/support/ 获取帮助。

5.2 贡献与 Bug 反馈

若需贡献代码或报告 Bug,可访问 https://github.com/DataDog/datadog-agent 提交 issue 或 PR。

六、参考文档

  • https://docs.datadoghq.com/
  • https://github.com/DataDog/datadog-agent/tree/master/Dockerfiles/dogstatsd/alpine
  • https://github.com/DataDog/datadog-agent/tree/master/docs

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 dogstatsd 镜像标签

docker pull docker.xuanyuan.run/datadog/dogstatsd:<标签>

DockerHub 原生拉取命令

docker pull datadog/dogstatsd:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告