Prometheus 2.40 版本如何配置远程写入对接 Thanos 存储

在 Prometheus 2.40 版本中配置远程写入对接 Thanos 存储，核心是在 Prometheus 配置文件中添加 remote_write 段落，指向 Thanos Receive 服务的 HTTP 端点。默认情况下，Thanos 通过 URL 路径识别租户标识，而非请求头，配置时需特别注意路径格式。

先说结论：该方案适合多集群数据汇聚场景，需先部署 Thanos Receive 组件，最后通过查询接口验收数据完整性。

• 适合：需要将多个 Prometheus 实例数据统一写入中心存储的场景
• 先准备：确认 Thanos Receive 服务地址及租户 ID 规划（默认通过 URL 路径传递）
• 验收：在 Thanos Query 界面能查到对应租户的监控数据，且 Prometheus 无远程写入报错

配置核心片段

以下是 Prometheus 配置文件的关键片段，直接替换 prometheus.yml 中的对应部分。注意 URL 中需包含租户 ID 路径：

remote_write:- url: "http://thanos-receive:19291/api/v1/receive/tenant-1"remote_timeout: 30squeue_config:max_samples_per_send: 1000capacity: 2500# 生产环境建议启用 TLS 认证# tls_config:#   ca_file: /etc/prometheus/ca.crt#   cert_file: /etc/prometheus/client.crt#   key_file: /etc/prometheus/client.key

Thanos Receive 部署要点

Prometheus 写入前，需确保 Thanos Receive 组件已正确启动并配置对象存储。以下是 standalone 模式下的启动命令示例：

thanos receive \`--http-address` 0.0.0.0:19291 \`--grpc-address` 0.0.0.0:19292 \`--remote-write-address` 0.0.0.0:19293 \`--tsdb`.path /data/thanos/receive \`--objstore`.config-file /etc/thanos/objstore.yaml \`--receive`.local-endpoint thanos-receive:19293

若使用 Kubernetes 部署，需确保 Service 暴露 19291 端口供 Prometheus 访问，且 ConfigMap 中挂载了正确的对象存储配置。

配置生效与重载

修改配置后，无需重启 Prometheus 进程，可通过发送信号或调用 API 重载配置：

方法 1：发送信号

kill -SIGHUP $(pidof prometheus)

方法 2：调用 reload 接口（需启动时添加 `--web`.enable-lifecycle）

curl -X POST http://127.0.0.1:9090/-/reload

验证与排查

配置生效后，建议按以下步骤验证数据链路是否通畅：

1. 检查 Prometheus 日志

查看 Prometheus 标准输出或日志文件，确认没有 remote_write 相关的 error 报错。重点关注 "remote_write failed" 或 "connection refused" 类错误。

grep "remote_write" prometheus.log | grep "error"

2. 确认配置加载

访问 Prometheus 内置页面 /api/v1/status/config 确认新配置已生效（需开启 Web API）。

3. 查询数据完整性

最可靠的方式是打开 Thanos Query 界面，使用 PromQL 查询数据。例如查询特定租户的指标：

up{tenant="tenant-1"}

若能查到数据且时间戳连续，说明写入成功。

生产环境安全建议

示例中使用 HTTP 协议仅适用于测试环境。生产环境存在数据泄露风险，建议采取以下措施：

• 启用 TLS：在 Prometheus remote_write 配置中添加 tls_config 段，并在 Thanos Receive 侧配置对应证书。
• 网络隔离：通过内网 VPC 或 Service Mesh 限制访问来源，避免暴露接收端点到公网。
• 认证授权：若 Thanos 侧配置了 Basic Auth 或 Bearer Token，需在 Prometheus 配置中对应添加 authorization 字段。

常见坑

1. 租户 ID 传递方式不匹配

Thanos Receive 默认通过 URL 路径（如 /api/v1/receive/tenant-1）识别租户。若在 Prometheus 配置中使用 headers 传递 tenant_id，需在 Thanos 启动参数中显式指定 `--receive`.tenant-header，否则会导致写入被拒绝。

2. 网络延迟导致采集阻塞

remote_write 是同步等待响应的，网络波动会导致 Prometheus 采集阻塞。建议调整 queue_config 中的 capacity 和 max_samples_per_send 参数以增强缓冲能力。

3. 版本兼容性

虽然 2.40 版本稳定，但需确保 Thanos 组件版本与 Prometheus 协议兼容。建议遵循官方兼容性矩阵，避免使用过于陈旧的 Thanos 版本对接新版 Prometheus。

参考来源

• Prometheus 官方文档：Configuration file (https://prometheus.io/docs/prometheus/latest/configuration/configuration/)
• Thanos 官方文档：Receive Component (https://thanos.io/tip/components/receive.md/)

原文链接：https://www.zjcp.cc/ask/11409.html