SuperAPI AI 工具集

observability-patterns

部署与运维

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能讲解 Web 应用的可观测性模式,用于回答生产环境中的问题,例如某些用户页面为何变慢、哪条请求路径失败、某次部署是否抬高了错误率、哪个后端依赖造成延迟、用户是否真的受影响。核心观点是可观测性不等于只记日志,而是日志、指标、追踪、错误上报、仪表盘与告警的组合使用。

主要能力:区分四类信号——日志适合记录带上下文字段的离散事件,推荐结构化日志(含 level、message、requestId、userId、route、statusCode 等),便于过滤、分组与关联;指标适合趋势、速率、延迟与告警,常用请求速率、错误率、延迟、队列深度、缓存命中率、活跃连接,并强调用百分位而非平均值;追踪用于跨服务跟随单个请求,定位时间或失败在链路中累积的位置;错误上报用于分组异常与崩溃,事件应带发布版本、环境、路由、请求或追踪 ID。还覆盖前端可观测性(JS 异常、失败请求、Core Web Vitals、路由切换延迟、hydration 失败)、后端信号、关联 ID、黄金信号(延迟、流量、错误、饱和度)、SLO 与用户影响、告警与仪表盘设计、采样与成本、高基数警告、常见反模式以及事故排查流程。

使用方式:资料未提供具体安装命令或代码调用方式,仅给出结构化日志示例与追踪链路示意。实践建议是先对用户流程与系统边界埋点,如路由请求、API 调用、缓存查询、数据库查询、队列任务、外部服务调用、表单提交失败、鉴权失败;避免一开始就埋过细的内部事件。

适用场景:Web 应用的生产监控、事故排查、部署回归分析、前后端联合诊断。

限制:资料未提供收费、价格、平台支持或效果数据;高基数标签(原始用户 ID、含动态 ID 的路径、自由文本错误)不宜作为指标维度,应放入日志字段;遥测有成本,需权衡日志保留、追踪采样与客户端带宽。