用途:对 SigNoz 可观测性平台执行全面健康检查,分析服务、日志、指标、链路与告警,识别亮点与问题。
主要能力:
- 服务健康:列出活跃服务、调用量与请求量、错误率(标记大于0%错误的服务)、P99 延迟、各服务主要操作。
- 错误分析:查询所有服务近期 ERROR/FATAL 日志、错误模式与频率、受影响最重的服务、常见错误信息。
- 链路(Traces):高错误服务的错误链路、慢链路(P99 超阈值)、链路模式与瓶颈。
- 告警:当前触发的活动告警、告警频率与模式、未配置告警的服务(风险项)。
- 指标:可用指标键、关键性能指标、资源使用模式。
- 看板:已配置看板列表与覆盖缺口。
输出格式:结构化报告,包含亮点(0%错误的服务、高流量端点、达标关键指标)、问题(严重:错误率>1%;警告:重复错误或性能下降;注意:缺少告警或监控缺口)、建议(立即行动、监控改进、性能优化)。
使用方式:命令为 /signoz-health-check [timeRange]。示例:/signoz-health-check 检查最近24小时(默认);/signoz-health-check 1h 最近1小时;/signoz-health-check 6h 最近6小时;/signoz-health-check 7d 最近7天。时间范围支持 30m、1h、2h、6h、24h、7d,默认 24h。
前提条件:需配置并连接 SigNoz MCP 服务器;需具备 SigNoz API 访问权限。
限制与常见问题:
- “No services found”:确认 SigNoz 运行且已开启埋点,并确认所选时间范围有数据。
- “MCP server not connected”:需在 Claude 设置中配置 SigNoz MCP 服务器并检查网络连通性。
- “Incomplete data”:部分服务可能埋点不完整,注意 dataWarning 字段提示的数据溢出。
关键指标阈值:错误率>1% 需严重排查;P99 延迟>10s 需性能评估;告警数为0 需补充监控;重复错误>10次/小时 需根因分析。
适用场景:日常/每周健康检查、事故排查起点、性能评审、容量规划、部署后验证。深入排查可结合 mcp__signoz__signoz_get_trace_details、mcp__signoz__signoz_search_logs_by_service、mcp__signoz__signoz_get_alert_history。