hopsoft/graphite-statsd

Docker镜像：Graphite & Statsd

快速部署Graphite与Statsd

Graphite和Statsd的配置通常较为复杂，本镜像可帮助您在几分钟内完成部署并开始收集统计数据。

快速开始

sh
docker run -d\
 --name graphite\
 --restart=always\
 -p 80:80\
 -p 81:81\
 -p 2003-2004:2003-2004\
 -p 2023-2024:2023-2024\
 -p 8125:8125/udp\
 -p 8126:8126\
 hopsoft/graphite-statsd

此命令启动一个名为graphite的Docker容器。

包含组件

• Nginx：反向代理Graphite和Grafana仪表盘
• Graphite：前端数据仪表盘
• Carbon：后端数据接收服务
• https://github.com/etsy/statsd/wiki%EF%BC%9A%E5%9F%BA%E4%BA%8EUDP%E7%9A%84%E5%90%8E%E7%AB%AF%E4%BB%A3%E7%90%86%E6%9C%8D%E5%8A%A1
• Grafana：更精细的前端数据可视化仪表盘

端口映射

默认情况下，Statsd监听UDP端口8125。若需改为TCP端口，可在启动容器时设置环境变量STATSD_INTERFACE=tcp。

卷挂载

开始使用Graphite与Statsd

发送统计数据

使用以下命令模拟发送随机统计数据：

sh
while true; do echo -n "example:$((RANDOM % 100))|c" | nc -w 1 -u 127.0.0.1 8125; done

可视化数据

在浏览器中打开Graphite查看数据：

• http://localhost:81/dashboard
• http://localhost:81/render?from=-10mins&until=now&target=stats.example

安全设置：Django Admin

更新默认的Django Admin账号（默认配置不安全）：

• 用户名：root
• 密码：root
• ：

登录地址：http://localhost:81/account/login
修改账号信息：http://localhost:81/admin/auth/user/1/

修改配置

参考Graphite的安装后配置，重点关注storage-schemas.conf：

1. 停止容器：docker stop graphite
2. 查看容器配置路径：docker inspect graphite
3. 修改所需配置文件
4. 重启容器：docker start graphite

注意：若修改/opt/graphite/conf/storage-schemas.conf，需删除旧的Whisper文件：/opt/graphite/storage/whisper/。

重要：确保Statsd的刷新间隔不小于最高分辨率的保留时间。例如，若/opt/statsd/config.js中flushInterval=10000（10秒），则storage-schemas.conf的保留时间不应小于10秒：

[all]
pattern = .*
retentions = 10s:12h # 正确
retentions = 5s:12h # 错误

Statsd管理接口

通过端口8126管理Statsd并获取统计数据：

sh
# 查看当前所有计数器
echo counters | nc localhost 8126

https://github.com/etsy/statsd/blob/master/docs/admin_interface.md

安全设置：Grafana

更新默认的Grafana管理员账号（默认配置不安全）：

• 用户名：admin
• 密码：admin
• ***：admin@localhost

登录地址：http://localhost
修改账号信息：http://localhost/admin/users/edit/1

连接Grafana与Graphite

访问http://localhost/datasources/new，配置Graphite数据源：

• URL：http://localhost:81

卷挂载说明

您可指定主机路径挂载卷，方便管理配置和数据：

sh
docker run -d\
 --name graphite\
 --restart=always\
 -v /path/to/graphite/configs:/opt/graphite/conf\
 -v /path/to/graphite/data:/opt/graphite/storage\
 -v /path/to/statsd:/opt/statsd\
 hopsoft/graphite-statsd

注意：若挂载空目录到/opt/graphite、/opt/graphite/conf、/opt/graphite/storage或/opt/statsd，容器会自动初始化配置。

Memcached配置

若需Graphite使用现有Memcached服务，设置以下环境变量：

sh
docker run -d\
 --name graphite\
 --restart=always\
 -p 80:80\
 -p 2003-2004:2003-2004\
 -p 2023-2024:2023-2024\
 -p 8125:8125/udp\
 -p 8126:8126\
 -e "MEMCACHE_HOST=127.0.0.1:11211"\  # Memcached地址（多个用逗号分隔）
 -e "CACHE_DURATION=60"\              # 缓存时长（秒）
 hopsoft/graphite-statsd

额外阅读

• http://docs.docker.io/#introduction
• https://github.com/etsy/statsd/
• StatsD/Graphite监控实践指南
• https://github.com/etsy/statsd/blob/master/docs/graphite.md

贡献者

自行构建镜像：

1. git clone https://github.com/hopsoft/docker-graphite-statsd.git
2. docker build -t hopsoft/graphite-statsd .