> 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/05-diagnostics-toolkit.md).

# Bộ công cụ chẩn đoán

## Bốn bộ công cụ chẩn đoán trong một nền tảng

VergeOS nhúng các công cụ chẩn đoán trực tiếp vào mọi hệ thống con chính. Thay vì SSH vào từng nút riêng lẻ hoặc cài đặt các tiện ích của bên thứ ba, quản trị viên chạy chẩn đoán từ **giao diện VergeOS** — mỗi công cụ được giới hạn theo thành phần đang được điều tra.

```mermaid
graph LR
    subgraph "Chẩn đoán VergeOS"
        A["Chẩn đoán<br/>mạng"] --> E["Giao diện thống nhất"]
        B["Chẩn đoán<br/>nút"] --> E
        C["Chẩn đoán<br/>vSAN"] --> E
        D["Chẩn đoán<br/>NAS"] --> E
    end
    E --> F["Kết quả &<br/>xuất CLI"]

    style A fill:#4a90d9,color:#fff
    style B fill:#e67e22,color:#fff
    style C fill:#27ae60,color:#fff
    style D fill:#8e44ad,color:#fff
    style E fill:#2c3e50,color:#fff
    style F fill:#34495e,color:#fff
```

Mọi giao diện chẩn đoán đều theo cùng một mẫu:

1. Đi tới thành phần (mạng, nút, NAS hoặc vSAN)
2. Nhấp **Chẩn đoán** trong menu bên trái
3. Chọn một lệnh từ **Query** trình đơn thả xuống
4. Cấu hình các tham số ở bên phải
5. Nhấp **Send →** để thực thi

{% hint style="success" %}
**Công tắc hiển thị lệnh**

Bật **"Hiển thị lệnh"** trên bất kỳ chẩn đoán nào để xem lệnh chính xác đang được thực thi. Đây là cách chính thức để xem cú pháp nền tảng cho việc viết script, tự động hóa hoặc tái tạo một lệnh qua SSH.
{% endhint %}

***

## Chẩn đoán mạng

**Truy cập:** Mạng → \[Chọn mạng] → Chẩn đoán

Chẩn đoán mạng chạy **theo từng mạng** — bạn chọn mạng cụ thể muốn khắc phục sự cố, và tất cả lệnh thực thi trong ngữ cảnh của mạng đó. Điều này rất quan trọng vì các mạng VergeOS được cô lập theo thiết kế.

### Kết nối & khám phá

| Lệnh                     | Mục đích                                        |
| ------------------------ | ----------------------------------------------- |
| **Ping**                 | Kiểm tra kết nối ICMP cơ bản                    |
| **Truy vết đường đi**    | Ánh xạ đường đi mạng tới một đích               |
| **Quét ARP**             | Phát hiện các thiết bị đang hoạt động trên mạng |
| **Bảng ARP**             | Xem ánh xạ IP-to-MAC hiện tại                   |
| **Kiểm tra kết nối TCP** | Xác minh một cổng TCP cụ thể có thể truy cập    |
| **IP của tôi là gì**     | Kiểm tra IP bên ngoài của mạng (xác minh NAT)   |

### DNS & phân giải tên

| Lệnh            | Mục đích                                  |
| --------------- | ----------------------------------------- |
| **Tra cứu DNS** | Truy vấn các bản ghi A, AAAA, MX, NS, PTR |

### Tường lửa & bảo mật

| Lệnh                                  | Mục đích                                |
| ------------------------------------- | --------------------------------------- |
| **Hiển thị quy tắc tường lửa**        | Hiển thị toàn bộ bộ quy tắc tường lửa   |
| **Theo dõi/Gỡ lỗi quy tắc tường lửa** | Bật ghi log theo từng quy tắc để gỡ lỗi |
| **NMAP**                              | Quét cổng và khám phá dịch vụ           |

### Phân tích lưu lượng

| Lệnh                          | Mục đích                                               |
| ----------------------------- | ------------------------------------------------------ |
| **Bắt gói TCP**               | Bắt gói với lọc BPF                                    |
| **Mức sử dụng mạng cao nhất** | Các tiến trình tiêu thụ băng thông theo thời gian thực |
| **Mức sử dụng CPU cao nhất**  | Các tiến trình sử dụng nhiều CPU nhất                  |

### Theo dịch vụ

| Lệnh                        | Mục đích                                       |
| --------------------------- | ---------------------------------------------- |
| **DHCP Giải phóng/Gia hạn** | Buộc làm mới lease DHCP (mạng máy khách DHCP)  |
| **IPsec**                   | Giám sát và điều khiển các đường hầm VPN IPsec |
| **FRRouting BGP/OSPF**      | Trạng thái giao thức định tuyến động           |
| **Nhật ký**                 | Nhật ký hệ thống của vùng chứa mạng            |

{% hint style="info" %}
**Truy cập tenant**

Tenant có quyền truy cập vào các chẩn đoán mạng của chính họ cho các mạng dành riêng cho tenant. Những công cụ này hoạt động trong phạm vi mạng của tenant — chúng không thể nhìn thấy các mạng ở cấp cha.
{% endhint %}

***

## Chẩn đoán nút

**Truy cập:** Cơ sở hạ tầng → Nút → \[Chọn nút] → Chẩn đoán

Chẩn đoán nút cung cấp **ở cấp phần cứng** khả năng quan sát từng máy chủ vật lý riêng lẻ. Những công cụ này tương tác trực tiếp với BMC, ổ đĩa và các giao diện mạng vật lý của máy chủ.

### Công cụ IPMI / BMC

Các lệnh này giao tiếp với Baseboard Management Controller của máy chủ — giao diện quản lý ngoài băng tần (iDRAC trên Dell, iLO trên HPE, v.v.).

| Lệnh                              | Mục đích                                         |
| --------------------------------- | ------------------------------------------------ |
| **Thông tin BMC IPMI**            | Firmware và cấu hình BMC                         |
| **Trạng thái chassis IPMI**       | Trạng thái nguồn, phát hiện xâm nhập             |
| **Thông tin FRU IPMI**            | Định danh đơn vị có thể thay thế tại hiện trường |
| **Thông tin LAN IPMI**            | Cấu hình mạng BMC                                |
| **Đặt lại MC IPMI**               | Đặt lại BMC không phản hồi                       |
| **Cảm biến IPMI**                 | Đọc nhiệt độ, điện áp, quạt                      |
| **Kho dữ liệu cảm biến IPMI**     | Kho dữ liệu cảm biến đầy đủ                      |
| **Nhật ký sự kiện hệ thống IPMI** | Lịch sử sự kiện phần cứng (SEL)                  |

{% hint style="warning" %}
**Đặt lại MC IPMI**

Việc đặt lại BMC sẽ tạm thời làm gián đoạn quản lý ngoài băng tần. Hệ điều hành máy chủ vẫn tiếp tục chạy — thao tác này chỉ ảnh hưởng đến bộ điều khiển quản lý.
{% endhint %}

### Tình trạng ổ đĩa & lưu trữ

| Lệnh                              | Mục đích                                                        |
| --------------------------------- | --------------------------------------------------------------- |
| **Thông tin S.M.A.R.T.**          | Thuộc tính tình trạng ổ đĩa, độ mòn, nhiệt độ                   |
| **Kiểm tra chẩn đoán S.M.A.R.T.** | Chạy kiểm tra ngắn, dài hoặc conveyance                         |
| **Hiển thị thiết bị khối**        | Liệt kê tất cả thiết bị khối trên nút                           |
| **Điều khiển LED (ổ đĩa)**        | Kích hoạt/vô hiệu hóa đèn định vị của ổ đĩa để nhận dạng vật lý |
| **Truy vấn RAS**                  | Báo cáo lỗi ECC bộ nhớ                                          |

### Mạng & fabric

| Lệnh                    | Mục đích                                            |
| ----------------------- | --------------------------------------------------- |
| **Công cụ Ethernet**    | Tốc độ liên kết, duplex, thông tin trình điều khiển |
| **Cấu hình fabric**     | Trạng thái fabric lõi của nút này                   |
| **Gộp mạng**            | Tình trạng giao diện bond và slave đang hoạt động   |
| **Địa chỉ bridge**      | Bảng địa chỉ MAC của switch ảo                      |
| **Quét ARP / Bảng ARP** | Khám phá mạng ở cấp nút                             |
| **Ping / Trace Route**  | Kết nối cơ bản từ ngữ cảnh nút                      |

### Hệ thống

| Lệnh                            | Mục đích                                          |
| ------------------------------- | ------------------------------------------------- |
| **Bảng DMI**                    | Kiểm kê phần cứng đầy đủ (CPU, RAM, số sê-ri)     |
| **Nhật ký**                     | Nhật ký hệ thống và kernel                        |
| **OpenSSL Speed**               | Điểm chuẩn hiệu năng mã hóa CPU                   |
| **Xóa bộ nhớ lưu trữ bền vững** | Xóa bộ nhớ đệm hệ thống tệp (chỉ dùng cho hỗ trợ) |

{% hint style="info" %}
**Bạn đang chuyển từ VMware hay Nutanix?**
{% endhint %}

| Nền tảng | Nơi diễn ra kiểm tra phần cứng chuyên sâu                                                                                                                                            |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| VMware   | SSH/DCUI tới máy chủ ESXi để `esxcli`/`vsish`; vCenter hiển thị một số SMART/cảm biến nhưng các tác vụ chuyên sâu phải rời khỏi giao diện vSphere                                    |
| Nutanix  | Trang Phần cứng Prism Element + `ncli` từ CVM; IPMI/BMC được truy cập riêng cho LED ổ đĩa và cảm biến chi tiết                                                                       |
| VergeOS  | Bảng điều khiển chẩn đoán một nút: IPMI, SMART, điều khiển LED ổ đĩa, tình trạng fabric, không cần SSH hay thông tin đăng nhập BMC riêng. "Hiển thị lệnh" cho thấy cú pháp nền tảng. |

***

## Chẩn đoán vSAN

**Truy cập:** System → Chẩn đoán vSAN

Chẩn đoán vSAN hoạt động ở **cấp hệ thống**, cung cấp khả năng quan sát sâu vào công cụ lưu trữ phân tán.

{% hint style="warning" %}
**Chỉ cấp gốc / cấp cha**

Chẩn đoán vSAN chỉ có sẵn ở cấp gốc/cấp cha. **Tenant không có quyền truy cập** vào các công cụ chẩn đoán vSAN — họ tương tác với bộ nhớ lưu trữ thông qua các đĩa ảo được cấp phát cho họ.
{% endhint %}

### Các lệnh chẩn đoán vSAN chính

| Lệnh                                 | Mục đích                                          |
| ------------------------------------ | ------------------------------------------------- |
| **Lấy Trạng thái Tier**              | Tình trạng, dự phòng và dung lượng theo từng tier |
| **Lấy Tốc độ Cụm**                   | Thông lượng đọc/ghi trên toàn cụm                 |
| **Lấy Mức sử dụng Cụm**              | Thống kê mức sử dụng lưu trữ tổng thể             |
| **Lấy danh sách thiết bị**           | Tất cả thiết bị lưu trữ trong pool vSAN           |
| **Lấy Trạng thái Thiết bị**          | Tình trạng và số lỗi của từng thiết bị            |
| **Lấy Mức sử dụng Thiết bị**         | Dung lượng và chỉ số I/O theo từng thiết bị       |
| **Lấy Trạng thái Sửa chữa**          | Tiến độ tái tạo/sửa chữa đang hoạt động           |
| **Lấy Trạng thái Journal**           | Tình trạng nhật ký write-ahead                    |
| **Lấy Trạng thái Kiểm tra Toàn vẹn** | Tiến độ xác minh tính toàn vẹn dữ liệu            |
| **Lấy Thông tin Cache**              | Tỷ lệ hit/miss của cache và mức sử dụng bộ nhớ    |
| **Lấy Trạng thái Tệp**               | Nhân bản và tính toàn vẹn cho một tệp cụ thể      |
| **Lấy Tốc độ Mức sử dụng Cao nhất**  | Xác định các đối tượng tiêu thụ lưu trữ hàng đầu  |
| **Lấy Cấu hình Đang chạy**           | Các tham số cấu hình vSAN hiện tại                |
| **Lấy Danh sách Đồng bộ**            | Các thao tác đồng bộ đang hoạt động               |
| **Lấy Danh sách Nút**                | Tất cả các nút tham gia vào vSAN                  |
| **Kiểm tra Toàn vẹn**                | Khởi chạy kiểm tra toàn vẹn đầy đủ                |
| **Tổng hợp Mức sử dụng Đĩa**         | Tổng quan mức sử dụng đĩa trên toàn cụm           |

### Quy trình kiểm tra sức khỏe vSAN

Một cách tiếp cận có cấu trúc để điều tra sự cố lưu trữ:

```mermaid
flowchart TD
    A["Kiểm tra trạng thái tier"] --> B{Tất cả các tier<br/>đang hoạt động = true?}
    B -->|Có| C["Kiểm tra tốc độ cụm"]
    B -->|Không| D["Kiểm tra trạng thái sửa chữa"]
    D --> E["Kiểm tra trạng thái thiết bị<br/>đối với ổ đĩa hỏng"]
    C --> F{Hiệu năng<br/>chấp nhận được?}
    F -->|Có| G["Hệ thống khỏe mạnh"]
    F -->|Không| H["Kiểm tra thông tin bộ nhớ đệm"]
    H --> I["Kiểm tra mức sử dụng cao nhất"]
    I --> J["Xác định nút thắt"]
    E --> K["Kiểm tra dữ liệu SMART<br/>qua Chẩn đoán nút"]

    style A fill:#27ae60,color:#fff
    style G fill:#27ae60,color:#fff
    style D fill:#e74c3c,color:#fff
    style E fill:#e74c3c,color:#fff
```

### Các chỉ số chính cần theo dõi

* **`working = false`** trên bất kỳ tier nào → Nghiêm trọng — tier không hoạt động
* **`redundant = false`** → Trạng thái suy giảm, không có khả năng chịu lỗi
* **`bad_drives > 0`** → Phát hiện ổ đĩa hỏng, đang tiến hành tự sửa chữa
* **Trạng thái sửa chữa đều bằng 0** → Không có sửa chữa đang hoạt động (trạng thái khỏe mạnh)
* **Đang giới hạn ghi** → Dung lượng lưu trữ đang tiến gần giới hạn (>91% sẽ kích hoạt giới hạn)

### Ngưỡng giới hạn dung lượng lưu trữ

| Mức sử dụng | Hành vi                                                 |
| ----------- | ------------------------------------------------------- |
| **< 91%**   | Hoạt động bình thường, không giới hạn                   |
| **91–95%**  | Bắt đầu giới hạn do thiếu dung lượng (thêm độ trễ 10ms) |
| **96%+**    | Giới hạn nghiêm trọng (thêm độ trễ 50ms)                |
| **> 96%**   | Suy giảm hiệu năng nghiêm trọng                         |

***

## Chẩn đoán NAS

**Truy cập:** NAS → \[Chọn dịch vụ NAS] → Chẩn đoán

Chẩn đoán NAS là **theo từng dịch vụ NAS** — mỗi phiên bản NAS có giao diện chẩn đoán riêng. Những công cụ này tập trung vào các giao thức chia sẻ tệp (SMB/CIFS, NFS) và xác thực.

### Chia sẻ tệp & xác thực

| Lệnh        | Mục đích                                                                                                       |
| ----------- | -------------------------------------------------------------------------------------------------------------- |
| **Samba**   | Trạng thái dịch vụ SMB/CIFS — các kết nối đang hoạt động và tệp bị khóa, xác thực cấu hình, và liệt kê chia sẻ |
| **NFS**     | Trạng thái dịch vụ NFS — các export hiện tại, đăng ký RPC, và khả năng hiển thị điểm gắn của máy khách         |
| **Winbind** | Kiểm tra Active Directory — quan hệ tin cậy miền, người dùng miền và nhóm miền                                 |

### Công cụ mạng tiêu chuẩn

Chẩn đoán NAS cũng bao gồm các công cụ kết nối tiêu chuẩn: **Ping**, **Truy vết đường đi**, **Quét/Bảng ARP**, **Bắt gói TCP**, **Kiểm tra kết nối TCP**, **Tra cứu DNS**, **Truy vấn NTP**, **Mức sử dụng CPU cao nhất**, **Mức sử dụng mạng cao nhất**, và **Nhật ký**.

### Chẩn đoán người dùng & nhóm

| Lệnh           | Mục đích                                           |
| -------------- | -------------------------------------------------- |
| **Người dùng** | Tài khoản người dùng hệ thống                      |
| **Nhóm**       | Nhóm hệ thống và thành viên                        |
| **Ngày/Giờ**   | Đồng bộ thời gian (rất quan trọng cho Kerberos/AD) |
| **Dịch vụ**    | Tất cả dịch vụ đang chạy                           |

***

## Quy trình khắc phục sự cố theo phương pháp tốt nhất

Khi điều tra sự cố, hãy theo một lộ trình leo thang có cấu trúc từ chẩn đoán theo thành phần đến phân tích toàn hệ thống:

```mermaid
flowchart TD
    A["1. Xác định phạm vi"] --> B["Thành phần nào bị ảnh hưởng?<br/>Mạng? Lưu trữ? Phần cứng? NAS?"]
    B --> C["2. Chẩn đoán thành phần"]
    C --> D["Sử dụng bộ công cụ phù hợp:<br/>Mạng → Chẩn đoán mạng<br/>Lưu trữ → Chẩn đoán vSAN<br/>Phần cứng → Chẩn đoán nút<br/>Chia sẻ tệp → Chẩn đoán NAS"]
    D --> E{"Sự cố<br/>đã được giải quyết?"}
    E -->|Có| F["Ghi lại kết quả"]
    E -->|Không| G["3. Chẩn đoán hệ thống"]
    G --> H["Hệ thống → Chẩn đoán hệ thống<br/>Tạo bộ chẩn đoán đầy đủ"]
    H --> I{"Sự cố<br/>đã được giải quyết?"}
    I -->|Có| F
    I -->|Không| J["4. Chuyển lên bộ phận hỗ trợ"]
    J --> K["Đính kèm bộ chẩn đoán<br/>Bao gồm dòng thời gian & triệu chứng"]

    style A fill:#3498db,color:#fff
    style C fill:#2ecc71,color:#fff
    style G fill:#f39c12,color:#fff
    style J fill:#e74c3c,color:#fff
```

### Nguyên tắc quy trình

1. **Bắt đầu đơn giản** — Ping trước khi bắt gói. Kiểm tra trạng thái tier trước khi kiểm tra toàn vẹn.
2. **Xác định đúng phạm vi** — Chọn đúng mạng, nút hoặc dịch vụ NAS trước khi chạy chẩn đoán. Chạy lệnh trong ngữ cảnh sai sẽ cho kết quả gây hiểu nhầm.
3. **Ghi chép trong quá trình thực hiện** — Dùng "Hiển thị lệnh" để ghi lại chính xác các lệnh. Sao chép đầu ra trước khi chuyển sang bài kiểm tra tiếp theo.
4. **Cân nhắc ảnh hưởng đến hiệu năng** — TCP Dump, quét NMAP và kiểm tra toàn vẹn có thể ảnh hưởng đến hiệu năng môi trường sản xuất. Hãy lên lịch các chẩn đoán nặng trong cửa sổ bảo trì.
5. **Kiểm tra nhật ký cuối cùng** — Nhật ký cung cấp ngữ cảnh nhưng có thể quá nhiều. Hãy dùng chẩn đoán có mục tiêu trước, rồi đối chiếu với các mục nhật ký.

### Gói Chẩn đoán Hệ thống

Đối với các sự cố liên quan đến nhiều thành phần hoặc cần chuyển lên bộ phận hỗ trợ, VergeOS có thể tạo một **bộ chẩn đoán đầy đủ**:

* **Truy cập:** System → Chẩn đoán Hệ thống
* **Đầu ra:** `[SYSTEMNAME]_diags_[YYYYMMDD]_[HHMMSS].tar.gz`
* **Nội dung:** các tệp trạng thái vSAN, báo cáo SMART, cấu hình mạng, dữ liệu IPMI, nhật ký hệ thống và nhật ký kernel — được tổ chức theo từng nút
* **Lưu trữ bộ chẩn đoán:** Được lưu dưới dạng một `các tệp` bản ghi trong vSAN; bộ chẩn đoán sẽ tồn tại cho đến khi bạn xóa nó

{% hint style="info" %}
**Thời hạn lưu nhật ký UI so với thời hạn lưu bộ chẩn đoán**

Bản thân bộ chẩn đoán không tự hết hạn. Ngoài ra, VergeOS lưu giữ nhật ký giao diện trực tiếp **nhật ký hệ thống trong 45 ngày** trước khi tự động xóa — hãy cấu hình chuyển tiếp syslog từ xa nếu bạn cần lịch sử nhật ký dài hơn.
{% endhint %}

{% hint style="success" %}
**Trước khi chuyển lên**

Luôn tạo một bộ Chẩn đoán hệ thống mới trước khi liên hệ bộ phận hỗ trợ. Điều này cung cấp một ảnh chụp nhanh hoàn chỉnh tại một thời điểm để các kỹ sư hỗ trợ có thể phân tích mà không cần truy cập hệ thống trực tiếp.
{% endhint %}

***

## Tham khảo nhanh: Nên dùng bộ công cụ nào

### Chẩn đoán mạng

**Dùng khi:** VM không truy cập được Internet, DNS không phân giải được, tường lửa chặn lưu lượng, DHCP không cấp IP, đường hầm VPN bị ngắt

**Truy cập:** Mạng → \[Mạng] → Chẩn đoán

### Chẩn đoán nút

**Dùng khi:** Cảnh báo phần cứng, ổ đĩa hỏng, cảnh báo nhiệt độ, sự cố liên kết NIC, IPMI không phản hồi, sự cố kết nối fabric

**Truy cập:** Cơ sở hạ tầng → Nút → \[Nút] → Chẩn đoán

### Chẩn đoán vSAN

**Dùng khi:** Hiệu năng lưu trữ suy giảm, tier không khỏe mạnh, cảnh báo dung lượng, sửa chữa bị kẹt, lo ngại về tính toàn vẹn dữ liệu

**Truy cập:** System → Chẩn đoán vSAN

### Chẩn đoán NAS

**Dùng khi:** Không truy cập được chia sẻ SMB, gắn NFS thất bại, xác thực AD bị lỗi, bị từ chối quyền tệp, hiệu năng CIFS chậm

**Truy cập:** NAS → \[Dịch vụ NAS] → Chẩn đoá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/05-diagnostics-toolkit.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.
