ehlers320/polymur-pgw-key

Polymur 镜像说明

镜像概述

Polymur是一款用于Graphite明文协议指标的转发服务，支持广播（broadcast）或哈希路由（hash-route）模式，可将Collectd、Statsd等工具产生的指标转发至Graphite实例、InfluxDB等目标。它采用原生并发设计，能高效处理数千连接，提供缓冲、流量控制、运行时目标操作及故障转移等功能，旨在简化Graphite部署的组件数量并增强指标流管理灵活性。

核心功能

• 多模式分发：支持广播（向所有目标发送）和哈希路由（与Graphite兼容的算法，确保指标一致性）
• 高效连接处理：单实例可替代多carbon-relay+负载均衡器的组合
• 动态目标管理：通过API在运行时添加/删除转发目标
• 故障转移：哈希路由模式下，目标故障时自动将指标重新分配至健康节点
• 流量控制：每个目标独立队列，避免单一目标故障影响整体性能
• 缓冲机制：入站/出站队列缓冲，应对瞬时流量高峰

使用场景

1. 上游中继替代：接收所有发送主机的指标，分发至下游Graphite服务器
2. 本地中继替代：在Graphite服务器上运行，将上游指标分发至本地carbon-cache守护进程
3. 多目标镜像：将生产环境指标同时转发至多个监控系统（如Graphite和InfluxDB）

配置说明

Polymur通过环境变量配置，主要参数如下：

Docker部署示例

Docker Run命令

监听0.0.0.0:2003，将指标广播至10.0.5.20:2003和10.0.5.30:2003：

bash
docker run -d \
  -p 2003:2003 \
  -p 2020:2020 \
  -p 2030:2030 \
  -e POLYMUR_DESTINATIONS="10.0.5.20:2003,10.0.5.30:2003" \
  -e POLYMUR_DISTRIBUTION="broadcast" \
  -e POLYMUR_METRICS_FLUSH=30 \
  ehlers320/polymur-pgw-key

运行时管理

添加目标：

bash
echo putdest localhost:6020 | nc <容器IP> 2030

查看当前目标：

bash
echo getdest | nc <容器IP> 2030

删除目标：

bash
echo deldest localhost:6020 | nc <容器IP> 2030