关于 incident-diagnosis-specialist
incident-diagnosis-specialist 是用于 Splunk 多组件或多影响面事件的事后分诊建议 Skill。它分析经隐私审查的诊断包、对齐证据与假设,并转交已确认的组件故障;不修改系统,也不收集原始诊断材料。
主要功能
- 01分析经隐私审查的诊断包
- 02区分影响与可能原因
- 03按时间和来源对齐证据
- 04跟踪可检验的竞争假设
- 05转交已确认的组件故障
适用场景
- 01关联多个 Splunk 组件的症状
- 02评估客户与服务提供方证据冲突
- 03判断诊断包是否支持继续分析
- 04准备范围明确的专家转交
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ splunk/ splunk-agent-skills --skill incident-diagnosis-specialist安装后在 Claude Code 中输入/incident-diagnosis-specialist确认已加载。
附带文件agents/openai.yaml
详细介绍
事件诊断专家
诊断涉及多个 Splunk 组件或用户影响面的分诊后事件。使用现有的隐私审查诊断包,区分影响与原因,对齐证据时间,并管理相互竞争且可检验的假设。如果诊断包信息不足或已确认组件边界,则停止。此技能仅提供建议,不会修改任何内容。
前置条件
只接受他人提供且经过隐私审查的诊断数据包,或基于此类数据包生成的脱敏事件摘要。绝不请求、检查、收集、生成、上传或复述原始诊断或 RapidDiag 存档、未受限制的日志、数据包捕获、核心转储或内存转储、凭据、客户数据、私有 Support 材料、私有 URL、配置导出或提供商内部信息。
在每条重要陈述的使用处标注:
[supplied]:由请求者陈述或存在于经过隐私审查的数据包中;[documented]:来自当前公开 Splunk 文档,且适用于确切的产品、版本、部署、提供商和客户访问边界的行为;[observed]:数据包中已规范化的直接只读观察,包含来源、组件、范围、事件时间和收集时间;[inferred]:基于已标注证据得出的有限解读,并列出其他可能解释和矛盾;以及[unknown]:缺失、过时、矛盾、不可比较、无法访问或尚未确定。仅说明该缺口妨碍得出的结论。
保留所有提供的事实、矛盾、直接影响、已知良好对照和未知项。不得仅因缺少具体版本、拓扑字段、时钟或负责人,就将已知产品或部署弱化为 unknown。工单状态、历史解决记录、文档页面、汇总健康状态颜色、告警标签、重启、回滚、提供商说明或之后一段无告警时段,都不能直接证明原因、完整影响、恢复、稳定性或结案。
仅将 web 用于查阅当前公开的 Splunk 文档。检索到的页面只能证明适用的文档所述行为,不能证明部署的实时状态,也不能授权执行文档中的操作步骤。
在相应位置使用以下确切的 Cloud 来源:
- Cloud Monitoring Console 字段: https://help.splunk.com/en/splunk-cloud-platform/administer/admin-manual/10.5.2605/monitor-your-splunk-cloud-platform-deployment/introduction-to-the-cloud-monitoring-console
- 健康仪表板字段与数据新鲜度: https://help.splunk.com/en/splunk-cloud-platform/administer/admin-manual/10.5.2605/monitor-your-splunk-cloud-platform-deployment/use-the-health-dashboard
- 客户/提供商责任边界: https://help.splunk.com/en/splunk-cloud-platform/get-started/service-terms-and-policies/10.5.2605/information-about-the-service/splunk-cloud-platform-service-details
如果提示词指出使用的是 Splunk Cloud,但未说明确切版本,仅将这些来源作为 10.5.2605 的非决定性目录,用于列出客户可见字段和责任边界。目标版本的行为、租户状态、提供商活动、原因、责任归属和恢复情况均须保持未验证状态。
对于原始诊断数据包的边界,使用以下确切的 Enterprise 10.4 来源:
- Monitoring Console 证据类别: https://help.splunk.com/en/splunk-enterprise/administer/monitor/10.4/about-the-monitoring-console/what-can-the-monitoring-console-do
- 健康状态证据类别: https://help.splunk.com/en/splunk-enterprise/administer/monitor/10.4/proactive-splunk-component-monitoring-with-the-splunkd-health-report/investigate-feature-health-status-changes
- 诊断文件边界: https://help.splunk.com/en/splunk-enterprise/administer/troubleshoot/10.4/contact-splunk-support/generate-a-diagnostic-file
这些来源仅用于说明文档中记载的证据范围,以及诊断文件是产品产物。它们绝不授权此技能生成、检查、请求、上传或概述该文件,也不能证明本地资源原因、范围、影响或补救措施。若缺少确切的 Enterprise 版本,仅将这些来源作为带限定条件的非决定性字段目录。
适用场景
仅在初步分诊后使用此技能,且主要目标是关联两个或更多可能相关的组件、依赖项、证据层或影响面上的事件。典型适用工作包括:
- 数据摄取延迟或丢失,同时出现索引、搜索、集群、调度器或仪表板症状;
- 搜索或对象故障,同时出现对等节点、集群、KV Store、捆绑包、维护、证书、存储或提供商相关现象;
- 运行状况、资源、队列、重启、升级或维护相关现象,这些可能是原因、结果、控制措施,也可能只是巧合;
- 面向客户、组件本地、监控和提供商的证据相互冲突;
- 判定所提供的数据包是否支持继续进行跨组件诊断、给出范围明确的结论,或移交给专家;以及
- 定义可比的只读验证方案,且不运行诊断工作负载。
请勿将此技能用于初步分诊、运行状况界面导航、证据收集或已知的单组件修复。如果记录中只有一个已确认的组件症状,且没有尚未解决的跨组件因果问题,请保留范围明确的影响并转交处理。不要臆造影响范围更广的事件。
精确的转交边界
诊断数据包边界
请将运行状况界面选择、CMC 或 Monitoring Console 导航、最小证据清单、注重隐私的 diag 或 RapidDiag 规划、收集、精简、脱敏和数据包规范化工作,转交给 Splunk Health Monitoring and Diagnostic Collection(splunk-health-monitoring-and-diagnostic-collection)。仅提供所需的最少组件字段和时间范围。此技能只使用返回的数据包,不收集源材料。
已确认的组件交接
使用准确的显示名称和 slug。仅针对边界明确的组件及影响范围内已确认的故障进行交接:
- 转发器与数据摄取诊断工具(
forwarder-and-data-ingest-doctor):适用于已确认的通用型或重型转发器、输入、发送方、传输、HEC 路径、解析、时间戳、事件边界、路由、队列或背压故障,或数据缺失、延迟、重复、丢弃、路由错误等故障。 - 搜索与仪表板故障排查工具(
search-and-dashboard-troubleshooter):适用于已确认的现有搜索、报告、警报、仪表板、面板、可视化、权限、字段、宏、查找、令牌、数据源、后处理、渲染、触发器、操作或依赖阶段的功能中断。 - 索引器集群健康与故障排查(
indexer-cluster-health-and-troubleshooting):适用于已确认的集群管理器或对等节点成员资格、复制因子/搜索因子、可搜索性、存储桶/修复、集群包、多站点、SmartStore 健康状况或滚动就绪故障。 - 搜索头集群健康与故障排查(
search-head-cluster-health-and-troubleshooting):适用于已确认的队长选举、选举、Raft、成员、心跳、配置或工件复制、调度器委派、KV Store、部署器、配置漂移或滚动就绪故障。 - 搜索性能优化器(
search-performance-optimizer):适用于已确认的单个功能性搜索的 SPL 或作业成本、队列/运行时间、提前结束、Job Inspector 证据、加速适配性或理解语义的调优问题。 - 仪表板、报告和警报性能顾问(
dashboard-report-alert-performance-advisor):适用于已确认的跨对象延迟、排队、超时、调度遗漏或重复、分发/并发压力、刷新重叠或数据源扇出问题。
仅当每个边界都有独立证据时,混合事件才可进行多项交接。请在此保留事件时间线、依赖关系图、影响、尚未解决的假设、验证范围和整体责任归属。组件故障并不自动构成所有症状的原因。切勿声称某个同级组件已接受、执行、补救、验证或完成交接。
如果已确认的独立组件没有指定的目录专家,则将问题交接给提供的相应组件负责人角色,不得虚构显示名称或 slug。Deployment Server 资源故障应交由相应的 Deployment Server 组件负责人进行另行授权的诊断/操作;机群部署仍不在范围内。
工作流概述
1. 绑定决策、事件阶段和数据包身份
重述确切决策。确认初步分诊已完成,并且只清点已提供的字段:
| 区域 | 重要字段 |
|---|---|
| 环境 | Splunk 产品、确切版本、Cloud 或 Enterprise、提供商、高级产品背景、拓扑和组件角色 |
| 事件 | 当前、恢复中、历史、重复发生或未知阶段;受影响的时间范围和时区;首次发现时间;最后已知正常时间;当前状态 |
| 影响 | 直接观察到的用户/业务影响、受影响范围和已知正常范围、影响范围、数据/搜索/检测/对象可用性、严重性负责人 |
| 变更背景 | 维护、升级、部署、证书、重启、提供商、基础设施、工作负载、来源或对象变更;每项均有各自的时钟 |
| 证据 | 数据包身份、隐私状态、工件来源、事件时间、收集时间、范围、新鲜度、精度、时区、来源和证据负责人 |
| 归属 | 事件负责人、证据负责人、组件负责人、提供商边界、验证负责人、行动负责人、停止负责人和验收负责人 |
将缺失的值标记为 unknown。不要根据产品关键词或角色名称推断拓扑、提供商活动、是否纳入维护、组件关系或负责人。产品和提供商背景会限制哪些证据可访问以及谁能采取行动;但它们不能确定原因。
对于 Cloud 10.5.2605,请使用对应版本的运行状况仪表板,查看文档所述的客户可见指标和新鲜度字段;并使用对应版本的维护仪表板,查看文档所述的维护时段观察结果。若要说明客户与提供商之间的边界,请结合确切版本的 Splunk Cloud Platform 服务详情。只有在提供了该版本时才使用这些页面;这些页面不能证明当前运行状况、是否参与维护、隐藏的拓扑、提供商的操作或事件归属。对于其他版本,请查找其确切的当前页面,否则将相关文档声明标记为无法确认。
2. 判断数据包是否充分
只有在包含以下内容时,数据包才足以支持范围明确的诊断步骤:
- 分诊后的决策,以及直接陈述的影响或明确标注的影响未知;
- 产品和部署类别;版本/提供商/拓扑保留为已提供的信息或明确标注为未知;
- 受影响的时间范围和时区,或一个无需收集原始材料即可解决的明确时钟缺口;
- 至少两项相关观察、组件、依赖项或已知正常的比较对象;每项均包含来源、范围、事件时间、收集时间和来源信息;
- 足以在不暴露私人标识符的情况下比较同类对象的身份信息;
- 将矛盾和近期变更作为观察结果,而非结论;以及
- 对最小范围的下一步判别所需证据负有责任的负责人。
如果下一步诊断决策依赖缺失、仅有原始数据、过时、无法比较或提供商无法访问的证据,则返回 packet_insufficient。保留所有可用事实,并且仅向 Splunk Health Monitoring and Diagnostic Collection 提供所需的最少规范化字段。不要返回宽泛的检查清单,也不要要求用户附加、上传、导出、导航到或运行任何内容。
数据包是否充分取决于具体决策。缺少根因证据,不会抹去直接观察到的当前影响。缺少某个组件的时钟,只会阻碍需要该时钟的关联分析。
3. 构建按时间对齐的证据矩阵
每个观察项占一行。绝不要将不同证据平面合并为同一个时间戳。
| 观察项 | 组件/范围 | 证据平面 | 事件时间 | 收集时间 | 时钟/时区/精度 | 新鲜度 | 来源 | 可证实的内容 | 无法证实的内容 |
|---|
在重要情况下,区分:
- 来源事件、应用事件和组件本地时间;
- 接收时间、索引
_time和索引_indextime; - 搜索到期时间、调度器决策、派发、排队、启动、完成和产物时间;
- 告警、操作、传输、接收、仪表板刷新、渲染和报告时间;
- 健康状况计算、仪表板刷新、收集、截图、工单和提供商通知时间;以及
- 配置、部署、升级、维护、重启、回滚和恢复操作时间。
仅规范化有文档记录的时区或时钟表示。保留精度和不确定性;绝不要臆造秒数、顺序、时长或共用时钟。将各行标记为 aligned、partially_aligned、incomparable、stale 或 unknown。时间上的重叠或相邻只能支持某种假设,不能单独证明因果关系。
如果搜索作业很重要,且已提供确切的产品/版本,请将可用的作业字段对应到匹配的当前页面:Cloud 10.5.2605 搜索作业属性或 Enterprise 10.4 搜索作业属性。这些页面记录了字段,但不能证明该作业曾存在、运行或完成,也不能证明它导致了此事件。
4. 绘制组件和依赖关系图
仅绘制已提供或有文档记录的候选关系:
component or surface -> candidate dependency -> component or surface -> observed impact
对每条边,记录 supplied、documented_applicability、assumed、contradicted 或 unknown。文档可能表明某种依赖关系可以存在;但这不能证明部署中实际使用了该依赖,也不能证明该依赖发生了故障。
即使以下平面彼此重合,也要将它们分别处理:
- 发送方、转发器、传输、接收方、解析、路由、索引和搜索可见性;
- 索引器主机/进程、集群成员资格、分布式搜索可达性、因子、存储桶/可搜索性、存储和 SmartStore 行为;
- 搜索头主机/进程、Web 访问、主节点/成员参与情况、复制、调度/派发、KV Store、部署器和功能对象行为;
- 单次搜索的开销、跨对象并发、调度器压力、平台资源信号和提供商/基础设施状态;以及
- 对象派发、结果、依赖项、渲染、触发/操作、传输和下游结果。
对于 Enterprise 10.4,搜索头集群仪表板记录了成员、主节点、状态和心跳字段,而索引器集群管理器仪表板记录了管理器可见的对等节点和集群信息。这两个页面都不能证明事件中的组件状态、跨组件依赖关系、影响或根本原因。不要将这些 Enterprise 界面转化为 Cloud 客户操作。
5. 建立一份竞争性假设清单
每个因果假设占一行,并纳入巧合和观测质量方面的替代解释:
| 假设 | 可能解释的有限范围影响 | 支持证据 | 矛盾证据 | 替代解释 | 假设的关联 | 预测的观测结果 | 最小安全判别方法 | 证据负责人 | 结果 | 置信度 | 状态 |
|---|
允许的状态仅限:
proposed;supported_not_confirmed;falsified;confirmed_for_bounded_scope;或unknown。
始终一致地应用事件状态优先级:
- 看似受控的重启,若没有突然故障的证据、没有确认的影响,且提供商/变更是否包含在内尚不明确,则状态为
decision_blocked,而非已确认的组件故障; - 直接提供的告警遗漏、邮件/输出缺失、数据/搜索延迟或其他功能影响,即使当前是否复发或原因仍未知,状态也应为
active_impact_cause_unconfirmed;以及 - 历史症状之后出现提供商/组件观测结果或一段平静期,状态应为
no_current_failure_established,恢复验证为unverified,绝不可标记为已恢复或已关闭。
有限事件窗口内的直接降级仍应标记为 active_impact_cause_unconfirmed,除非提示中提供了可比的恢复证据,或明确说明影响已结束。之后的归因说明不会将状态改为历史故障/当前无故障。
当已提供直接的活动或间歇性影响,但下一步决策因仅有原始证据或证据尚未标准化而受阻时,应以 active_impact_cause_unconfirmed 和 packet_insufficient 为首要状态。不要让有限范围的组件症状或精确的专家处理路径取代主要的活动影响和证据包受阻状态。
应依据解释价值和证据质量对假设排序,而非严重性、近期性、熟悉程度、日志级别、健康状态颜色、历史关闭状态、建议的修复方案或症状的报告顺序。如果关联关系尚未证实,始终纳入一种用于检验看似相关的症状是否彼此独立的替代解释。
有针对性地使用对照:未受影响的对等对象、站点、成员、用户、浏览器、对象、路由、输入、环境、作业或时间窗口,都可能反驳过于宽泛的原因。健康的对照对象不能证明故障机制;聚合层面的健康状态也不能抹去有限范围内的直接故障。
6. 校准事件状态并确认有限范围
优先报告证据支持度最高的状态,按以下顺序判断:
active_impact_cause_unconfirmed:直接的当前证据证实存在重大影响,但因果链尚未确认。不要因为原因、负责人或完整影响范围未知而降低状态。bounded_component_failure_confirmed:一致的证据证实某个组件在所述范围内发生故障;更广泛的影响或起因仍可能尚未查明。decision_blocked:未证实存在直接的当前故障,且缺失或不可比较的证据妨碍了所请求的决策。no_current_failure_established:所提供的证据包含一项观测或历史症状,但没有直接证实当前组件故障或影响。这不表示系统健康、已恢复或稳定。
只有在有限范围内满足以下所有条件时,才能确认假设:
- 一致的证据证实故障组件以及所要解释的影响;
- 依赖关系边已提供,或当前文档明确记录了适用于准确适用范围的该依赖关系边,且在本次事件中观察到了该边;
- 受影响时间窗口内存在预测的观测结果,且在存在有效对照时,对照中未出现这些结果或结果存在重大差异;
- 重大竞争性解释已被证伪,或已明确排除在范围之外;
- 安全、非变更的判别性观测或重复的可比较观测支持该关联;并且
- 矛盾、置信度、范围、负责人及尚未证实的更广泛结论均保持可见。
已确认的组件故障,若要作为另一种症状的根本原因,仍可能仅处于 supported_not_confirmed 状态。绝不能将重启时间接近、回滚时间接近、提供方的说法、已消除的警告、历史修复或单次复现提升为因果确认。
7. 选择最小且安全的判别方法
选择一项现有的、经隐私审查的只读观测,以最有效地区分主要假设。说明:
- 它能区分哪些假设;
- 准确的组件及有限的时间/比较范围;
- 所需的规范化字段,不包含私人值;
- 事件时间和采集时间,以及所需的精度;
- 负责提供证据的客户、Enterprise、组件或提供方负责人;
- 每个剩余假设对应的预测结果;以及
- 若证据不安全、无法访问、已过时或不可比较时的停止条件。
优先使用现有且一致的控制项或组件直接回读,而不是扩大采集范围。绝不要执行或要求用户执行搜索、命令、API 调用、诊断、导出、刷新、重试、重放、回填、重启、故障转移、负载测试或状态变更。绝不要故意复现崩溃、中断、过载、证书故障、队列阻塞、格式错误的载荷、破坏性操作或高成本工作负载。如果需要新的执行操作,应将证据需求转交给负责人,并将结果保留为 unknown。
8. 指定影响、证据、行动和停止责任人
保持各责任角色彼此独立:
| 角色 | 职责 |
|---|---|
| 事件责任人 | 负责整个事件的优先级、协调和关闭决策 |
| 影响责任人 | 验证业务/用户影响和验收标准 |
| 证据责任人 | 提供已获授权的标准化只读观察结果 |
| 组件责任人 | 负责已确认的组件边界和专家交接 |
| 行动责任人 | 在此技能之外单独授权并执行补救措施 |
| 验证责任人 | 对比范围明确的事前/事后或受影响/已知正常证据 |
| 停止责任人 | 在达到明确的安全或影响阈值时停止证据收集或行动 |
仅使用已提供的责任人;否则写 unknown。对于自管理 Enterprise,
应根据证据区分客户平台、组件、基础设施、网络、对象和验证责任人。
对于 Cloud,应区分客户可见的证据和对象责任,以及客户无法访问的服务状态
或由提供商负责的行动。不要推断 Splunk Support 负责客户证据,不要联系
Support、创建或更新工单,也不要声称提供商采取了行动。
对于 Cloud,即使未提供具体人员/团队,也始终要呈现各责任角色:客户 Cloud
管理员负责已可见的 CMC/Health/对象回读;客户事件责任人负责优先级和关闭;
影响责任人负责业务/用户验证;在有明确范围的故障得到证据确认前,组件责任人
保持为 unknown;只有当 Service Details 表明服务证据/行动不在客户访问范围内时,
Splunk 提供商或 Splunk Support 才负责这些受限的服务证据/行动;验证和停止
责任人应列明角色,或标为 unknown。仅写“提供商负责”不构成明确的责任交接。
对于自管理独立组件的数据包边界,呈现相同的责任角色:客户事件责任人、
业务/影响责任人、Health Monitoring and Diagnostic Collection 证据责任人、
具名组件责任人、单独授权的组件行动责任人、验证责任人和停止责任人。
人员/团队可保留为 unknown,但绝不能省略责任角色或确切的处理途径。
对于托管 Cloud 中搜索头集群成员之间重复的计划搜索分派,应引用 CMC、Health 和 Service Details,说明客户可见范围/提供商负责范围。当无法获取对应 Cloud 版本的来源时,仅将 Enterprise 10.4 Scheduler Activity 和搜索作业属性用作 不具决定性的目录,查询调度器/作业字段。SHC 委派、同步、KV Store、成员版本 和产品缺陷行为均须以证据为准;仅将已确认的成员/调度器故障交由 Search Head Cluster Health and Troubleshooting 处理,同时由 Dashboard, Report, and Alert Performance Advisor 继续跟踪发现问题的影响。
不得编造数据包来源。只有当提示明确提供此事实时,才能称证据为经过隐私审查的 诊断数据包;否则称其为所提供的已脱敏事件摘要或所提供的观察结果。
9. 交接时保留事件整体状态
每次已确认的组件交接必须包含:
Exact specialist: <display name and slug>
Status: confirmed_for_bounded_scope; handoff not executed
Product/deployment/provider: <supplied values and unknowns>
Bounded finding: <failed component, direct impact, confidence, and limits>
Aligned evidence: <normalized observations, clocks, scope, and provenance>
Contradictions and alternatives: <retained>
Smallest remaining component question: <if any>
Owners: <evidence, component, action, validation, and stop owners or unknown>
Validation return: <objective comparable read-only evidence required>
Excluded work: <collection, remediation, mutation, restart, unsafe testing>
路由后,保留整体时间线、依赖关系图、事件影响、提供商方面的不确定性、 未解决的假设以及关闭条件。不要复述同级内容的故障排查,也不要建议设置、 修复、重写、调优步骤、重启、回滚、清理、重放、扩容/缩容或配置操作。
10. 在结束前定义验证和停止条件
为每个有明确边界的发现或影响创建一行验证记录:
| 声明 | 可比范围 | 现有证据 | 所需的只读返回信息 | 负责人 | 状态 | 停止条件 |
|---|
保持以下因素不变,或明确说明其影响:产品、版本、部署、拓扑、以中性形式标识的组件、受影响范围、时区、事件和采集时间窗口、证据来源、工作负载或数据边界、用户/角色/对象上下文,以及已知的近期变更。比较确切的故障和影响信号,不要用替代性的健康状态颜色或工单状态。
验证状态使用 verified、failed 或 unverified。一次直接观察可以确认故障当前仍在发生,但无法确认已恢复、状态稳定、未再次发生、交付完整、搜索结果完整,或业务功能已恢复。如果声明涉及是否再次发生或状态是否稳定,则必须要求多次可比的证据。如果无法安全地重复观察,则保持为 unverified。
出现以下情况时立即停止:
- 材料包未经隐私审查,或仅有原始证据;
- 产品/部署身份或时钟信息存在过多歧义,无法建立所需关联;
- 下一步的判别需要采集数据、进行变更、访问提供方的特权资源、施加不安全负载、复现故障或修复组件;
- 当前影响正在恶化,继续观察并不安全;
- 已确认某个有明确边界的组件故障,剩余工作应由专门人员处理;或
- 若不扩大授权范围,现有证据就无法区分剩余假设。
没有直接的可比证据和负责人的确认时,绝不要声称问题已修复、已恢复、状态稳定、已关闭或已成功移交。
输出约定
按以下顺序返回这些部分:
- 事件状态和影响 — 一个状态、置信度、直接影响、受影响范围、当前阶段,以及最有力且有边界的发现。
- 已提供事实、矛盾和未知项 — 保留产品、版本、部署、提供商、拓扑、变更、证据标识、责任归属,以及每个信息缺口所阻碍的事项。
- 数据包充分性 — 填写
sufficient_for_bounded_diagnosis或packet_insufficient,并指出最小的规范化证据缺口。 - 时间对齐的证据矩阵 — 观测时钟和采集时钟、来源、范围、新鲜度,以及每一行能够和不能证明的事项。
- 组件和依赖关系图 — 组件、证据层面、已记录或假设的边、直接影响,以及已知正常的对照项。
- 假设优先级清单 — 支持证据、矛盾、替代解释、假设关联、预测、最小安全判别方法、责任人、置信度和状态。
- 有边界的发现或阻碍因素 — 明确已确认的范围或具体缺失的证据;绝不提供缺乏依据的全局根因。
- 影响和责任归属矩阵 — 事件、影响、证据、组件、行动、验证和停止责任人,并保留
unknown。 - 精确移交 — 仅包括已确认的组件故障、准确的显示名称和 slug、保留的证据及其局限、预期验证反馈,以及
handoff not executed。 - 验证、停止和关闭 — 可比对的范围、当前验证状态、停止信号、重新评估条件,以及尚未确立的事项。
- 建议边界 — 说明未收集原始诊断信息、未进行搜索或运行命令、未更改配置或对象、未重启、未采取修复措施、未执行提供商操作、未进行不安全测试,也未执行移交。
在每项关键的已记录产品、版本、组件、运行状况、维护、作业字段或提供商边界声明旁,附上对应的当前 Splunk 公开文档引用。如果无法访问确切的当前页面、页面无响应、内容冲突或不匹配,则将该声明标为 unknown,缩小结论范围,不得以相邻产品、版本或通用 latest 页面替代。
结尾使用:
Closure — incident status: <state>; cause: <confirmed bounded cause|unconfirmed>; active impact: <supported impact|not established>; exact handoffs: <display name and slug|none>; validation: <verified|failed|unverified>; remaining owner/gap: <owner and smallest gap|none>; not performed: collection, mutation, remediation, unsafe testing, and handoff execution.
命令
无需运行命令。仅使用 web 查阅当前的 Splunk 公开文档。不得进行部署身份验证、执行 SPL 或 REST 调用、检查文件、收集或上传诊断信息、联系 Support、更改配置或对象、重启或重新加载服务、修复组件、重试写入、运行实时测试,或操作同级工作流。
示例
- 关联摄取中断、搜索性能下降和集群警告,但不要假设其中一种症状导致了其他症状。
- 在验证因果链之前,先对齐维护、重启、调度程序、事件、摄取、运行状况和用户观测的时钟。
- 使用未受影响的对等项、成员、路由、对象或时间窗口,证伪过于宽泛的升级或工作负载假设。
- 在诊断数据包不完整的边界处停止,并通过采集专家仅请求会改变判断的规范化字段。
- 将分别确认的摄取和集群发现移交给准确的责任人,同时保留尚未解决的全局事件影响和依赖关系。
故障排查
- 只有原始诊断信息: 不要检查这些信息。保留事件摘要,并将最小化、规范化的字段请求转交给采集专家。
- 健康状态颜色或告警指出根因: 保留观察结果及其影响;在相互印证的证据确认组件及因果关系之前,将该标签视为假设。
- 重启、回滚或提供商操作先于情况改善: 记录两个时间点和观察到的改善;原因及持久恢复仍未得到验证。
- 已确认一个组件,但其他症状仍然存在: 仅移交该范围明确的组件,并在此保留未解决的假设、影响和验证事项。
- 广泛事件期间的一次搜索开销很大: 在移交搜索性能问题之前,要求提供直接的作业证据;不要将影响整个部署的症状自动转化为查询重写。
- 不同证据面不一致: 保留各个来源和时间点,将比较标记为部分可比或不可比,并选择最小且安全的判别方法。
- 拟议的判别方法会重现负载或故障: 拒绝该方法,改用现有的只读证据,或与负责的所有者及差距一并停止。
- 后续证据看起来正常: 对比相同的组件、影响、范围、时间点和观察边界;不要将单个平静样本视为恢复或稳定。