rapidloop/statsd-vis

statsd-vis镜像说明

镜像概述

statsd-vis是一个独立的、零依赖的单二进制StatsD服务器Docker镜像，内置Web UI用于可视化时间序列数据图表。它将数据存储在内存中（可配置保留时长），不进行持久化或转发。

核心功能

1. 支持接收StatsD协议的TCP/UDP数据
2. 内存存储时间序列数据，可配置保留时长
3. 内置Web UI，直观展示指标图表
4. 通过命令行参数灵活配置flush间隔、百分位数等参数
5. 零运行时依赖，部署简单

使用场景

• 开发测试环境的实时指标监控
• 小型应用或服务的临时指标可视化
• 不需要持久化存储的轻量级监控场景

配置说明

通过命令行参数可配置以下选项：

• -flush interval：flush间隔（默认10s）
• -percentiles string：计时器指标的百分位数（默认"90,95,99"）
• -retention duration：数据保留时长（默认30m）
• -statsdtcp address：StatsD TCP监听地址（默认"127.0.0.1:8125"）
• -statsdudp address：StatsD UDP监听地址（默认"127.0.0.1:8125"）
• -webui address：Web UI监听地址（默认"0.0.0.0:8080"）

Docker部署示例

运行镜像时需将StatsD监听地址改为0.0.0.0（否则容器外无法访问）：

bash
docker run --rm -it -p 8080:8080 -p 8125:8125/udp -p 8125:8125/tcp rapidloop/statsd-vis -statsdudp 0.0.0.0:8125 -statsdtcp 0.0.0.0:8125

部署后可通过http://localhost:8080访问Web UI查看指标图表。