> 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-cha/03-log-management.md).

# 日志管理与转发

VergeOS 日志类型、UI 内保留 45 天、上下文相关日志、远程 syslog 转发配置、SEL 管理以及 SMTP 活动报告。

## 日志在 VergeOS 运维中的作用

日志是每个 VergeOS 环境的审计追踪和诊断支柱。它们记录用户发起的操作、自动化系统事件、硬件传感器读数和复制活动——提供排查问题、满足合规要求以及了解发生了什么及何时发生所需的证据。

VergeOS 将日志分为三种不同类别，每种类别服务于不同目的并存储在不同位置。了解这些类别对于在诊断问题时知道去哪里查找，以及如何确保长期保留至关重要。

```mermaid
graph TB
    subgraph logTypes["VergeOS 日志类别"]
        direction TB
        SYS["系统日志<br/>用户和自动化活动<br/>vSAN、VM、网络事件"]
        SYNC["同步日志<br/>站点同步复制活动<br/>启动/停止、传输的数据"]
        SEL["系统事件日志 (SEL)<br/>硬件 IPMI 事件<br/>存储在 BMC 硬件上"]
    end

    subgraph retention["保留"]
        UI["UI 中：45 天"]
        HW["硬件上：容量有限"]
        EXT["外部：Syslog 转发"]
    end

    SYS --> UI
    SYNC --> UI
    SEL --> HW
    SYS --> EXT
    SEL --> EXT

    style logTypes fill:#f0f4ff,stroke:#336
    style retention fill:#f0fff4,stroke:#363
```

## 日志类型详解

### 系统日志

系统日志是 VergeOS 中的主要日志类别。它们捕获与以下内容相关的活动： **vSAN 操作、VM 生命周期事件、网络更改、用户登录、配置修改**以及其他系统相关操作。这些日志对于了解整个环境的详细操作和性能至关重要。

系统日志条目示例包括：

| 事件类型       | 示例日志条目                     |
| ---------- | -------------------------- |
| **用户身份验证** | IP 地址、用户名、登录时间戳            |
| **密码更改**   | 哪个用户从哪个环境更改了哪个密码           |
| **VM 操作**  | VM 已启动、停止、迁移，已创建快照         |
| **存储事件**   | 驱动器警告、vSAN 层级状态更改、SMART 警报 |
| **网络事件**   | 已创建网络、防火墙规则已修改、网卡状态更改      |
| **系统操作**   | 已下载更新、节点已重启、已启用维护模式        |

可从以下位置访问系统日志： **主仪表板** （位于页面底部），或选择 **日志** 从顶部菜单中。每个日志条目包括一个 **级别** （严重、错误、警告或消息）、一个 **时间戳**、一个 **来源** （例如 node1、vSAN、admin）以及一条 **消息** 描述该事件。

### 同步日志

同步日志专用于 **站点同步（复制）** 操作。它们在入站和出站同步仪表板中均可用，并为每个快照同步作业提供详细统计信息：

* **开始和停止时间** 适用于每次同步操作
* **已检查的数据量** ——评估是否发生更改的数据总量
* **已扫描的数据量** ——同步期间读取的数据
* **已发送的数据量** ——识别为需要传输的已更改数据（压缩前）
* **实际发送数据量** ——在线路上传输的实际字节数（压缩后）
* **目录和文件计数** ——同步操作的范围

同步日志对于监控复制运行状况、验证灾难恢复作业是否按计划完成，以及诊断站点间同步的带宽或性能问题极具价值。

### 系统事件日志 (SEL)

系统事件日志 (SEL) 包含来自以下位置的事件： **硬件 IPMI 接口** （智能平台管理接口）。与系统日志不同，SEL **直接存储在服务器的 BMC 硬件上**，这意味着它具有 **有限且固定的容量**。SEL 一旦存满，在清除之前便无法记录新事件。

节点仪表板显示一个 **百分比条** ，指示每个节点当前已使用的 SEL 容量。常见的 SEL 条目包括：

* 温度跨越阈值
* 风扇速度警告
* 电源事件
* 内存 ECC 错误
* 处理器热事件
* 硬件初始化事件

{% hint style="warning" %}
**SEL 容量有限**

SEL 存储在服务器的基板管理控制器 (BMC) 上，容量有限且固定。如果 SEL 完全存满，新的硬件事件将被静默丢弃。请监控每个节点仪表板上的 SEL 容量百分比，并主动清除 SEL。
{% endhint %}

## UI 内日志保留

VergeOS 在用户界面中保留系统日志的最长时间为 **45 天**。在此期限后，日志将从 UI 中自动删除。此保留期限足以满足日常故障排查和短期审计，但有合规要求（HIPAA、SOC 2、PCI-DSS 等）的组织需要配置 **远程日志转发** 以更长时间保留日志。

### 上下文特定日志

VergeOS 日志记录最实用的功能之一是 **上下文特定日志筛选**。在平台的许多区域——例如单个 VM 仪表板、网络仪表板或租户仪表板——都有一个 **日志** 按钮，仅显示与该特定对象相关的日志。

这种范围限定无需手动搜索数千条全系统日志条目。例如：

* **VM 仪表板 → 日志** 仅显示与该特定 VM 相关的事件（启动、停止、迁移、快照、错误）
* **网络仪表板 → 日志** 仅显示网络相关事件（规则更改、状态更改、连接事件）
* **租户仪表板 → 日志** 仅显示该租户范围内的事件

上下文特定日志通过将信噪比缩小到正被调查的确切对象，大幅加快故障排查。

## 远程 Syslog 转发

对于需要将日志保留超过 45 天，或需要将 VergeOS 日志集成到集中式日志管理平台（Graylog、Splunk、Elastic Stack、Datadog 等）的组织，VergeOS 支持 **远程 syslog 转发** ，通过标准 syslog 协议实现。

### 配置步骤

远程 syslog 转发通过以下位置进行配置： **高级设置** ，位于 VergeOS UI 中：

#### 步骤 1：配置远程 Syslog 服务器

1. 导航到 **系统 → 设置 → 高级设置**
2. 在 **设置** 列中，输入 `syslog` 并按 **Enter** 进行搜索
3. 选择并编辑 **远程 syslog 服务器（tcp: @@name/ip:port，udp: @name/ip:port）**
4. 使用适当的语法输入 syslog 目标：

| 协议      | 语法              | 示例                  | 备注         |
| ------- | --------------- | ------------------- | ---------- |
| **TCP** | `@@<ip>:<port>` | `@@10.10.10.10:514` | 可靠传输，建议使用  |
| **UDP** | `@<ip>:<port>`  | `@10.10.10.10:514`  | 开销较低，不保证传输 |

5. 点击 **提交** 以保存

#### 步骤 2：配置格式模板

1. 搜索 `syslog` ，然后在高级设置中再次搜索
2. 选择并编辑 **要为 syslog 服务器定义的模板（有关格式请参见 rsyslog）**
3. 输入与您的远程服务器兼容的 syslog 模板格式

对于 **Graylog** ，使用 RFC 5424 格式：

```
GRAYLOGRFC5424,"<%PRI%>1 %TIMESTAMP:::date-rfc3339% %HOSTNAME%.your-hostname-here %APP-NAME% %PROCID% %MSGID% %STRUCTURED-DATA% %msg%\n"
```

{% hint style="warning" %}
使用字面量 `1` 在 `<%PRI%>` 之后——它是 RFC 5424 版本字段。请勿使用 `%PROTOCOL-VERSION%`：它在线路上呈现为 `0` ，而严格的 RFC 5424 收集器（Promtail/Loki、Fluent Bit、现代 Graylog）会因解析错误而拒绝版本 0。
{% endhint %}

{% hint style="success" %}
**模板自定义**

将 `your-hostname-here` 替换为您的实际主机名，以便在集中式日志平台中轻松识别日志条目。该模板遵循 rsyslog 语法——请参阅 [rsyslog 文档](https://www.rsyslog.com/doc/configuration/examples.html) 了解更多格式选项。
{% endhint %}

4. 点击 **提交** 以保存

#### 步骤 3：验证转发

完成配置后，日志将开始转发到指定的 syslog 服务器。检查远程服务器的传入日志，以验证 VergeOS 条目是否已成功接收。常见验证步骤：

* 确认 VergeOS 与 syslog 服务器之间的网络连通性（端口 514 或自定义端口）
* 验证防火墙规则允许双向 syslog 流量
* 检查远程服务器的日志采集仪表板是否存在传入条目
* 生成一个测试事件（例如登录/退出 VergeOS UI），并确认它出现在远程服务器上

### Syslog 转发的先决条件

在配置远程日志转发之前，请确保以下条件：

* **网络连通性** 存在于 VergeOS 系统与远程 syslog 服务器之间
* **防火墙规则** 允许 syslog 流量（通常为 TCP 或 UDP 端口 514，或您的自定义端口）
* **访问 VergeOS 系统设置的权限** 且具有管理员权限
* 远程 syslog 服务器已配置为 **接受传入连接** ，连接来源为 VergeOS IP 范围

## SEL 管理

由于 SEL 的硬件容量有限，它需要定期维护，以确保始终可以记录新事件。

### 监控 SEL 容量

该 **节点仪表板** 显示一个百分比条，表示每个节点当前的 SEL 使用率。请定期监控此指标——尤其是可能生成更多 IPMI 事件的旧硬件。

### 清除 SEL

当 SEL 接近满容量时，请按以下步骤将其清除：

1. 导航到 **基础架构 → 节点**
2. 双击所需节点以访问 **节点仪表板**
3. 点击 **清除 SEL** ，位于左侧菜单中
4. 点击 **是** 以确认

{% hint style="success" %}
**主动 SEL 管理**

考虑制定定期清除 SEL 的计划——例如每月或每季度——以防止其达到容量上限。清除前，将 SEL 条目导出到远程 syslog 服务器，或记录任何重要事件以供存档。
{% endhint %}

### 筛选误报 SEL 条目

某些服务器硬件会生成重复或无害的 IPMI 事件，使 SEL 和系统日志变得杂乱。常见误报包括：

* 启动过程中短暂跨越阈值的传感器读数
* 计划维护窗口期间的电源事件
* 短时突发工作负载期间出现但立即恢复的温度峰值

对于持续出现的误报条目，VergeOS 支持通过 API 配置十六进制编码的 syslog 正则表达式筛选器。应用筛选器后，重启 `openipmi` 服务以激活更改。请与 VergeOS 支持团队合作，以获取有关实施针对您的硬件平台的 SEL 筛选器的指导。

## SMTP 活动报告

除了系统日志和 syslog 转发之外，VergeOS 还提供 **SMTP 投递报告** 可通过 SMTP 仪表板（在 [订阅与警报](https://docs.verge.io/learn-the-platform/zh/mo-kuai-9-jian-kong-yu-gu-zhang-pai-cha/02-alerts.md) 页面中查看）。这些报告可让您了解电子邮件投递活动：

* **邮件队列** —— 查看待处理消息、重试状态和投递失败情况
* **邮件日志** —— 具有时间戳和投递状态的所有已发送订阅邮件的审计记录
* **每日投递摘要** —— 跟踪昨天和今天的 SMTP 活动，以确认警报正在被投递

SMTP 活动报告通过提供第二验证渠道来补充日志管理——如果您预计会收到警报但没有收到，SMTP 日志可以显示该消息是已排队、已投递还是被拒绝。

## 日志管理最佳实践

### 将日志转发到外部

从第一天起就配置远程 syslog 转发。界面内 45 天的保留期对大多数合规框架来说都不够，并且会限制长期趋势分析。

### 监控 SEL 容量

定期检查每个节点仪表板上的 SEL 百分比条。在 SEL 达到容量之前清空它，以防止新的硬件事件丢失。

### 使用上下文特定日志

在排查特定 VM、网络或租户时，使用该对象仪表板上的上下文特定 Logs 按钮，过滤掉无关噪音。

### 建立保留策略

尽早明确组织的保留要求。使用 syslog 转发将日志发送到集中平台，以便长期存储、搜索和合规审计。

{% hint style="info" %}
**VMware 桥接**

来自 VMware？在 VergeOS 中，操作和审计事件都位于一个可筛选的系统日志视图中（Critical/Error/Warning/Message），并在界面内保留 45 天。远程 syslog 转发只需在系统级通过两个高级设置字段——syslog 服务器和模板——配置一次，而不是在每个主机上分别配置。
{% endhint %}

{% hint style="info" %}
**Nutanix 桥接**

来自 Nutanix？在 VergeOS 中，系统操作和审计事件都位于同一个系统日志视图中（界面内保留 45 天）；远程 syslog 转发只需在系统级配置一次。硬件事件保留在 SEL 中，并遵循相同的主动清理建议。
{% endhint %}

## 关键要点

### 三种日志类型

**系统日志** 用于操作事件， **同步日志** 用于复制活动，以及 **SEL** 用于硬件 IPMI 事件。每种日志都有不同的故障排查用途。

### UI 中保留 45 天

VergeOS 在 UI 中保留系统日志 45 天。为满足更长的保留需求和合规要求，请配置远程 syslog 转发。

### 简单的 Syslog 设置

两个高级设置字段——syslog 服务器地址和模板格式——即可为整个环境配置日志转发。TCP（`@@`）用于可靠性，UDP（`@`）用于性能。

### SEL 需要维护

硬件 SEL 的容量是固定的。监控每个节点仪表板上的百分比条，并主动清空 SEL，以防止事件丢失。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/learn-the-platform/zh/mo-kuai-9-jian-kong-yu-gu-zhang-pai-cha/03-log-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
