> 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/vi/module-9-giam-sat-and-khac-phuc-su-co/03-log-management.md).

# Quản lý nhật ký & Chuyển tiếp

## Vai trò của nhật ký trong vận hành VergeOS

Nhật ký là dấu vết kiểm toán và xương sống chẩn đoán của mọi môi trường VergeOS. Chúng ghi lại các hành động do người dùng khởi tạo, các sự kiện hệ thống tự động, số liệu cảm biến phần cứng và hoạt động sao chép -- cung cấp bằng chứng bạn cần để khắc phục sự cố, đáp ứng các yêu cầu tuân thủ, và hiểu điều gì đã xảy ra và khi nào.

VergeOS tổ chức nhật ký thành ba nhóm riêng biệt, mỗi nhóm phục vụ một mục đích khác nhau và được lưu ở một vị trí khác nhau. Hiểu các nhóm này là điều thiết yếu để biết nên xem ở đâu khi chẩn đoán sự cố và cách đảm bảo lưu giữ lâu dài.

```mermaid
graph TB
    subgraph logTypes["Danh mục nhật ký VergeOS"]
        direction TB
        SYS["Nhật ký hệ thống<br/>Hoạt động của người dùng & tự động<br/>Sự kiện vSAN, VM, mạng"]
        SYNC["Nhật ký đồng bộ<br/>Hoạt động sao chép đồng bộ site<br/>Khởi động/dừng, dữ liệu đã truyền"]
        SEL["Nhật ký sự kiện hệ thống (SEL)<br/>Sự kiện IPMI phần cứng<br/>Được lưu trên phần cứng BMC"]
    end

    subgraph retention["Lưu giữ"]
        UI["Trong giao diện: 45 ngày"]
        HW["Trên phần cứng: Dung lượng hạn chế"]
        EXT["Bên ngoài: Chuyển tiếp Syslog"]
    end

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

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

## Chi tiết về các loại nhật ký

### Nhật ký hệ thống

Nhật ký hệ thống là nhóm nhật ký chính trong VergeOS. Chúng ghi lại các hoạt động liên quan đến **các thao tác vSAN, sự kiện vòng đời VM, thay đổi mạng, đăng nhập người dùng, sửa đổi cấu hình**và các hoạt động khác liên quan đến hệ thống. Các nhật ký này rất cần thiết để hiểu chi tiết hoạt động và hiệu năng của toàn bộ môi trường.

Ví dụ về các mục nhật ký hệ thống bao gồm:

| Loại sự kiện            | Mục nhật ký ví dụ                                                            |
| ----------------------- | ---------------------------------------------------------------------------- |
| **Xác thực người dùng** | Địa chỉ IP, tên người dùng, thời điểm đăng nhập                              |
| **Thay đổi mật khẩu**   | Người dùng nào đã thay đổi mật khẩu nào, từ môi trường nào                   |
| **Thao tác VM**         | VM đã khởi động, dừng, di chuyển, tạo snapshot                               |
| **Sự kiện lưu trữ**     | Cảnh báo ổ đĩa, thay đổi trạng thái tầng vSAN, cảnh báo SMART                |
| **Sự kiện mạng**        | Mạng đã được tạo, quy tắc tường lửa đã được sửa đổi, thay đổi trạng thái NIC |
| **Thao tác hệ thống**   | Bản cập nhật đã tải xuống, node đã khởi động lại, chế độ bảo trì đã được bật |

Nhật ký hệ thống có thể truy cập từ **Bảng điều khiển chính** (ở cuối trang) hoặc bằng cách chọn **Nhật ký** từ menu trên cùng. Mỗi mục nhật ký bao gồm một **mức** (Critical, Error, Warning, hoặc Message), một **dấu thời gian**, một **source** (ví dụ: node1, vSAN, admin), và một **thông điệp** mô tả sự kiện.

### Nhật ký đồng bộ

Nhật ký đồng bộ dành riêng cho các thao tác **đồng bộ site (sao chép)** . Chúng có sẵn trên cả bảng điều khiển đồng bộ đến và đồng bộ đi, đồng thời cung cấp thống kê chi tiết cho từng tác vụ đồng bộ snapshot:

* **Thời gian bắt đầu và kết thúc** cho mỗi thao tác đồng bộ
* **Lượng dữ liệu đã kiểm tra** -- tổng dữ liệu được đánh giá để tìm thay đổi
* **Lượng dữ liệu đã quét** -- dữ liệu được đọc trong quá trình đồng bộ
* **Lượng dữ liệu đã gửi** -- dữ liệu đã thay đổi được xác định là cần truyền (trước nén)
* **Dữ liệu ròng đã gửi** -- số byte thực tế trên đường truyền (sau nén)
* **Số lượng thư mục và tệp** -- phạm vi của thao tác đồng bộ

Nhật ký đồng bộ rất quý giá để theo dõi tình trạng sao chép, xác minh rằng các tác vụ khôi phục sau thảm họa đang hoàn thành đúng lịch, và chẩn đoán các vấn đề về băng thông hoặc hiệu năng với đồng bộ giữa các site.

### Nhật ký sự kiện hệ thống (SEL)

Nhật ký sự kiện hệ thống (SEL) chứa các sự kiện từ **giao diện IPMI phần cứng** (Intelligent Platform Management Interface). Không giống như nhật ký hệ thống, SEL **được lưu trực tiếp trên phần cứng BMC của máy chủ**, tức là nó có **dung lượng cố định và hạn chế**. Khi SEL đầy, các sự kiện mới sẽ không thể được ghi lại cho đến khi nó được xóa.

Bảng điều khiển node hiển thị một **thanh phần trăm** cho biết hiện tại mỗi node đang dùng bao nhiêu dung lượng SEL. Các mục SEL thường gặp bao gồm:

* Vượt ngưỡng nhiệt độ
* Cảnh báo tốc độ quạt
* Sự kiện nguồn điện
* Lỗi ECC của bộ nhớ
* Sự kiện nhiệt của bộ xử lý
* Sự kiện khởi tạo phần cứng

{% hint style="warning" %}
**Dung lượng SEL là có hạn**

SEL được lưu trên Bộ điều khiển Quản lý Bo mạch chủ (BMC) của máy chủ và có dung lượng cố định, hạn chế. Nếu SEL đầy hoàn toàn, các sự kiện phần cứng mới sẽ bị bỏ qua một cách âm thầm. Hãy theo dõi phần trăm dung lượng SEL trên bảng điều khiển của từng node và chủ động xóa SEL.
{% endhint %}

## Lưu giữ nhật ký trong giao diện

VergeOS lưu giữ nhật ký hệ thống trong giao diện người dùng tối đa **45 ngày**. Sau khoảng thời gian này, nhật ký sẽ tự động bị xóa khỏi giao diện. Khoảng lưu giữ này đủ cho việc khắc phục sự cố hằng ngày và kiểm tra ngắn hạn, nhưng các tổ chức có yêu cầu tuân thủ (HIPAA, SOC 2, PCI-DSS, v.v.) sẽ cần cấu hình **chuyển tiếp nhật ký từ xa** để lưu giữ nhật ký trong thời gian dài hơn.

### Nhật ký theo ngữ cảnh

Một trong những tính năng thực tế nhất của ghi nhật ký trong VergeOS là **lọc nhật ký theo ngữ cảnh**. Ở nhiều khu vực của nền tảng -- như bảng điều khiển của một VM riêng lẻ, bảng điều khiển mạng, hoặc bảng điều khiển tenant -- có một **Nhật ký** nút chỉ hiển thị các nhật ký liên quan đến đối tượng cụ thể đó.

Phạm vi này giúp loại bỏ nhu cầu phải tự tìm kiếm trong hàng nghìn mục nhật ký toàn hệ thống. Ví dụ:

* **Bảng điều khiển VM → Nhật ký** chỉ hiển thị các sự kiện liên quan đến VM cụ thể đó (khởi động, dừng, di chuyển, snapshot, lỗi)
* **Bảng điều khiển mạng → Nhật ký** chỉ hiển thị các sự kiện liên quan đến mạng (thay đổi quy tắc, thay đổi trạng thái, sự kiện kết nối)
* **Bảng điều khiển tenant → Nhật ký** chỉ hiển thị các sự kiện trong phạm vi tenant đó

Nhật ký theo ngữ cảnh giúp tăng tốc đáng kể việc khắc phục sự cố bằng cách thu hẹp tỷ lệ tín hiệu trên nhiễu xuống đúng đối tượng đang được điều tra.

## Chuyển tiếp Syslog từ xa

Đối với các tổ chức cần lưu giữ nhật ký lâu hơn 45 ngày hoặc cần tích hợp nhật ký VergeOS vào một nền tảng quản lý nhật ký tập trung (Graylog, Splunk, Elastic Stack, Datadog, v.v.), VergeOS hỗ trợ **chuyển tiếp syslog từ xa** thông qua các giao thức syslog chuẩn.

### Các bước cấu hình

Chuyển tiếp syslog từ xa được cấu hình thông qua **Cài đặt nâng cao** trong giao diện VergeOS:

#### Bước 1: Cấu hình máy chủ Syslog từ xa

1. Đi tới **Hệ thống → Cài đặt → Cài đặt nâng cao**
2. Trong **Cài đặt** cột, gõ `syslog` và nhấn **Nhập** để tìm kiếm
3. Chọn và chỉnh sửa **Máy chủ syslog từ xa (tcp: @@name/ip:port, udp: @name/ip:port)**
4. Nhập đích syslog bằng cú pháp phù hợp:

| Giao thức | Cú pháp         | Ví dụ               | Ghi chú                                  |
| --------- | --------------- | ------------------- | ---------------------------------------- |
| **TCP**   | `@@<ip>:<port>` | `@@10.10.10.10:514` | Gửi tin cậy, được khuyến nghị            |
| **UDP**   | `@<ip>:<port>`  | `@10.10.10.10:514`  | Ít tải hơn, không đảm bảo gửi thành công |

5. Nhấp **Gửi** để lưu

#### Bước 2: Cấu hình mẫu định dạng

1. Tìm `syslog` một lần nữa trong Cài đặt nâng cao
2. Chọn và chỉnh sửa **Mẫu để định nghĩa cho máy chủ syslog (Xem rsyslog để biết định dạng)**
3. Nhập định dạng mẫu syslog tương thích với máy chủ từ xa của bạn

Đối với **Graylog** bằng định dạng RFC 5424:

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

{% hint style="success" %}
**Tùy chỉnh mẫu**

Thay thế `your-hostname-here` bằng tên máy chủ thực tế của bạn để các mục nhật ký dễ nhận diện trong nền tảng nhật ký tập trung. Mẫu này tuân theo cú pháp rsyslog -- hãy tham khảo [tài liệu rsyslog](https://www.rsyslog.com/doc/master/configuration/examples.html) để biết thêm các tùy chọn định dạng.
{% endhint %}

4. Nhấp **Gửi** để lưu

#### Bước 3: Xác minh việc chuyển tiếp

Sau khi hoàn tất cấu hình, nhật ký sẽ bắt đầu được chuyển tiếp đến máy chủ syslog đã chỉ định. Hãy kiểm tra nhật ký đến trên máy chủ từ xa để xác minh rằng các mục từ VergeOS đang được nhận thành công. Các bước xác minh phổ biến:

* Xác nhận kết nối mạng giữa VergeOS và máy chủ syslog (cổng 514 hoặc cổng tùy chỉnh)
* Xác minh các quy tắc tường lửa cho phép lưu lượng syslog theo cả hai chiều
* Kiểm tra bảng điều khiển tiếp nhận nhật ký trên máy chủ từ xa để xem các mục đến
* Tạo một sự kiện thử nghiệm (ví dụ: đăng nhập/đăng xuất giao diện VergeOS) và xác nhận nó xuất hiện trên máy chủ từ xa

### Điều kiện tiên quyết cho chuyển tiếp Syslog

Trước khi cấu hình chuyển tiếp nhật ký từ xa, hãy đảm bảo những điều sau:

* **Kết nối mạng** giữa hệ thống VergeOS và máy chủ syslog từ xa
* **Quy tắc tường lửa** cho phép lưu lượng syslog (thường là cổng TCP hoặc UDP 514, hoặc cổng tùy chỉnh của bạn)
* **Quyền truy cập vào Cài đặt hệ thống VergeOS** với quyền quản trị
* Máy chủ syslog từ xa được cấu hình để **chấp nhận các kết nối đến** từ dải IP của VergeOS

## Quản lý SEL

Vì SEL có dung lượng phần cứng hạn chế, nó cần được bảo trì định kỳ để đảm bảo các sự kiện mới luôn có thể được ghi lại.

### Theo dõi dung lượng SEL

Tính năng **bảng điều khiển node** hiển thị một thanh phần trăm cho biết mức sử dụng SEL hiện tại của từng node. Hãy theo dõi chỉ báo này thường xuyên -- đặc biệt trên phần cứng cũ có thể tạo ra nhiều sự kiện IPMI hơn.

### Xóa SEL

Khi SEL gần đầy dung lượng, hãy xóa nó theo quy trình sau:

1. Đi tới **Hạ tầng → Nút**
2. Nhấp đúp vào node mong muốn để truy cập **Bảng điều khiển Node**
3. Nhấp **Xóa SEL** trong menu bên trái
4. Nhấp **Có** để xác nhận

{% hint style="success" %}
**Quản lý SEL chủ động**

Hãy cân nhắc thiết lập lịch định kỳ để xóa SEL -- ví dụ hàng tháng hoặc hàng quý -- để ngăn nó đạt ngưỡng dung lượng. Trước khi xóa, hãy xuất các mục SEL lên máy chủ syslog từ xa hoặc ghi lại bất kỳ sự kiện quan trọng nào cho hồ sơ của bạn.
{% endhint %}

### Lọc các mục SEL dương tính giả

Một số phần cứng máy chủ tạo ra các sự kiện IPMI lặp lại hoặc vô hại, làm rối SEL và nhật ký hệ thống. Các dương tính giả phổ biến bao gồm:

* Các giá trị cảm biến vượt ngưỡng trong thời gian ngắn أثناء trình khởi động
* Sự kiện nguồn điện trong các khoảng bảo trì đã lên kế hoạch
* Các đột biến nhiệt độ trong các khối tải ngắn hạn được tự phục hồi ngay lập tức

Đối với các mục dương tính giả kéo dài, VergeOS hỗ trợ lọc thông qua bộ lọc regex syslog mã hóa hex được cấu hình qua API. Sau khi áp dụng bộ lọc, hãy khởi động lại `openipmi` dịch vụ để kích hoạt thay đổi. Hãy làm việc với bộ phận hỗ trợ VergeOS để được hướng dẫn triển khai các bộ lọc SEL dành riêng cho nền tảng phần cứng của bạn.

## Báo cáo hoạt động SMTP

Ngoài nhật ký hệ thống và chuyển tiếp syslog, VergeOS còn cung cấp **báo cáo gửi SMTP** thông qua Bảng điều khiển SMTP (được đề cập trong trang [Đăng ký & Cảnh báo](/learn-the-platform/vi/module-9-giam-sat-and-khac-phuc-su-co/02-alerts.md) ). Các báo cáo này cung cấp khả năng quan sát hoạt động gửi email:

* **Hàng đợi thư** -- Xem các thư đang chờ, trạng thái thử lại và các lần gửi thất bại
* **Nhật ký thư** -- Dấu vết kiểm toán của tất cả email đăng ký đã gửi kèm dấu thời gian và trạng thái gửi
* **Tóm tắt gửi hằng ngày** -- Theo dõi hoạt động SMTP của hôm qua và hôm nay để xác nhận cảnh báo đang được gửi đi

Các báo cáo hoạt động SMTP bổ sung cho quản lý nhật ký bằng cách cung cấp một kênh xác minh thứ hai -- nếu bạn mong đợi nhận được cảnh báo nhưng không nhận, nhật ký SMTP có thể cho biết liệu thông điệp đã được đưa vào hàng đợi, đã được gửi hay bị từ chối.

## Thực hành tốt nhất trong quản lý nhật ký

### Chuyển tiếp nhật ký ra ngoài

Cấu hình chuyển tiếp syslog từ xa ngay từ ngày đầu tiên. Thời gian lưu giữ 45 ngày trong giao diện là không đủ cho hầu hết các khung tuân thủ và hạn chế phân tích xu hướng dài hạn.

### Theo dõi dung lượng SEL

Kiểm tra thanh phần trăm SEL trên bảng điều khiển của từng node thường xuyên. Xóa SEL trước khi nó đạt dung lượng để ngăn mất các sự kiện phần cứng mới.

### Sử dụng nhật ký theo ngữ cảnh

Khi khắc phục sự cố cho một VM, mạng hoặc tenant cụ thể, hãy dùng nút Nhật ký theo ngữ cảnh trên bảng điều khiển của đối tượng đó để lọc bỏ những nhiễu không liên quan.

### Thiết lập chính sách lưu giữ

Xác định sớm các yêu cầu lưu giữ của tổ chức. Sử dụng chuyển tiếp syslog đến một nền tảng tập trung để lưu trữ dài hạn, tìm kiếm và kiểm tra tuân thủ.

{% hint style="info" %}
**Cầu nối VMware**

Đến từ VMware? Trong VergeOS, các sự kiện vận hành và kiểm toán cùng tồn tại trong một chế độ xem Nhật ký hệ thống có thể lọc duy nhất (Critical/Error/Warning/Message), được lưu trong giao diện trong 45 ngày. Chuyển tiếp syslog từ xa được cấu hình một lần ở cấp hệ thống thông qua hai trường trong Cài đặt nâng cao -- máy chủ syslog và mẫu -- thay vì cấu hình theo từng host.
{% endhint %}

{% hint style="info" %}
**Cầu nối Nutanix**

Đến từ Nutanix? Trong VergeOS, các sự kiện hệ thống và kiểm toán cùng tồn tại trong một chế độ xem Nhật ký hệ thống (lưu giữ trong giao diện 45 ngày); chuyển tiếp syslog từ xa được cấu hình một lần ở cấp hệ thống. Các sự kiện phần cứng nằm trong SEL với cùng hướng dẫn xóa chủ động.
{% endhint %}

## Điểm chính

### Ba loại nhật ký

**Nhật ký hệ thống** cho các sự kiện vận hành, **Nhật ký đồng bộ** cho hoạt động sao chép, và **SEL** cho các sự kiện IPMI phần cứng. Mỗi loại phục vụ một mục đích khắc phục sự cố riêng biệt.

### Lưu giữ trong giao diện 45 ngày

VergeOS lưu giữ nhật ký hệ thống trong giao diện trong 45 ngày. Cấu hình chuyển tiếp syslog từ xa để lưu giữ lâu hơn và đáp ứng các yêu cầu tuân thủ.

### Thiết lập Syslog đơn giản

Hai trường Cài đặt nâng cao -- địa chỉ máy chủ syslog và định dạng mẫu -- cấu hình chuyển tiếp nhật ký cho toàn bộ môi trường. TCP (`@@`) để đảm bảo độ tin cậy, UDP (`@`) để đạt hiệu năng.

### SEL cần được bảo trì

SEL phần cứng có dung lượng cố định. Hãy theo dõi thanh phần trăm trên bảng điều khiển của từng node và chủ động xóa SEL để ngăn mất sự kiện.


---

# 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/vi/module-9-giam-sat-and-khac-phuc-su-co/03-log-management.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.