alibabacloud-ecs-linux-troubleshooting

Name: alibabacloud-ecs-linux-troubleshooting
Author: aliyun

161stars12forks

How to install alibabacloud-ecs-linux-troubleshooting?

aliyun/alibabacloud-ecs-troubleshoot-skills/alibabacloud-ecs-linux-troubleshooting

$npx -y skills add aliyun/alibabacloud-ecs-troubleshoot-skills --skill alibabacloud-ecs-linux-troubleshooting

Installs into the current project.

Summary

Troubleshoot an Alibaba Cloud ECS Linux instance. Use when user needs to troubleshoot a problem on the specified ECS Linux instance, such as: boot stuck, SSH/VNC/Workbench, network, disk/FS, performance, crash/hang, clock, config, etc.

Files · 1

View on GitHub

SKILL.md

1	# ECS Linux 问题排查
2
3	本技能仅适用于阿里云 ECS 上的 Linux GuestOS，针对用户指定的阿里云 ECS Linux 实例（目标机）进行异常问题排查。Agent 运行在目标机或他机上，通过 aliyun CLI 工具对目标 ECS 实例进行远程诊断与数据采集。
4
5	## 何时使用本技能
6
7	- 用户指定的排查对象为阿里云 ECS Linux 实例时。
8	- 用户描述涉及启动/运行状态与 OS 不符、远程登录失败、网络不通、磁盘/扩容/挂载、性能异常、宕机夯机、时钟、配置不生效等异常问题时。
9	- 不适用：非阿里云 ECS、非 Linux GuestOS、其它云或物理机；纯管控/计费/API 侧问题且无 GuestOS 参与
10
11	## 原则与要求
12
13	1. 排查对象 = 用户指定的阿里云 ECS Linux 实例：所有检查、结论都针对这一台机器。`references/` 中的命令、路径等按实例内环境编写。
14	2. 使用 aliyun CLI 工具进行远程诊断和数据采集。：要求除 [`references/utils/guestos-pe-prep.md`](references/utils/guestos-pe-prep.md) 中步骤外其他步骤只能使用[`references/aliyun-cli-cheatsheet.md`](references/aliyun-cli-cheatsheet.md)中列出的子命令，不得调用未列出的子命令。
15	3. 先搞清问题再查：严格遵循排查流程，需要先把用户描述收敛为现象域，再按排查文档执行排查。
16	4. 优先按照`references/<slug>.md` 排查文档中描述运行排查所需命令，不要盲目自行猜测命令。
17	5. 多实例场景：每台 ECS 须分别执行排查，不要混用 A 机的结果去结论 B 机。
18
19	## 排查流程
20
21	必须按序执行
22
23	### 阶段 1：异常问题澄清
24
25	在打开任何域文档前，如果用户问题描述较模糊时先通过多轮对话细化问题，并通过 aliyun CLI 和向用户询问尽量补齐异常问题发生的证据和相关的环境信息，通常会涉及以下信息：
26
27	\| 维度 \| 要补齐的内容 \| 获取方式 \|
28	\| --- \| --- \| --- \|
29	\| 实例基本信息、状态、规格 \| 实例状态 \| 按需调用 aliyun CLI \|
30	\| 范围 \| 是否必现；起止时间；异常问题发生时是否存在变更、重启、扩缩容 \| 向用户询问 \|
31	\| 通道 \| VNC 是否可用；SSH/Workbench/云助手是否可用 \| 向用户询问 \|
32	\| 网络方向 \| 外部→实例业务端口、实例→外部网络、仅 VPC 内互通等 \| 向用户询问 \|
33	\| 表现 \| 报错原文、截图 \| 向用户询问 \|
34
35	### 阶段 2：归类到现象域
36
37	1. 打开 [`references/symptom-to-domain.md`](references/symptom-to-domain.md)，按用户澄清后的异常问题描述选现象域大类和现象域。
38	2. 输出：一个现象域，并记下现象域对应的排查文档路径 `references/<slug>.md`。同时要求用户确认现象域是否准确，准确后才进入「阶段 3」。如用户告知不准确，将将排除第 2 步中现象域后 TOP 3 的次现象域展示给用户，让用户确认是否属于这些次现象域。如用户告知不属于任何一个次现象域，则终止后续所有流程，并建议用户提交阿里云工单。
39
40	### 阶段 3：确认是否属于 GuestOS 问题
41
42	打开选定的 `references/<slug>.md` 后，按顺序完成文档开头的「确定是否属于 GuestOS 问题」章节中的步骤，要求:
43
44	1. 必须确认属于 GuestOS 问题后，再进入后续所有步骤，否则直接返回异常问题结论给用户。
45	2. 优先自行按顺序完成判定：凡是能通过 aliyun CLI 获取的数据，直接调用获取，不得在没有尝试通过 aliyun CLI 获取数据的情况下直接询问用户。仅当信息确实只能从控制台或用户侧客户端环境获取时，才向用户询问。
46	3. 没完成判定前，不要进入后续所有步骤。
47
48	### 阶段 4：诊断工具排查
49
50	在进入域内细节排查之前，先根据现象域推荐的诊断工具进行快速排查。
51
52	1. 查看 [`references/phenomenon-domain.md`](references/phenomenon-domain.md) 中当前现象域对应的「推荐的诊断集合」列，确定需要调用的诊断集合列表。若推荐列为「—」（无推荐的诊断集合），则跳过本阶段，直接进入「阶段 5」。
53	2. 首先，向用户确认是否执行推荐的诊断集合。如果用户同意，则根据第 1 步获取的诊断集合列表按顺序参考 [`references/create-diagnostic-report.md`](references/create-diagnostic-report.md) 中的步骤创建资源诊断报告执行诊断。如果用户不同意，则略过此阶段。注意：
54	1. 如果诊断集要求额外入参，优先通过 aliyun CLI 工具查询相关数据，只在无法通过 aliyun CLI 获取数据时，才要求用户提供。
55	2. 如果诊断集合不存在或创建资源诊断报告失败，则先向用户说明情况，然后略过此阶段，直接进入下一阶段。
56	4. 查看资源诊断报告详情，如果诊断报告中已经有与异常问题强相关的诊断项，直接进入「阶段 6」。否则，诊断报告输出结果应带入后续阶段，结合域内流程一起分析。
57
58	### 阶段 5：GuestOS 内问题相关组件排查
59
60	阅读 `references/<slug>.md` 的 GuestOS 内部分：
61	1. 阅读其中的相关组件列表，这是当前现象域可能涉及的 GuestOS 组件，如网卡、路由、DNS、防火墙、sshd、PAM、磁盘、内核等。
62	2. 按文档给出的问题定位步骤进行排查，排查步骤中指向组件排查文档链接`references/utils/<component-slug>.md`时，打开对应引用文档按顺序进行组件排查。要求通过 aliyun CLI 工具采集数据（需要采集当前现象域的 GuestOS 内数据时可调用 `aliyun.ecs.RunCommand`）。并且命令要尽可能详细，要尽量一次性收集本现象域所有所需数据，以减少 RunCommand 执行次数。
63	3. 不进行任何修复操作，只给出结论与修复建议。
64
65	### 阶段 6: 总结与建议
66
67	最后，根据以下两种情况给出总结与建议：
68
69	- 已定位根因：给出结构化的诊断报告，说明现象域、排查过程的证据链、结论，并给出修复或规避该问题的建议。要求：
70	1. 必须按模板[`references/diagnosis-report-template.md`](references/diagnosis-report-template.md)生成诊断报告。
71	2. 清晰可读，避免空泛。
72	3. 当存在多个根因时，需要分析他们的关系：是否由一个根因导致另一个根因，或者多个根因共同导致问题。
73	- 根因仍不确定：列出已排除的候选根因，并给出下一步排查建议。
74
75	## 流程总览
76
77	```mermaid
78	flowchart TD
79	A[阶段1 收集事实 + aliyun CLI采集元数据] --> B[阶段2 确定现象域（symptom-to-domain + phenomenon-domain）]
80	B --> C[选定 references/slug.md]
81	C --> D[阶段3 确认问题边界: GuestOS / 管控 / 客户端]
82	D -->\|非 GuestOS 主因\| E[先处理/网络/平台侧]
83	D -->\|GuestOS\| D2[阶段4 快速排查：资源诊断报告排查]
84	D2 -->\|有推荐诊断集合\| D3[调用 aliyun.ecs.CreateDiagnosticReport]
85	D2 -->\|无推荐诊断集合\| F[阶段5 域内排查: 组件排查 + 定位步骤]
86	D3 --> F
87	F --> G{需 utils / 更多数据?}
88	G -->\|是\| H[打开对应引用文档按顺序进行组件排查]
89	G -->\|否\| I[阶段6 总结与建议]
90	H --> I
91	E --> I
92	```
93
94	## 引用文档索引
95
96	\| 路径 \| 用途 \|
97	\| --- \| --- \|
98	\| [`symptom-to-domain.md`](references/symptom-to-domain.md) \| 自然语言 → 现象域路由 \|
99	\| [`phenomenon-domain.md`](references/phenomenon-domain.md) \| 权威表：唯一标识、概念、典型现象、slug、推荐的诊断工具 \|
100	\| [`aliyun-cli-cheatsheet.md`](references/aliyun-cli-cheatsheet.md) \| aliyun CLI 工具速查（白名单子命令） \|
101	\| [`create-diagnostic-report.md`](references/create-diagnostic-report.md) \| 资源诊断报告创建与解读 \|
102	\| [`references/<slug>.md`](references/) \| 各现象域完整排查流程 \|
103	\| [`references/utils/<component-slug>.md`](references/utils/) \| GuestOS 组件级排查 \|

aliyunPublisher · 18 listings

Preview

aliyun/alibabacloud-ecs-troubleshoot-skills

Repoaliyun/alibabacloud-ecs-troubleshoot-skills

LicenseApache-2.0

TypeSkills

CategoryDebugging

UpdatedJun 2026

Repo stars161

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type

alibabacloud-ecs-linux-troubleshooting

161stars12forks

View on GitHub

How to install alibabacloud-ecs-linux-troubleshooting?

aliyun/alibabacloud-ecs-troubleshoot-skills/alibabacloud-ecs-linux-troubleshooting

$npx -y skills add aliyun/alibabacloud-ecs-troubleshoot-skills --skill alibabacloud-ecs-linux-troubleshooting

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# ECS Linux 问题排查
2
3	本技能仅适用于阿里云 ECS 上的 Linux GuestOS，针对用户指定的阿里云 ECS Linux 实例（目标机）进行异常问题排查。Agent 运行在目标机或他机上，通过 aliyun CLI 工具对目标 ECS 实例进行远程诊断与数据采集。
4
5	## 何时使用本技能
6
7	- 用户指定的排查对象为阿里云 ECS Linux 实例时。
8	- 用户描述涉及启动/运行状态与 OS 不符、远程登录失败、网络不通、磁盘/扩容/挂载、性能异常、宕机夯机、时钟、配置不生效等异常问题时。
9	- 不适用：非阿里云 ECS、非 Linux GuestOS、其它云或物理机；纯管控/计费/API 侧问题且无 GuestOS 参与
10
11	## 原则与要求
12
13	1. 排查对象 = 用户指定的阿里云 ECS Linux 实例：所有检查、结论都针对这一台机器。`references/` 中的命令、路径等按实例内环境编写。
14	2. 使用 aliyun CLI 工具进行远程诊断和数据采集。：要求除 [`references/utils/guestos-pe-prep.md`](references/utils/guestos-pe-prep.md) 中步骤外其他步骤只能使用[`references/aliyun-cli-cheatsheet.md`](references/aliyun-cli-cheatsheet.md)中列出的子命令，不得调用未列出的子命令。
15	3. 先搞清问题再查：严格遵循排查流程，需要先把用户描述收敛为现象域，再按排查文档执行排查。
16	4. 优先按照`references/<slug>.md` 排查文档中描述运行排查所需命令，不要盲目自行猜测命令。
17	5. 多实例场景：每台 ECS 须分别执行排查，不要混用 A 机的结果去结论 B 机。
18
19	## 排查流程
20
21	必须按序执行
22
23	### 阶段 1：异常问题澄清
24
25	在打开任何域文档前，如果用户问题描述较模糊时先通过多轮对话细化问题，并通过 aliyun CLI 和向用户询问尽量补齐异常问题发生的证据和相关的环境信息，通常会涉及以下信息：
26
27	\| 维度 \| 要补齐的内容 \| 获取方式 \|
28	\| --- \| --- \| --- \|
29	\| 实例基本信息、状态、规格 \| 实例状态 \| 按需调用 aliyun CLI \|
30	\| 范围 \| 是否必现；起止时间；异常问题发生时是否存在变更、重启、扩缩容 \| 向用户询问 \|
31	\| 通道 \| VNC 是否可用；SSH/Workbench/云助手是否可用 \| 向用户询问 \|
32	\| 网络方向 \| 外部→实例业务端口、实例→外部网络、仅 VPC 内互通等 \| 向用户询问 \|
33	\| 表现 \| 报错原文、截图 \| 向用户询问 \|
34
35	### 阶段 2：归类到现象域
36
37	1. 打开 [`references/symptom-to-domain.md`](references/symptom-to-domain.md)，按用户澄清后的异常问题描述选现象域大类和现象域。
38	2. 输出：一个现象域，并记下现象域对应的排查文档路径 `references/<slug>.md`。同时要求用户确认现象域是否准确，准确后才进入「阶段 3」。如用户告知不准确，将将排除第 2 步中现象域后 TOP 3 的次现象域展示给用户，让用户确认是否属于这些次现象域。如用户告知不属于任何一个次现象域，则终止后续所有流程，并建议用户提交阿里云工单。
39
40	### 阶段 3：确认是否属于 GuestOS 问题
41
42	打开选定的 `references/<slug>.md` 后，按顺序完成文档开头的「确定是否属于 GuestOS 问题」章节中的步骤，要求:
43
44	1. 必须确认属于 GuestOS 问题后，再进入后续所有步骤，否则直接返回异常问题结论给用户。
45	2. 优先自行按顺序完成判定：凡是能通过 aliyun CLI 获取的数据，直接调用获取，不得在没有尝试通过 aliyun CLI 获取数据的情况下直接询问用户。仅当信息确实只能从控制台或用户侧客户端环境获取时，才向用户询问。
46	3. 没完成判定前，不要进入后续所有步骤。
47
48	### 阶段 4：诊断工具排查
49
50	在进入域内细节排查之前，先根据现象域推荐的诊断工具进行快速排查。
51
52	1. 查看 [`references/phenomenon-domain.md`](references/phenomenon-domain.md) 中当前现象域对应的「推荐的诊断集合」列，确定需要调用的诊断集合列表。若推荐列为「—」（无推荐的诊断集合），则跳过本阶段，直接进入「阶段 5」。
53	2. 首先，向用户确认是否执行推荐的诊断集合。如果用户同意，则根据第 1 步获取的诊断集合列表按顺序参考 [`references/create-diagnostic-report.md`](references/create-diagnostic-report.md) 中的步骤创建资源诊断报告执行诊断。如果用户不同意，则略过此阶段。注意：
54	1. 如果诊断集要求额外入参，优先通过 aliyun CLI 工具查询相关数据，只在无法通过 aliyun CLI 获取数据时，才要求用户提供。
55	2. 如果诊断集合不存在或创建资源诊断报告失败，则先向用户说明情况，然后略过此阶段，直接进入下一阶段。
56	4. 查看资源诊断报告详情，如果诊断报告中已经有与异常问题强相关的诊断项，直接进入「阶段 6」。否则，诊断报告输出结果应带入后续阶段，结合域内流程一起分析。
57
58	### 阶段 5：GuestOS 内问题相关组件排查
59
60	阅读 `references/<slug>.md` 的 GuestOS 内部分：
61	1. 阅读其中的相关组件列表，这是当前现象域可能涉及的 GuestOS 组件，如网卡、路由、DNS、防火墙、sshd、PAM、磁盘、内核等。
62	2. 按文档给出的问题定位步骤进行排查，排查步骤中指向组件排查文档链接`references/utils/<component-slug>.md`时，打开对应引用文档按顺序进行组件排查。要求通过 aliyun CLI 工具采集数据（需要采集当前现象域的 GuestOS 内数据时可调用 `aliyun.ecs.RunCommand`）。并且命令要尽可能详细，要尽量一次性收集本现象域所有所需数据，以减少 RunCommand 执行次数。
63	3. 不进行任何修复操作，只给出结论与修复建议。
64
65	### 阶段 6: 总结与建议
66
67	最后，根据以下两种情况给出总结与建议：
68
69	- 已定位根因：给出结构化的诊断报告，说明现象域、排查过程的证据链、结论，并给出修复或规避该问题的建议。要求：
70	1. 必须按模板[`references/diagnosis-report-template.md`](references/diagnosis-report-template.md)生成诊断报告。
71	2. 清晰可读，避免空泛。
72	3. 当存在多个根因时，需要分析他们的关系：是否由一个根因导致另一个根因，或者多个根因共同导致问题。
73	- 根因仍不确定：列出已排除的候选根因，并给出下一步排查建议。
74
75	## 流程总览
76
77	```mermaid
78	flowchart TD
79	A[阶段1 收集事实 + aliyun CLI采集元数据] --> B[阶段2 确定现象域（symptom-to-domain + phenomenon-domain）]
80	B --> C[选定 references/slug.md]
81	C --> D[阶段3 确认问题边界: GuestOS / 管控 / 客户端]
82	D -->\|非 GuestOS 主因\| E[先处理/网络/平台侧]
83	D -->\|GuestOS\| D2[阶段4 快速排查：资源诊断报告排查]
84	D2 -->\|有推荐诊断集合\| D3[调用 aliyun.ecs.CreateDiagnosticReport]
85	D2 -->\|无推荐诊断集合\| F[阶段5 域内排查: 组件排查 + 定位步骤]
86	D3 --> F
87	F --> G{需 utils / 更多数据?}
88	G -->\|是\| H[打开对应引用文档按顺序进行组件排查]
89	G -->\|否\| I[阶段6 总结与建议]
90	H --> I
91	E --> I
92	```
93
94	## 引用文档索引
95
96	\| 路径 \| 用途 \|
97	\| --- \| --- \|
98	\| [`symptom-to-domain.md`](references/symptom-to-domain.md) \| 自然语言 → 现象域路由 \|
99	\| [`phenomenon-domain.md`](references/phenomenon-domain.md) \| 权威表：唯一标识、概念、典型现象、slug、推荐的诊断工具 \|
100	\| [`aliyun-cli-cheatsheet.md`](references/aliyun-cli-cheatsheet.md) \| aliyun CLI 工具速查（白名单子命令） \|
101	\| [`create-diagnostic-report.md`](references/create-diagnostic-report.md) \| 资源诊断报告创建与解读 \|
102	\| [`references/<slug>.md`](references/) \| 各现象域完整排查流程 \|
103	\| [`references/utils/<component-slug>.md`](references/utils/) \| GuestOS 组件级排查 \|

aliyunPublisher · 18 listings

Preview

aliyun/alibabacloud-ecs-troubleshoot-skills

Repoaliyun/alibabacloud-ecs-troubleshoot-skills

LicenseApache-2.0

TypeSkills

CategoryDebugging

UpdatedJun 2026

Repo stars161

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type