everydayhero/statsd

Statsd-librato镜像说明

镜像概述

本镜像提供了一个运行在容器中的Node.js Statsd服务器，支持与Librato监控服务集成，用于收集和转发系统或应用的统计数据，便于后续分析与监控。

核心功能

1. 基于Node.js实现Statsd服务，监听UDP端口8125接收统计数据
2. 支持通过环境变量配置刷新间隔、百分位数、调试模式等参数
3. 集成Librato服务，将收集到的统计数据同步至Librato平台进行可视化分析

使用场景

适用于需要对系统或应用指标进行监控的场景，例如：

• 服务器CPU、内存、磁盘等资源使用率统计
• 应用接口调用次数、响应时间等业务指标跟踪
• 分布式服务节点的健康状态指标收集

配置说明

通过环境变量配置镜像参数：

• FLUSH_INTERVAL：数据刷新间隔（单位：秒）
• PERCENTILES：需计算的统计百分位数（如"90,95,99"）
• DEBUG：是否开启调试模式（true/false）
• LIBRATO_SOURCE：数据源标识（通常为服务器主机名）
• LIBRATO_TOKEN：Librato服务的访问令牌
• LIBRATO_USER：Librato服务的用户名

部署示例

Docker Run命令

bash
docker run \
  --name statsd-agent \
  -p 8125:8125/udp \
  -e FLUSH_INTERVAL=10 \
  -e PERCENTILES="90,95,99" \
  -e DEBUG=false \
  -e LIBRATO_SOURCE="your-hostname" \
  -e LIBRATO_TOKEN="your-librato-token" \
  -e LIBRATO_USER="your-librato-user" \
  everydayhero/statsd

Systemd Unit文件示例（Ansible部署用）

[Unit]
Description=Statsd agent
After=docker.service
Requires=docker.service

[Service]
TimeoutStartSec=0
ExecStartPre=-/usr/bin/docker kill statsd-agent
ExecStartPre=-/usr/bin/docker rm statsd-agent
ExecStartPre=/usr/bin/docker pull quay.io/everydayhero/statsd:{{ statsd_tag }}
ExecStart=/usr/bin/docker run \
  --name %n \
  -p 8125:8125/udp \
  -e FLUSH_INTERVAL={{ statsd.flush_interval }} \
  -e PERCENTILES={{ statsd.percentiles }} \
  -e DEBUG={{ statsd.debug_mode }} \
  -e LIBRATO_SOURCE={{ inventory_hostname }} \
  -e LIBRATO_TOKEN={{ statsd.librato_token }} \
  -e LIBRATO_USER={{ statsd.librato_user }} \
  statsd-agent
ExecStop=/usr/bin/docker stop statsd-agent

[Install]
WantedBy=multi-user.target