codeclimate/statsd

StatsD Docker镜像文档

镜像概述

本镜像基于Alpine Linux和Node.js 6.10.1构建，集成了Etsy的StatsD v0.7.2版本，并预装了statsd-librato-backend（v0.1.7）和statsd-datadog-backend（v0.1.0）两个后端插件。主要用于构建轻量级的指标收集与转发服务，支持将收集到的监控数据发送至Librato和Datadog平台。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 稳定版本：集成StatsD v0.7.2，确保功能稳定性
• 多后端支持：预装Librato和Datadog后端插件，可直接对接主流监控平台
• 灵活配置：通过外部配置文件自定义StatsD行为，无需修改镜像

使用场景

• 系统和应用程序的性能指标收集
• 监控数据转发至Librato或Datadog平台进行分析和可视化
• 容器化环境中的轻量级监控代理部署
• 微服务架构中的分布式指标聚合

使用方法与配置说明

基本运行方式

需通过挂载外部配置文件到/etc/config.js来启动服务：

bash
docker run -d -p 8125:8125/udp -v /path/to/your/config.js:/etc/config.js --name statsd [镜像名称]

配置文件说明

配置文件需遵循StatsD的配置格式，以下是包含后端配置的示例：

javascript
{
  port: 8125,
  backends: [
    './backends/librato',
    './backends/datadog'
  ],
  // Librato后端配置
  librato: {
    email: 'your-librato-email@example.com',
    token: 'your-librato-api-token',
    source: 'statsd-instance',
    prefix: 'stats.',
    flushInterval: 10000
  },
  // Datadog后端配置
  datadog: {
    apiKey: 'your-datadog-api-key',
    appKey: 'your-datadog-app-key',
    host: 'statsd-hostname',
    prefix: 'stats.',
    flushInterval: 10000
  }
}

关键配置参数

Docker Compose示例

yaml
version: '3'
services:
  statsd:
    image: [镜像名称]
    ports:
      - "8125:8125/udp"
    volumes:
      - ./config.js:/etc/config.js
    restart: always
    environment:
      - TZ=Asia/Shanghai

注意事项

• 确保配置文件中的API密钥和令牌正确，否则数据无法正常发送到监控平台
• 容器需以UDP协议暴露8125端口，用于接收指标数据
• 如需添加其他后端插件，需基于此镜像进行二次构建并安装相应npm包