> 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/learn-the-platform/zh/mo-kuai-9-jian-kong-yu-gu-zhang-pai-chu/02-alerts.md).

# 订阅与告警

## 通过订阅进行主动监控

仪表板和日志是被动的——只有在你查看时才会发现问题。 **订阅** 通过在条件变化时或按固定计划发送电子邮件通知，使 VergeOS 监控变得主动。每个 VergeOS 环境都应从一开始就配置一套核心订阅，以便管理员能在终端用户之前获知问题。

订阅需要正常工作的 **SMTP 配置** （本页后面会介绍）。一旦 SMTP 配置就绪，任何仪表板、层、网络、VM、租户或其他 VergeOS 对象都可以附加一个或多个订阅。

```mermaid
graph LR
    subgraph triggers["订阅引擎"]
        direction TB
        OD["按需<br/>(事件 / 阈值)"]
        SC["定时<br/>(定时报告)"]
    end

    subgraph delivery["投递"]
        SMTP["SMTP 服务器"]
        QUEUE["邮件队列"]
        INBOX["管理员收件箱"]
    end

    OD -->|超过阈值| SMTP
    SC -->|间隔到期| SMTP
    SMTP --> QUEUE --> INBOX

    style triggers fill:#f0f4ff,stroke:#336
    style delivery fill:#f0fff4,stroke:#363
```

## 订阅类型

VergeOS 提供两种互补的订阅类型。一个有效监控的环境会同时使用 **计算和存储** 这两种类型——按需订阅用于立即了解问题，定时订阅用于跟踪趋势和日常监督。

### 按需订阅

按需订阅是 **由事件驱动或由阈值触发的** 告警。它们会在条件满足后立即触发，确保管理员几乎能实时收到潜在问题通知。

按需订阅的常见触发条件包括：

| 触发类别        | 示例                   |
| ----------- | -------------------- |
| **存储阈值**    | vSAN 层达到指定的容量使用百分比   |
| **有可用更新**   | 新的 VergeOS 更新包已准备好安装 |
| **错误 / 警告** | 任何错误或警告事件都会记录到受监控对象上 |
| **状态变化**    | 某个节点离线、VM 意外停止、网络故障  |

按需订阅是第一道防线——它们告诉你有问题需要 **立即**.

### 定时订阅

定时订阅会在 **配置好的时间间隔发送仪表板或列表信息**。它们旨在提供系统健康状况的定期摘要，并帮助管理员进行日常监督和趋势跟踪。

定时订阅示例：

* **系统仪表板** 每天上午 7:00 发送——为团队提供晨间健康概览
* **vSAN 层仪表板** 每周发送——跟踪容量增长趋势
* **VM 列表** 每周发送——审查正在运行的工作负载清单
* **租户仪表板** 每天发送——监控租户资源消耗

{% hint style="success" %}
**高效监控**

一个监控良好的 VergeOS 环境会有 **多个按需和定时订阅** 已配置。按需订阅捕获突发事件；定时订阅揭示缓慢演变的趋势，例如容量逐步消耗。
{% endhint %}

## 创建订阅

订阅在 **System > Subscriptions** 中进行管理。在 VergeOS UI 中。创建流程会引导你完成以下字段：

### 分步配置

1. 导航至 **System > Subscriptions** 来自 Cloud Dashboard
2. 选择 **新建** 左侧菜单中的
3. 配置订阅字段：

| 字段         | 说明                                                          |
| ---------- | ----------------------------------------------------------- |
| **名称**     | 订阅的唯一标签（用于列表视图和电子邮件主题行）                                     |
| **所有者类型**  | **用户** （单个收件人）或 **组** （收件人团队）                               |
| **所有者**    | 从下拉菜单中选择具体用户或组                                              |
| **目标类型**   | 要监控的 VergeOS 对象类别（例如：集群、vSAN 层、网络、VM、租户、系统）                 |
| **目标**     | 该对象类型的具体实例（例如：“Tier 1 - SSD”、“Production Network”、“Node 1”） |
| **类型**     | **按需** （触发）或 **计划** （定时）                                    |
| **订阅配置文件** | 必填——定义报告/告警内容；对于按需订阅，还定义比较逻辑；显示的选项会按 **目标类型**               |
| **挂起**     | 可选择将通知暂停到某个日期/时间，或无限期暂停（在维护窗口期间很有用）                         |

### 按需设置

当订阅类型设置为 **按需**时，会显示其他字段：

| 字段         | 说明                                                                                                    |
| ---------- | ----------------------------------------------------------------------------------------------------- |
| **订阅配置文件** | 必填模板，既编码要监控的内容（`onchange_fields`）也编码其比较方式（`new`, `gt0`, `gt`, `anyval`，或 `different`）——可用配置文件会按目标类型筛选 |
| **节流**     | 同一条件重复告警之间的最少分钟数——防止收件箱被淹没（最多 60 分钟）                                                                  |
| **提醒间隔**   | 在条件持续存在时重新发送告警的频率（例如，每 4 小时）                                                                          |

该 **节流** 设置对于噪声较大的环境至关重要。如果没有它，一个反复抖动的条件（例如，温度传感器在阈值附近来回波动）可能会生成数百封邮件。节流上限为 **60 分钟** （字段最大值）；对于大多数告警，请选择 15 到 60 分钟之间的值；如果你想要系统允许的最长间隔，就使用 60。

该 **提醒间隔** 确保持续性问题不会被遗忘。如果某个 vSAN 层已达到 90% 容量且无人处理初始告警，提醒会在配置的间隔内重复通知，直到条件恢复。

### 定时设置

当订阅类型设置为 **计划**时，你配置投递时间：

| 字段     | 说明                |
| ------ | ----------------- |
| **频率** | 报告发送的频率（例如，每日、每周） |
| **时间** | 报告生成并投递的当天时间      |
| **日期** | 对于每周计划，是星期几       |

## 订阅配置文件和目标定位

VergeOS 订阅在目标定位上很灵活——你几乎可以针对系统中的任何对象创建订阅：

### 系统级

监控整体系统仪表板、集群健康状况或整个环境中的更新可用性。

### 存储级

跟踪单个 vSAN 层的容量阈值、磁盘错误或冗余降级状态。

### 网络级

针对特定内部或外部网络上的网络故障、连接变化或流量异常发出告警。

### 工作负载级

监控单个 VM 或租户环境的状态变化、资源耗尽或错误事件。

这种细粒度定位意味着你可以构建一个符合运营模型的订阅策略——为基础设施团队提供广泛的系统级告警，为应用所有者或 MSP 客户提供特定的 VM 或租户告警。

## 常见告警配置

以下订阅配置代表了大多数 VergeOS 部署的最佳实践。可将其视为一个 **起始模板** 并根据你的环境进行自定义。

### 存储容量告警

| 设置         | 值                                             |
| ---------- | --------------------------------------------- |
| **目标类型**   | vSAN 层                                        |
| **目标**     | 每个层单独监控（Tier 1、Tier 2 等）                      |
| **类型**     | 按需                                            |
| **订阅配置文件** | 一个 vSAN 层容量配置文件（例如，“Tier Used %”），将使用量与阈值进行比较 |
| **节流**     | 60 分钟                                         |
| **提醒**     | 4 小时                                          |

在多个阈值上创建单独的订阅（80% 警告、90% 严重），以提供逐级升级的紧迫感。

### 节点离线检测

| 设置         | 值                                |
| ---------- | -------------------------------- |
| **目标类型**   | 节点                               |
| **目标**     | 每个节点单独监控                         |
| **类型**     | 按需                               |
| **订阅配置文件** | 一个节点状态配置文件，用于检测从 Running 状态退出的情况 |
| **节流**     | 15 分钟                            |
| **提醒**     | 1 小时                             |

### vSAN 降级状态

| 设置         | 值                              |
| ---------- | ------------------------------ |
| **目标类型**   | vSAN 层                         |
| **目标**     | 每个层单独监控                        |
| **类型**     | 按需                             |
| **订阅配置文件** | 一个 vSAN 层健康配置文件，会在错误或警告事件发生时触发 |
| **节流**     | 30 分钟                          |
| **提醒**     | 2 小时                           |

### 更新可用性

| 设置         | 值                      |
| ---------- | ---------------------- |
| **目标类型**   | 系统                     |
| **类型**     | 按需                     |
| **订阅配置文件** | 一个更新可用性配置文件，用于检测新的可安装包 |
| **节流**     | 60 分钟（最大值）             |
| **提醒**     | 7 天                    |

### 每日系统健康报告

| 设置       | 值       |
| -------- | ------- |
| **目标类型** | 系统仪表板   |
| **类型**   | 计划      |
| **频率**   | 每日      |
| **时间**   | 上午 7:00 |

## SMTP 配置前提条件

订阅完全依赖电子邮件投递。在任何订阅能够发送通知之前， **必须配置 SMTP** 在 **System > SMTP** 在 VergeOS 界面中访问。

VergeOS 提供内置邮件服务器，可 **直接** 发送电子邮件，或通过 **SMTP 中继** 服务路由发送。

### SMTP 设置

导航至 **System > SMTP > Edit Settings** 并配置以下内容：

| 设置             | 说明                                                  |
| -------------- | --------------------------------------------------- |
| **使用 TLS**     | 启用/禁用 TLS 加密——当中继或接收服务器支持时始终启用                      |
| **主机名**        | 发送服务器的 FQDN——必须在 DNS 中正确解析，并具备合适的 SPF、DMARC 和反向 DNS |
| **发件人名称**      | 显示在电子邮件中的名称（例如，“VergeOS Alerts”）                    |
| **发件人地址**      | 所有订阅邮件的发件邮箱地址                                       |
| **中继主机**       | 外部 SMTP 中继服务器的地址（如直接发送则留空）                          |
| **中继端口**       | 中继的 TCP 端口——25（未加密）、587（TLS/STARTTLS）或 465（旧式 SSL）  |
| **使用 SASL 认证** | 当中继需要身份验证时启用——会显示下面的用户名和密码字段                        |
| **用户名**        | 用于中继认证的 SASL 用户名（启用 SASL 认证时显示）                     |
| **密码**         | 用于中继认证的 SASL 密码（启用 SASL 认证时显示）                      |

### 直接发送 vs. 中继

| 方法          | 优点                 | 缺点                                     |
| ----------- | ------------------ | -------------------------------------- |
| **直接发送**    | 无需外部依赖，投递立即        | 需要正确的 DNS/SPF/DMARC/rDNS，可能会被垃圾邮件过滤器拦截 |
| **SMTP 中继** | 更好的投递率，更简单的 DNS 要求 | 依赖外部服务，可能有速率限制                         |

{% hint style="success" %}
**实用建议**

许多客户会选择商业 SMTP 中继服务（例如 SendGrid、Amazon SES 或内部 Exchange 中继），因为它简化了 DNS 配置、提高了投递率，并避免了垃圾邮件过滤问题。中继提供商会为你的 SMTP 配置提供正确的主机、端口和凭据。
{% endhint %}

### DNS 和投递要求

当使用 **直接发送** （无中继）时，必须正确配置以下 DNS 记录，以避免电子邮件被拒收或标记为垃圾邮件：

* **SPF 记录** ——授权 VergeOS 服务器 IP 为配置的域发送电子邮件
* **DMARC 记录** ——定义域的电子邮件认证策略
* **反向 DNS（PTR）** ——发送 IP 必须具有与配置主机名匹配的 PTR 记录
* **MX 记录** ——虽然发送时不是必需的，但正确的 MX 配置有助于建立域名可信度

### SMTP 仪表板和监控

该 **SMTP 仪表板** （System > SMTP）提供电子邮件投递的运行可见性：

* **邮件队列** ——查看待处理消息、重试状态和投递失败
* **邮件日志** ——带时间戳和投递状态的所有已发送消息审计轨迹
* **测试邮件** ——在将其用于生产告警之前，发送测试消息以验证配置

始终发送一封 **测试邮件** 在配置 SMTP 之后、创建订阅之前。这样可验证端到端投递，包括 DNS 解析、TLS 协商、中继认证和收件箱投递。

## 订阅管理

### 查看和编辑订阅

所有已配置的订阅列在 **System > Subscriptions**。从此视图你可以：

* 查看每个订阅的所有者、目标、类型和状态
* 编辑现有订阅以调整阈值、节流间隔或收件人
* 删除不再需要的订阅
* 快速识别哪些对象有告警覆盖，哪些没有

### 多租户注意事项

在多租户环境中，订阅可以 **在每个租户级别独立配置**。这意味着：

* 该 **服务提供商** 在主机环境中配置系统级订阅
* 每个 **租户管理员** 可以在其租户范围内配置自己的订阅
* 租户订阅只能看到其自身资源——无法查看或对主机级对象发出告警

这种隔离确保 MSP 客户可以自行管理自己的告警，而无需提供商介入。

{% hint style="info" %}
**来自 VMware 或 Nutanix？**

在 VergeOS 中，单个 **订阅** 将条件（通过其订阅配置文件）、路由（所有者 + SMTP）以及任何定时仪表板报告统一到一个对象中——因此你可以针对同一目标将这三者一起配置，而不是拼接多个独立构件。
{% endhint %}

## 要点总结

### 两种订阅类型

**按需** 用于即时事件/阈值告警，以及 **计划** 用于周期性仪表板报告。两者结合使用可实现完整覆盖。

### 先配置 SMTP

在创建任何订阅之前，先配置并测试 SMTP 投递。直接发送或中继——两者都可行，但中继通常更容易维护。

### 节流并提醒

使用节流设置防止告警风暴，并使用提醒间隔确保持续性问题不会被遗忘。

### 目标可任意选择

订阅可以针对任何 VergeOS 对象——系统、集群、层、网络、VM 和租户——以获得最大的监控灵活性。


---

# 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/learn-the-platform/zh/mo-kuai-9-jian-kong-yu-gu-zhang-pai-chu/02-alerts.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.