dblworks/statsd

StatsD Docker 镜像

概述

StatsD 是一个轻量级的网络守护进程，用于收集、聚合和转发应用程序指标。本镜像基于 Node.js 构建，提供了简单高效的指标收集解决方案，可与 Graphite、Prometheus 等后端监控系统集成。

主要特性

• 支持 UDP 和 TCP 协议接收指标数据
• 多种指标类型：计数器(Counter)、计时器(Timer)、计量器(Gauge)、直方图(Histogram)等
• 可配置的聚合间隔和刷新策略
• 支持多种后端输出适配器
• 轻量级设计，资源占用低
• 易于扩展和定制

使用场景

• 应用程序性能监控
• 系统资源使用情况跟踪
• 用户行为分析数据收集
• 服务健康状态监控
• 业务指标实时收集

Docker 部署示例

基本用法

bash
docker run -d -p 8125:8125/udp -p 8126:8126 --name statsd dblworks/statsd

自定义配置

bash
docker run -d \
  -p 8125:8125/udp \
  -p 8126:8126 \
  -v /path/to/config.js:/usr/src/app/config.js \
  --name statsd \
  dblworks/statsd

与 Graphite 集成

bash
docker run -d \
  -p 8125:8125/udp \
  -p 8126:8126 \
  -e GRAPHITE_HOST=graphite.example.com \
  -e GRAPHITE_PORT=2003 \
  --name statsd \
  dblworks/statsd

配置说明

StatsD 使用 JavaScript 配置文件进行设置。默认配置可通过挂载自定义 config.js 文件进行修改。主要配置选项包括网络监听设置、指标聚合规则、后端输出配置、日志级别和统计信息收集等。

指标格式

StatsD 支持以下指标格式：

• 计数器: metric.name:value|c[|@sample_rate]
• 计时器: metric.name:value|ms
• 计量器: metric.name:value|g
• 直方图: metric.name:value|h
• 集合: metric.name:value|s

维护与支持

该镜像由 dbl-works 维护，源代码托管于 https://github.com/dbl-works/statsd%E3%80%82%E5%A6%82%E6%9C%89%E9%97%AE%E9%A2%98%E6%88%96%E5%BB%BA%E8%AE%AE%EF%BC%8C%E8%AF%B7%E6%8F%90%E4%BA%A4 Issue 或 Pull Request。