用途:该技能用于处理 Algolia 支撑的搜索故障,不预设供应商是否有责,而是以证据驱动诊断、控制和可逆恢复。严重级别与响应目标来自组织自身的运行手册,诊断则结合应用、供应商与数据管道三方面证据。
前提条件:需明确仓库、环境与涉及的 Algolia 应用或索引;以本地 lockfile 与已安装客户端类型为实现依据;准备只读查询或明确可丢弃的测试目标;涉及改变供应商行为时,查阅其当前第一方文档。
工具纪律:用 Read、Glob、Grep 检查本地代码、配置名、测试与依赖版本;仅用 WebFetch 获取 Algolia 官方文档;只有在确定目标文件、约束与验证方案后才用 Write 或 Edit。
当前契约:区分可用性、鉴权、新鲜度、延迟、相关性与事件采集等症状;供应商状态只作信号之一,不作为根因结论;保留请求 ID、任务 ID、部署 SHA、设置变更与源快照;优先采用已测试过的流量回滚、旧索引目标或功能降级路径。
鉴权:使用只读或范围狭窄的事故凭据,切勿将密钥粘贴到工单、聊天、命令、截图或诊断包中。
步骤:声明事故负责人、受影响旅程、开始时间、严重级别来源与当前用户影响;冻结无关变更并记录近期发布、索引任务、密钥变更与供应商状态;运行已知只读查询,比对应用、直连客户端与真源结果;分类故障面并选择最小的可逆控制措施;用合成查询与代表性用户查询验证恢复,而非仅看 HTTP 成功;记录时间线、证据、决策、清理、后续负责人与回滚就绪度。
审批边界:未经事故指挥官批准,不得擅自设定严重级别目标、轮换凭据、重建生产、更改相关性设置或删除索引。
输出:返回事故分类、时间线、证据链接、控制措施、恢复检查、客户影响、未解决风险与后续任务。
错误处理:供应商状态不明时继续诊断应用与数据路径并监控官方状态;怀疑凭据泄露时通过批准的秘密流程升级轮换;新鲜度不匹配时先追踪源快照与任务完成再重建索引;恢复会影响相关性时回滚或取得产品负责人接受。
限制:资料未提供具体命令、默认阈值或监控工具细节;使用前需自行补齐组织级运行手册与验证用例。