tuxpiper/statsd-cloudwatch

StatsD服务器（集成CloudWatch后端）容器

该Docker镜像运行一个StatsD服务器，能够定期将收集到的指标数据同步到AWS CloudWatch服务。它基于开源项目etsy/statsd和camitz/aws-cloudwatch-statsd-backend构建。

核心功能

1. 提供StatsD服务，支持UDP/TCP协议接收指标数据
2. 定期将指标数据批量刷新至AWS CloudWatch
3. 通过环境变量灵活配置CloudWatch命名空间、端口及AWS认证参数

使用场景

1. 应用或系统需要将StatsD格式的监控指标同步到AWS CloudWatch进行统一分析
2. 容器化环境中快速部署StatsD服务并集成CloudWatch监控体系

配置说明

通过环境变量进行配置：

• CLOUDWATCH_NAMESPACE：CloudWatch指标命名空间（可选，默认值为"AwsCloudWatchStatsdBackend"）
• PORT_UDP：StatsD监听的UDP端口
• PORT_TCP：StatsD监听的TCP端口
• AWS认证参数：
  • AWS_REGION：AWS区域
  • AWS_ACCESS_KEY_ID：AWS访问密钥ID（可选，若使用IAM角色则无需填写）
  • AWS_SECRET_ACCESS_KEY：AWS秘密访问密钥（可选，若使用IAM角色则无需填写）
  • AWS_IAM_ROLE：用于获取凭证的IAM角色（替代API密钥时使用）

部署示例

Docker Run命令

bash
docker run -d \
  --name statsd-cloudwatch \
  -e CLOUDWATCH_NAMESPACE="MyApplicationMetrics" \
  -e AWS_REGION="cn-north-1" \
  -e AWS_ACCESS_KEY_ID="your-access-key" \
  -e AWS_SECRET_ACCESS_KEY="your-secret-key" \
  -p 8125:8125/udp \
  -p 8125:8125/tcp \
  tuxpiper/statsd-cloudwatch

Docker Compose示例

yaml
version: '3'
services:
  statsd-cloudwatch:
    image: tuxpiper/statsd-cloudwatch
    environment:
      CLOUDWATCH_NAMESPACE: "MyApplicationMetrics"
      AWS_REGION: "cn-north-1"
      AWS_ACCESS_KEY_ID: "your-access-key"
      AWS_SECRET_ACCESS_KEY: "your-secret-key"
    ports:
      - "8125:8125/udp"
      - "8125:8125/tcp"
    restart: always