> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/diagnostics.md).

# 系统诊断

该 *系统诊断* 此功能可快速且轻松地将大量系统信息收集到一个压缩文件中，捕获某一时点的系统详情集合，包括：未经过滤的日志、配置信息、网络和状态数据，以及其他有助于分析和故障排查的指标。虽然这些信息通常在 VergeOS UI 中更容易获取，但生成系统诊断文件可以方便地收集所有信息，并直接发送给 VergeIO 支持以供专业分析。

## 何时运行系统诊断

在与支持团队协作处理问题时，您可能会被要求运行系统诊断，以便轻松收集全面信息，协助故障排查。系统诊断文件也可作为实施重大系统变更前的基线；修改后还可以触发另一个文件进行比较。

{% hint style="warning" %}
**影响注意事项**

* 触发系统诊断可能会影响性能，因为它会探测硬件并从每个节点收集大量信息。
* 一旦触发，系统诊断构建无法取消。
  {% endhint %}

## 生成系统诊断文件

1. 导航到 **系统** > **系统诊断**
2. 单击 **构建** 左侧菜单中的。
3. 提供一个 **名称** 和 **描述** 用于诊断构建。如果名称留空，系统将自动生成以下格式的名称：\[SYSTEMNAME]\_*diags*\_\[yyyymmdd\_hhmmss]，例如 Verge-Det\_diags\_20241113\_121503

{% hint style="success" %}
**名称/描述**

* 在直接发送给 VergeIO 支持之前，请始终输入一个说明性的名称/描述。
* 有标识性的名称和描述有助于轻松区分同一系统上的不同诊断实例。
* 系统诊断生成完成后，这些字段也可以编辑。
  {% endhint %}

4. 如果正在与支持团队协作且系统具备互联网连接，您可以勾选以 ***将诊断信息发送至 Verge.io 支持***。该选项在文件生成完成后也可通过以下方式使用： *编辑* 选项。

{% hint style="info" %}
**直接发送至 VergeIO 支持**

* 从 UI 直接发送至 Verge.io 的系统诊断信息在传输过程中会加密。
* 该 *状态* 字段将指示报告何时直接发送给支持团队。
  {% endhint %}

5. 单击 **提交** 以生成文件。信息将从系统中所有在线节点检索。根据节点数量和日志大小，此构建可能需要几分钟到十几分钟甚至更久。在构建过程中， **状态** 列将指示当前正在处理的节点，并将显示 **完成** 诊断文件成功生成时。

## 下载

对于空气隔离系统或其他无法连接互联网的系统：文件生成完成后，选择诊断文件并点击 *下载*。与您的支持联系人协调，以将文件交付进行分析。

{% hint style="warning" %}
**虽然系统诊断文件绝不会包含用户数据，但其中会包含诸如 IP 地址、网络详情、租户和 VM 名称等潜在敏感信息。下载和传输系统诊断文件时请务必小心，确保只有授权人员可以访问。**
{% endhint %}

## 文件常规信息

### 布局

* 文件的顶层按主机节点组织。
* 控制器节点（通常为节点 1）文件夹包含比其他节点文件夹更详细的信息。

### 内容

* **租户节点日志** - 来自每个租户节点的系统日志
* **VergeOS 配置信息** - VergeOS 网络和 vSAN 规格、版本以及其他配置设置
* **SMART 报告** - 每个物理驱动器的 S.M.A.R.T. 诊断报告
* **vNet 日志** - 容器日志（DMZ、核心、外部、维护、租户网络）
* **网络报告** - 标准网络工具输出
* **vSAN 诊断** - vSAN 命令输出
* **块设备列表** - 有关块设备的结构和描述信息（存储的逻辑视图）
* **内核日志** - 通常为空，但在系统崩溃或硬件故障时可能包含条目
* **完整系统日志** - 完整的当前系统日志，以及来自先前节点电源循环的最多 3 个归档系统日志
* **操作系统级诊断** - 标准 Linux 诊断命令输出
* **系统统计信息** - 由 Linux sysstat 生成的一组性能监控报告
* **低级操作系统信息** - 有关系统资源、硬件和活动进程的信息


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/zh/xi-tong-guan-li/diagnostics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.