InfluxDB 订阅（Subscription）

转载请注明出处：

一、InfluxDB 订阅推送机制

1. 推送原理

• 触发条件：当数据写入指定数据库的指定保留策略（RP）时

• 推送方式：通过 HTTP/HTTPS 协议以 POST 请求发送 原始行协议数据

• 数据格式：与直接写入 InfluxDB 的格式完全相同
  示例：cpu,host=server1 usage=75 1625097600000000000

2. 推送流程

                        

二、完整配置示例

1. 在 InfluxDB 中配置订阅

# 进入InfluxDB命令行
influx

# 创建订阅（推送到Kapacitor）
CREATE SUBSCRIPTION "kapacitor-alerts" 
ON "monitor"."rp30" 
DESTINATIONS ALL 'http://kapacitor:9092/write'

# 创建订阅（推送到另一个InfluxDB）
CREATE SUBSCRIPTION "influxdb-backup" 
ON "monitor"."rp30" 
DESTINATIONS ALL 'http://backup-influxdb:8086/write?db=monitor'

     查看订阅：

                        

2. InfluxDB 配置文件优化 （/etc/influxdb/influxdb.conf）

[subscriber]
  enabled = true
  http-timeout = "30s"       # 推送超时时间
  insecure-skip-verify = true # 跳过HTTPS证书验证（测试用）
  buffer-size = 2000         # 网络中断时的缓存条数

三、接收端配置示例

1. Kapacitor 接收配置

　　Kapacitor 无需特殊配置，默认在 9092 端口提供 /write 端点接收数据。

2. 自定义HTTP服务接收（Python示例）

from flask import Flask, request

app = Flask(__name__)

@app.route('/write', methods=['POST'])
def handle_data():
    print(f"Received data: {request.data.decode()}")
    return '', 204  # 必须返回204

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8080)

四、验证推送是否成功

1. 检查订阅状态

# 查看所有订阅
influx -execute "SHOW SUBSCRIPTIONS"

# 输出示例：
name: monitor
retention_policy name            mode destinations
--------------- ----            ---- ------------
rp30           kapacitor-alerts ALL  [http://kapacitor:9092/write]

2. 监控推送日志

3. 接收端验证

　　Kapacitor 端：　

# 查看接收统计
kapacitor stats ingress

# 输出示例：
Database   Retention Policy Measurement Points Received
monitor    rp30            cpu              1500

　　自定义HTTP服务端：
　　　　直接查看程序输出的接收日志。

五、故障排查命令

1. 测试推送手动触发

# 生成测试数据
echo 'test_metric,host=test1 value=1 $(date +%s%N)' | \
curl -XPOST 'http://influxdb:8086/write?db=monitor&rp=rp30' --data-binary @-

# 检查是否推送（InfluxDB端）
journalctl -u influxdb | grep -A 5 "test_metric"

2. 网络连通性测试

# 从InfluxDB容器测试Kapacitor连通性
docker exec -it influxdb curl -v -X POST http://kapacitor:9092/write -d "test value=1"

3. 查看失败记录

# 查看未推送的缓存数据
influx -execute "SHOW DIAGNOSTICS" 

4. 查看全局配置

SHOW DIAGNOSTICS

　　可以查看全局配置和系统信息

　　通过上面命令可以看到一下配置项：

name: config-subscriber
enabled http-timeout write-buffer-size write-concurrency
------- ------------ ----------------- -----------------
true    30s          1000              40

　　订阅功能启用，超时30s，并发40线程

六、高级配置技巧

1. 调试模式启用

# 在InfluxDB配置中增加调试日志
[logging]
  level = "debug"
  subscriber = true

七、关键注意事项

1. 数据一致性

   • 订阅推送是 至少一次（at-least-once） 语义

   • 网络中断可能导致重复数据

2. 性能影响

   • 每个订阅目标会增加约 5% 的 CPU 开销

   • 建议订阅目标不超过 3 个

3. 版本兼容性

   • InfluxDB 1.x 和 2.x 的订阅机制不同

   • Kapacitor 1.6+ 版本需使用 /write 端点