SuperAPI AI 工具集

observability

部署与运维

查看项目

更新于 10-15 13:28

技能介绍

用途

可观测性(Observability)是指通过检查系统输出来从外部理解系统行为的能力,无需修改系统或猜测内部实现。该技能在用户进行日志、指标、分布式追踪、告警或定义 SLO 相关工作时被触发,提供从原则到具体实现的指导。

主要能力

该技能覆盖可观测性的三大支柱:日志(发生了什么)、指标(系统表现如何)、追踪(时间花在哪里)。它强调三大支柱只有在相互关联时才有用——p99 指标尖峰应能链接到追踪,追踪应能链接到日志。技能提供结构化日志、OpenTelemetry 埋点、SLI/SLO 定义、仪表盘设计、告警规则编写、分布式追踪实现以及错误预算监控等具体任务的方法与代码示例。

使用方式

当用户添加结构化日志(pino、winston、log4j、Python logging)、使用 OpenTelemetry 或厂商 SDK(Datadog、New Relic、Honeycomb)进行埋点、定义 SLI/SLO/错误预算、构建 Grafana 或 Datadog 仪表盘、编写 Prometheus 告警规则或配置 PagerDuty/Opsgenie 路由、实现分布式追踪(span、上下文传播、采样)、应对告警疲劳或值班倦怠、追踪事件并关联日志/追踪/指标时,应触发该技能。纯基础设施配置(Terraform、Kubernetes YAML)和代码级 CPU/内存性能分析不应触发该技能。

适用场景

适用于需要建立或改进服务可观测性的工程团队,包括日志规范化、指标埋点、追踪实现、SLO 制定、告警优化和事件响应等场景。技能提供了结构化日志中间件、OpenTelemetry SDK 配置、SLO 定义文件、Prometheus 告警规则、仪表盘布局、追踪上下文传播和错误预算查询等示例。

限制

该技能不适用于纯基础设施配置(Terraform、Kubernetes YAML)和代码级 CPU/内存性能分析。技能中提到的具体工具、SDK 和平台(如 pino、winston、OpenTelemetry、Prometheus、Grafana、Datadog、New Relic、Honeycomb、PagerDuty、Opsgenie)仅为示例,实际使用需根据环境选择。技能内容基于资料整理,未提供收费、价格或平台支持等额外信息。