gometric/statsd-http-proxy

StatsD HTTP Proxy

镜像概述和主要用途

StatsD HTTP Proxy是一个HTTP代理服务器，用于连接StatsD（通常使用UDP协议），提供REST接口以便在浏览器环境中使用。它解决了浏览器无法直接使用UDP协议与StatsD通信的问题，允许前端应用通过AJAX请求发送指标数据到StatsD。

核心功能和特性

• HTTP到StatsD代理：将HTTP请求转换为StatsD兼容的UDP数据包
• REST接口：提供简单易用的REST API，便于前端应用集成
• 浏览器兼容性：专为浏览器环境设计，支持通过AJAX发送指标
• 可选认证：支持基于JWT令牌的身份验证，增强安全性
• 轻量高效：基于Go语言开发，性能优异，资源占用低

使用场景和适用范围

• 前端应用需要向StatsD发送性能指标（如页面加载时间、API响应时间）
• 浏览器环境中收集用户行为数据（如点击事件、页面停留时间）
• 需要从Web前端向StatsD监控系统上报自定义业务指标
• 对前端指标收集有安全性要求，需要认证机制的场景

使用方法和配置说明

基本使用

通过Docker运行StatsD HTTP Proxy容器，需指定StatsD服务器地址和端口。

Docker Run命令示例

bash
docker run -d \
  --name statsd-http-proxy \
  -p 8080:8080 \
  -e STATSD_HOST=statsd.example.com \
  -e STATSD_PORT=8125 \
  gometric/statsd-http-proxy

环境变量配置

启用JWT认证

如需启用认证，需设置JWT_SECRET环境变量：

bash
docker run -d \
  --name statsd-http-proxy \
  -p 8080:8080 \
  -e STATSD_HOST=statsd.example.com \
  -e STATSD_PORT=8125 \
  -e JWT_SECRET=your_secure_jwt_secret \
  gometric/statsd-http-proxy

API使用示例

发送指标到StatsD（假设代理运行在localhost:8080）：

发送计数器指标

bash
curl -X POST http://localhost:8080/counter \
  -H "Content-Type: application/json" \
  -d '{"metric": "page.views", "value": 1, "tags": ["page:home"]}'

发送计时器指标

bash
curl -X POST http://localhost:8080/timer \
  -H "Content-Type: application/json" \
  -d '{"metric": "api.response_time", "value": 42, "tags": ["endpoint:user"]}'

更多信息

• 项目GitHub仓库：https://github.com/GoMetric/statsd-http-proxy
• Docker镜像仓库：https://github.com/GoMetric/statsd-http-proxy-docker