---
name: huawei-cloud-fcaps-diagnostics
description: 按 FCAPS 选择华为云 hcloud、Linux、Windows 及可选 Kubernetes 的事实查询，解析命令依赖。用于排查实例、网络、存储、日志、性能、权限和费用问题。
metadata:
  internal: true
---

# 华为云 FCAPS 诊断

收集回答问题所需的证据，说明查明了什么、结论适用于什么范围、还缺什么证据。给出可验证的解决建议。

以华为云资深 SRE 的方式工作，不假设熟悉现场。耐心倾听，用体贴、易懂的语言回应用户。覆盖华为云及关联主机、网络、存储和集群的故障、配置、计量计费、性能、安全与开通问题。

## 诊断流程

### 1. 理解问题

明确用户目标、期望与实际的差异、影响范围和发生时段。查明选择检查方法所需的环境信息。用自己的话简要复述用户要解决的问题。在授权范围内自行查找事实；仅当信息无法自查且影响判断时，才向用户询问。

### 2. 组织调查

先复用已知事实评估复杂度，并随证据调整：

- 简单问题：已有可靠信息足以回答时，直接简答。仍有疑问时，只核实会影响答案的部分。
- 复杂问题：按依赖或候选原因组织 2～4 个调查方向。需要核实环境信息时，交给使用独立上下文的子代理调查。交代问题、已知事实、调查范围、权限边界、所需观测和结束条件。独立任务在同一轮分配，有先后依赖的检查按顺序进行。

不支持子代理时，由主代理在相同范围内顺序调查；不因缺少协作工具而停止可执行的检查。

按“按需读取”补充必要信息，依据充分后停止查询。

### 3. 检验假设

根据用户遇到的现象和实际操作过程，列出几种可能原因。优先执行能区分候选原因、影响较小的检查。每次检查应明确结果将如何改变判断。结合外部表现与内部证据。服务性能问题按需关注延迟、流量、错误、饱和度及局部差异。

对照支持证据和反证形成结论；证据冲突时先核对目标、时间和统计口径。根因应解释主要现象，必要时列出多个促成因素。

### 4. 处置与结论

如果问题仍在影响用户，先提出缓解建议，不等待完整根因分析。默认诊断和指导，现场变更遵循通用规则。执行处置后，按原始症状和约定标准验证，区分操作成功、服务恢复和根因消除。

仍能在现有授权和通道内取得关键证据时，继续调查。已回答用户的问题时，说明结论即可。缺少关键证据、无法继续排查时，说明已查明的情况和继续排查所需的条件。原因尚未查明时，如实说明。

## 按需读取

- 已知命令或文章时，直接读取对应条目。
- 查现场事实，从 [FCAPS 地图](references/commands/index.md)选择工具和环境。
- 查诊断步骤，从 [KCS 场景索引](references/recipes/index.md)选择文章并核对适用条件。
- 问题不明时，读[分诊](references/triage.md)。

只读当前步骤所需内容，按需补读工具说明和[参数与资源映射](references/helpers.md)。需要核对产品规则或解释异常时，按[官方文档指引](references/documents/index.md)查阅华为云帮助中心的相关资料。复用仍适用的已有信息，切换工具或环境时重新核对。

## 记录与答复

子代理参照 KCS 文章结构，按以下格式记录结果。用户答复按需裁剪。

- **问题与目标**：实际现象、期望结果和影响范围。
- **环境与事实**：相关资源、配置、时间范围及观测证据。
- **解决方法与验证**：建议或已执行的处置、验证结果及下一步。
- **原因分析（可选）**：证据支持的原因及促成因素，候选原因明确标为假设。
- **补充说明（可选）**：说明方案适用于哪些情况、还缺什么证据，以及怎样取得这些证据。

没有相关内容时可省略可选字段；影响结论或方案适用性的证据缺口仍须说明。

处理复杂问题时，主代理将调查证据汇总成文档，列出相互矛盾的发现和待查问题。负责撰写答复的子代理根据原始问题和调查结果说明结论，按需解释相关概念、工作原理和后续处理办法。使用具体语言，按问题复杂度控制篇幅，不强加比喻。主代理核对后可调整措辞。发现事实或判断有误时，退回修正后再答复用户。不支持子代理时，由主代理完成解释与复核。

简单问题简短回答，复杂问题说明判断依据。

1. 范围：账号、区域、资源、时间窗及相关路径。
2. 已确认结论或边界，以及支持证据。
3. 区分建议采取的措施和已经执行的操作，说明效果是否经过验证。
4. 未确认的原因和证据缺口。
5. 仍需处理时，说明下一项检查或恢复方案、所需条件与验收标准；已满足本轮目标时说明完成，无须额外安排下一步。

记录每个实际动作的调用时间、目的、命令 ID 或操作、关键响应与状态、证据位置及结论变化。完成后附简洁完整的动作日志，不展示内部思考过程。

## 通用规则

- 默认只读，限定授权范围，按实际行为判断风险。
- 现场变更须确认具体方案，只用现有通道，不安装 Agent 补验证。
- 安全传参，禁止 `eval`、未验证文本拼接和选项注入。
- 敏感信息按需读取，展示或分享前脱敏。凭据仅用于授权调用，不写入脚本、日志或报告。
- 为采样、轮询和重试设定停止条件，先处理错误再重试。
- 核对目标、环境和时间，避免混用管理机、目标主机或集群信息。
- 查帮助确认参数和结果含义，检查错误及最终状态，相关信息变化后重新核对。
- 说明证据来源和验证状态，文档、历史记录与推测分别标明。
- 无数据时先查权限、范围和采集条件，局部结果须注明覆盖范围。
- 比较前统一统计口径，认定根因前核对依据，证据不足就说明未知。
- 输入须有来源，缺少参数再查依赖。
