Docker环境下Elastic APM Server与Java Agent连接失败求助

一、连接失败的常见原因 #

1. APM Server服务异常或端口配置错误 #

• 确认APM Server容器内是否监听0.0.0.0:8200：检查APM Server配置文件中apm-server.host参数，若设置为127.0.0.1:8200，仅容器内部可访问，Java应用容器无法连接。
• 查看APM Server启动日志：执行docker logs <apm-server容器名>，排查是否有端口占用、配置文件语法错误等启动失败问题。

2. 容器网络互通异常 #

• 验证Java应用容器是否加入目标网络：执行docker inspect <Java应用容器名>，查看Networks字段是否包含app-network，且网络状态正常。
• 测试服务名解析：进入Java应用容器，执行ping apm或nslookup apm，若无法解析到APM Server的容器IP，说明Docker DNS服务异常，可尝试重启Docker服务。

3. Java Agent配置失误 #

• 检查启动参数：确认Java启动命令中-Delastic.apm.server_url=http://apm:8200无拼写错误（如端口、服务名写错）。
• 协议匹配：若APM Server启用了HTTPS，Agent需对应配置https协议；未加密场景下确保Agent使用http。
• 确认Agent加载状态：查看应用日志是否有Elastic APM Agent started字样，若没有，检查-javaagent:/path/to/elastic-apm-agent.jar的路径在容器内是否有效。

4. 防火墙或安全组拦截 #

• 排查宿主机防火墙：临时关闭宿主机防火墙测试，或添加允许容器网络段（如172.x.x.x/16）通过8200端口的规则。
• 云环境检查：若在云服务器上部署，确认云安全组是否允许容器内部网络的流量互通。

二、Java应用到ELK数据流的调试步骤 #

1. 逐层验证连通性 #

• APM Server自身状态：进入APM Server容器，执行curl http://localhost:8200/healthcheck，返回{"status":"ok"}说明服务正常。
• Java容器到APM Server：进入Java应用容器，执行curl http://apm:8200/healthcheck，若返回正常则网络无问题，问题出在Agent配置；若仍拒绝连接，定位网络层面问题。
• APM Server到Elasticsearch：执行curl -u <ES用户名>:<ES密码> http://elasticsearch:9200（若ES开启认证），确认ES服务正常响应。

2. 开启调试日志定位细节 #

• Java Agent调试日志：在Java启动参数中添加-Delastic.apm.log_level=DEBUG，重启应用后查看日志，可获取Agent初始化、连接尝试、数据发送的详细过程。
• APM Server调试日志：修改APM Server配置文件，将logging.level设为debug，重启容器后查看日志，排查是否有Agent连接请求记录，或数据接收时的错误。

3. 验证数据流转全链路 #

• 确认Agent发送数据：查看APM Server调试日志，若有Received request from agent记录，说明Agent已成功连接并发送数据，可进一步检查ES索引。
• 检查ES数据：执行curl http://elasticsearch:9200/apm-*/_search，查看是否有APM相关索引生成并包含数据。

4. 优化启动依赖 #

• 在docker-compose中添加健康检查，确保Java应用在APM Server就绪后启动：

  apm-server:
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8200/healthcheck"]
      interval: 10s
      timeout: 5s
      retries: 5
  java-app:
    depends_on:
      apm-server:
        condition: service_healthy
  

• 确认Agent与APM Server版本兼容：尽量使用同版本的Agent和Server，避免版本不匹配导致的兼容性问题。

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