AWS EC2实例Docker部署下Promtail /loki/api/v1/push端点报错求助

1. 先确认网络连通性 #

首先得搞清楚Promtail能不能连到Loki的推送端点：

• 进入Promtail容器执行测试命令：

  docker exec -it <你的Promtail容器名> sh
  curl -v http://43.206.43.87:3100/loki/api/v1/push
  

  如果返回连接超时、拒绝连接：
  • 检查AWS EC2安全组：确保3100端口的入站规则允许Promtail所在实例的IP（或临时放开0.0.0.0/0测试）
  • 检查Loki的Docker端口映射：用docker ps看Loki的端口是否是0.0.0.0:3100->3100/tcp，如果是127.0.0.1:3100->3100/tcp，那只能本地访问，Promtail（容器内）连不上
  • 检查Loki容器内的监听：进入Loki容器执行ss -tulpn | grep 3100，确认监听地址是0.0.0.0:3100而不是仅127.0.0.1

2. 检查Loki运行状态与日志 #

• 查看Loki容器日志有没有报错：docker logs <你的Loki容器名>，如果有启动失败、存储目录权限问题，先解决这些基础问题
• 确认Loki正常启动后，用主机curl测试端点是否可用：curl -v http://localhost:3100/loki/api/v1/push，如果主机能通但Promtail容器不通，大概率是网络或安全组问题

3. 修正Promtail的配置与挂载 #

• 日志路径挂载：Promtail配置里写了/var/log/*log，但如果启动容器时没挂载主机的/var/log目录，容器内根本找不到这些日志。启动Promtail必须加挂载参数：

  docker run --name promtail -v /var/log:/var/log -v $(pwd)/promtail-config.yaml:/etc/promtail/promtail-config.yaml grafana/promtail:latest -config.file=/etc/promtail/promtail-config.yaml
  

• Targets配置优化：static_configs里的targets是用来标记日志源的标签，不是Loki的地址，改成localhost或者留空都可以，避免混淆：

  static_configs:
  - targets:
      - localhost
    labels:
      job: varlogs
      __path__: /var/log/*log
  

4. 用Docker内部网络优化通信 #

如果Loki和Promtail在同一台EC2上，别用公网IP通信，改用Docker内部网络更稳定：

• 创建自定义网络：docker network create loki-net
• 启动Loki时加入该网络：

  docker run --name loki --network loki-net -p 3100:3100 -v $(pwd)/loki-config.yaml:/etc/loki/loki-config.yaml grafana/loki:latest -config.file=/etc/loki/loki-config.yaml
  

• 修改Promtail配置里的推送地址为容器名：

  clients:
    - url: http://loki:3100/loki/api/v1/push
  

• 启动Promtail时加入同一网络：

  docker run --name promtail --network loki-net -v /var/log:/var/log -v $(pwd)/promtail-config.yaml:/etc/promtail/promtail-config.yaml grafana/promtail:latest -config.file=/etc/promtail/promtail-config.yaml
  

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