PagerDuty 事件运行手册链接器

事件响应中的手册查找痛点

在 PagerDuty 触发紧急事件时，运维人员往往需要在极短时间内找到对应的排查手册。然而，团队的运行手册通常散落在不同的文档平台或服务目录中。如果缺乏统一的索引和自动化关联，工程师只能依赖记忆或手动搜索，这不仅延长了故障恢复时间，还容易在高压环境下遗漏关键步骤。

核心能力与工作流

该技能旨在消除事件与手册之间的断层，实现自动化关联。它首先通过 PagerDuty Events API v2 拉取实时事件流与服务目录信息，提取告警中的核心特征字段。

接着，技能利用 Elasticsearch 的模糊查询能力，将提取到的告警标签与运行手册的元数据标签进行匹配。这种机制能够有效处理标签拼写变体或大小写不一致的问题。一旦匹配成功，系统即可生成直达运行手册的链接，并将其注入到事件处理面板或通知渠道中，让值班人员一键跳转至排查流程。

适用边界与配置注意

• 标签治理：匹配准确率高度依赖运行手册的标签规范，建议团队建立统一的标签命名空间。
• 权限校验：部署前需确认执行环境具备 PagerDuty API 的读取权限及 Elasticsearch 的查询权限。
• 环境差异：底层依赖支持 Node 和 Browser 端，但部分 REST 接口可能需要配置额外的请求头。