ReportPortal分析器服务异常排查与解决方案

问题背景

在ReportPortal 24.2.3版本部署中，用户遇到分析器服务无法正常工作的现象。具体表现为：

1. 项目设置中的自动分析功能复选框呈灰色状态
2. 系统提示"Service Analyzer is not running"
3. 点击缺陷类型时无法获取建议

环境特征

• 部署平台：AWS ECS Fargate
• 版本信息：ReportPortal 24.2.3
• 相关服务：analyzer、analyzer-train、index-service、api-service

根本原因分析

通过日志分析和环境检查，发现问题的核心在于服务间通信配置不完整。具体表现为index-service无法通过正确的端点访问gateway服务，导致服务健康状态检测失败。在ECS环境中，由于缺乏内部DNS解析机制，服务发现需要额外配置。

解决方案

针对ECS环境的完整修复方案如下：

1. 服务连接配置

   • 启用ECS服务连接功能实现内部服务发现
   • 为gateway服务开放8081端口

2. 环境变量调整

   # index-service环境变量配置
   LB_URL: http://[gateway服务发现地址]:8081
   

3. 负载均衡配置

   • 为index-service创建独立的目标组
   • 在ALB上配置路径匹配规则，将以下路径路由至index目标组：
     • /composite/info
     • /composite/health
     • /ui
     • /

技术要点说明

1. 服务健康检查机制： ReportPortal内部服务通过HTTP健康检查端点相互验证状态。当index-service无法正确访问gateway时，会导致整个分析功能链失效。

2. ECS网络特性： Fargate环境下默认不提供私有DNS解析，必须显式配置服务发现或使用服务连接功能。

3. 关键依赖关系： analyzer-service的正常工作依赖于index-service的健康状态，而index-service又需要能够访问gateway服务。

验证方法

1. 检查各服务容器健康状态：

   curl http://[service-ip]:[port]/health
   

2. 确认服务版本信息：

   curl http://[service-ip]:[port]/info
   

3. 检查跨服务通信：

   # 从api-service容器内测试访问analyzer-service
   curl -v http://analyzer:5001/
   

经验总结

1. 在容器化部署中，服务发现机制是微服务架构的关键组件
2. ReportPortal的健康检查链较为严格，任一环节故障都会影响功能可用性
3. ECS环境与传统Docker环境在网络配置上存在差异，需要特别注意

该解决方案已在实际生产环境中验证有效，成功恢复了分析器服务的全部功能。对于其他类似环境的部署具有参考价值。