夜莺集成 Prometheus 时序库：Remote Write 配置与多数据源实践

加载配置并启动服务：

systemctl daemon-reload
systemctl enable prometheus
systemctl restart prometheus
systemctl status prometheus

二、验证 Remote Write 接口

服务启动后，直接调用写入接口可快速验证功能是否生效。如果返回 empty write request 说明接口已就绪；若报 404 则代表未开启接收器。

curl -X POST http://localhost:9090/api/v1/write

同时检查日志文件，确认没有报错信息，特别是关于权限或端口绑定的错误。

三、配置夜莺对接时序库

夜莺作为 Pushgateway 使用时，需要在配置文件中指定目标时序库的地址。核心修改位于 etc/config.toml 的 [[Pushgw.Writers]] 部分。

1. 添加数据源配置

在配置文件中新增一个 Writer 节点，指向刚才部署的 Prometheus 地址：

[[Pushgw.Writers]]
Url = "http://127.0.0.1:9090/api/v1/write"
BasicAuthUser = ""
BasicAuthPass = ""
Headers = ["X-From", "n9e"]
Timeout = 10000
DialTimeout = 30000
TLSHandshakeTimeout = 30000
ExpectContinueTimeout = 1000
IdleConnTimeout = 90000
KeepAlive = 30000
MaxConnsPerHost = 0
MaxIdleConns = 100
MaxIdleConnsPerHost = 100

这里的 Url 是关键，它决定了数据流向。只要对方支持 Prometheus Remote Write 协议即可接入。

2. 重启服务与应用

修改配置后，记得重启夜莺服务使配置生效：

systemctl restart n9e
systemctl status n9e

随后在夜莺 Web 界面的数据源管理中，刷新列表并确认新添加的 Prometheus 数据源状态正常。此时，夜莺产生的告警和指标数据就会自动转发至该时序库。

四、常见问题排查

1. 转发时报 404 错误

这通常意味着 Prometheus 端未正确启用接收器。请再次核对启动参数，确认是 --web.enable-remote-write-receiver 还是 --enable-feature=remote-write-receiver，并确保版本匹配。

2. 权限问题

如果 Prometheus 无法写入数据目录，会因权限不足导致失败。确保运行用户拥有数据目录的读写权限：

chown -R prometheus:prometheus /opt/prometheus/data

3. 端口冲突

如果默认的 9090 端口被占用，可以通过 --web.listen-address 参数修改监听地址，例如改为 9091：

--web.listen-address=:9091

五、总结

通过上述步骤，我们成功构建了夜莺到 Prometheus 的数据链路。这种架构允许利用 Prometheus 强大的查询能力处理夜莺上报的历史数据，同时也为多数据源统一管理提供了基础。在实际生产环境中，建议配合防火墙策略限制 Remote Write 接口的访问来源，确保数据安全。