配置Grafana Agent向Prometheus发送指标失败，该如何解决？

核心问题分析 #

你遇到的问题本质是两个关键配置错误：

• Prometheus默认未启用接收外部写入的API接口
• Grafana Agent配置的remote_write路径不符合Prometheus的API规范

分步解决方案 #

1. 配置Prometheus以允许接收写入 #

Prometheus的/api/v1/write写入接口默认禁用，必须通过启动参数开启：

• 启动Prometheus时添加--web.enable-admin-api参数，示例命令：

  prometheus --config.file=prometheus.yml --web.enable-admin-api
  

• 确保Prometheus所在机器的9090端口（默认监听端口）对Grafana Agent所在机器开放（防火墙/安全组放行）

2. 修正Grafana Agent的remote_write配置 #

将Grafana Agent配置文件修改为正确的Prometheus写入URL：

metrics:
  wal_directory: /tmp/wal
  global:
    remote_write:
      - url: http://172.31.11.242:9090/api/v1/write
integrations:
  agent:
    enabled: true

注意：Prometheus的标准写入API路径是/api/v1/write，而非你之前尝试的/api/prom/push或/api/v1/prom/push

3. 验证配置生效 #

• 重启Prometheus和Grafana Agent服务
• 检查Grafana Agent日志，确认不再出现connection refused或写入失败的警告
• 访问Prometheus UI（http://172.31.11.242:9090），查询指标agent_build_info，若能返回结果，说明指标推送成功

错误原因复盘 #

• 最初使用9009端口：该端口并非Prometheus默认监听端口，且未开放，直接导致连接拒绝
• 更换9090端口后路径错误：Prometheus不支持/api/prom/push这类非标准路径，仅识别/api/v1/write
• 未开启Prometheus admin API：即使路径正确，默认情况下写入接口处于禁用状态，必须手动开启

内容的提问来源于stack exchange，提问作者dur