SuperAPI AI 工具集

signoz-health-check

部署与运维

查看项目

更新于 10-16 22:42

技能介绍

SigNoz Health Check 用于对 SigNoz 可观测性平台进行全面健康检查,通过分析服务、日志、指标、链路追踪和告警来识别亮点与问题。

用途

在需要对 SigNoz 平台做整体健康评估时使用,可快速掌握系统运行状况、发现异常并获取改进建议。

使用方式

命令格式为 /signoz-health-check [timeRange]。时间范围示例:不加参数为最近 24 小时(默认);1h 为最近 1 小时;6h 为最近 6 小时;7d 为最近 7 天。支持 30m、1h、2h、6h(分钟/小时)以及 24h、7d(天)等格式。

主要能力

技能会依次执行以下检查:

  1. 服务健康:列出所有活跃服务、调用率与请求量、错误率(识别错误率大于 0% 的服务)、P99 延迟指标、每个服务的主要操作。
  2. 错误分析:跨服务查询近期 ERROR/FATAL 日志、错误模式与频率、受错误影响最大的服务、常见错误消息。
  3. 链路追踪:为高错误服务获取错误链路、慢链路(P99 超过阈值)、链路模式与瓶颈。
  4. 告警:当前正在触发的活跃告警、告警频率与模式、未配置告警的服务(风险项)。
  5. 指标:可用指标键、关键性能指标、资源利用模式。
  6. 仪表盘:列出已配置的仪表盘及覆盖缺口。

输出格式

检查生成结构化报告,包含:亮点(如 0% 错误率的服务、高流量端点、达标的关键指标)、问题(按严重程度分为红色严重如错误率大于 1%、黄色警告如重复错误或性能下降、橙色注意如缺失告警或监控缺口)、建议(需要的即时操作、监控改进、可考虑的性能优化)。

工作流程

依次查询服务、检查告警、分析日志、检查链路、审查指标与仪表盘,最后综合为可执行洞察。

适用场景

定期健康检查(每日或每周)、故障排查起点、性能评审、容量规划、部署后验证。

前置条件与限制

需预先配置并连接 SigNoz MCP 服务器,且需可访问 SigNoz API。若出现“未找到服务”,需检查 SigNoz 是否运行及插桩是否启用、时间范围内是否有数据;若“MCP 服务器未连接”,需检查 Claude 设置中的 SigNoz MCP 配置及网络连通性;“数据不完整”可能因部分服务未完整插桩,需检查指示溢出的 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 查看告警模式。