> 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/vi/luu-tru/vsan-diagnostics.md).

# Hướng dẫn Chẩn đoán vSAN

## Tổng quan

Công cụ chẩn đoán vSAN cung cấp khả năng phân tích toàn diện hệ thống lưu trữ và khắc phục sự cố cho các Mạng Khu vực Lưu trữ ảo VergeOS. Các lệnh chẩn đoán này giúp quản trị viên hệ thống giám sát hiệu năng lưu trữ, khắc phục sự cố lưu trữ và duy trì tình trạng vSAN tối ưu trên toàn bộ cụm.

{% hint style="info" %}
**Bạn sẽ học được gì**

* Cách truy cập và sử dụng các công cụ chẩn đoán vSAN
* Hiểu từng lệnh chẩn đoán và trọng tâm lưu trữ của nó
* Các phương pháp tốt nhất để khắc phục sự cố và bảo trì vSAN
* Khi nào nên sử dụng các lệnh chẩn đoán cụ thể cho sự cố lưu trữ
  {% endhint %}

## Điều kiện tiên quyết

* Quyền truy cập vào giao diện VergeOS với quyền quản lý vSAN
* Hiểu biết cơ bản về các khái niệm lưu trữ phân tán
* Kiến thức về kiến trúc vSAN của VergeOS

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

Chẩn đoán vSAN chỉ khả dụng ở 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.
{% endhint %}

## Truy cập Chẩn đoán vSAN

1. **Đi đến Chẩn đoán vSAN:**
   * Chọn **Hệ thống** → **Chẩn đoán vSAN** từ menu trên cùng.
   * Hoặc cách khác: Từ Bảng điều khiển Chính, nhấp vào **Số lượng các tầng vSAN** hộp đếm → **Chẩn đoán vSAN** từ menu bên trái.
2. **Sử dụng lệnh chẩn đoán:**
   * Chọn lệnh mong muốn từ **Truy vấn** menu thả xuống
   * Cấu hình các tham số khả dụng ở bên phải
   * Nhấp vào **Gửi →** để thực thi lệnh

{% hint style="success" %}
**Hiển thị lệnh**

Bật **"Hiển thị lệnh"** để xem chính xác lệnh đang được thực thi, hữu ích cho việc thực thi qua SSH hoặc tự động hóa bằng script.
{% endhint %}

## Tham khảo lệnh chẩn đoán

### Tìm Inode

**Mục đích:** Xác định các inode cụ thể trong hệ thống tệp vSAN để phân tích chi tiết.

**Khi nào sử dụng:**

* Khắc phục lỗi hỏng hệ thống tệp
* Xác định các khối dữ liệu cụ thể
* Khắc phục sự cố lưu trữ nâng cao

**Tham số:**

* **Số inode:** Mã định danh inode cụ thể cần xác định

**Cú pháp CLI:**

```bash
vcmd find --inode=[INODE_NUMBER]
```

***

### Lấy Thông Tin Bộ Nhớ Đệm

**Mục đích:** Hiển thị thông tin và thống kê toàn diện về hệ thống bộ nhớ đệm.

**Khi nào sử dụng:**

* Tối ưu hóa hiệu năng
* Phân tích tỷ lệ trúng/nhỡ của bộ nhớ đệm
* Đánh giá mức sử dụng bộ nhớ
* Khắc phục sự cố hiệu năng lưu trữ

**Cú pháp CLI:**

```bash
vcmd cache info
```

***

### Lấy Danh Sách Client

**Mục đích:** Hiển thị các client vSAN đang hoạt động và chi tiết kết nối của chúng.

**Khi nào sử dụng:**

* Khắc phục sự cố kết nối
* Phân tích hiệu năng client
* Xác minh kết nối mạng
* Đánh giá phân bổ tải

**Cú pháp CLI:**

```bash
vcmd clients list
```

***

### Lấy Tỷ Lệ Cụm

**Mục đích:** Hiển thị các chỉ số hiệu năng và tốc độ thông lượng trên toàn cụm.

**Khi nào sử dụng:**

* Giám sát hiệu năng cụm
* Phân tích thông lượng
* Thiết lập đường cơ sở hiệu năng
* Lập kế hoạch dung lượng

**Cú pháp CLI:**

```bash
vcmd cluster rates
```

***

### Lấy Mức Sử Dụng Cụm

**Mục đích:** Hiển thị thống kê toàn diện về mức sử dụng lưu trữ của cụm.

**Khi nào sử dụng:**

* Lập kế hoạch dung lượng
* Giám sát mức sử dụng lưu trữ
* Phân tích phân bổ dung lượng
* Đánh giá xu hướng tăng trưởng

**Cú pháp CLI:**

```bash
vcmd cluster usage
```

***

### Lấy Master Hiện Tại

**Mục đích:** Xác định nút master vSAN hiện tại trong cụm.

**Khi nào sử dụng:**

* Khắc phục sự cố quyền lãnh đạo của cụm
* Phân tích chuyển đổi dự phòng của master
* Các vấn đề điều phối cụm
* Tối ưu hóa hiệu năng

**Cú pháp CLI:**

```bash
vcmd master current
```

***

### Lấy Danh Sách Thiết Bị

**Mục đích:** Liệt kê tất cả thiết bị lưu trữ tham gia vào vSAN.

**Khi nào sử dụng:**

* Quản lý kiểm kê thiết bị
* Xác minh cấu hình lưu trữ
* Giám sát trạng thái thiết bị
* Đánh giá dung lượng

**Cú pháp CLI:**

```bash
vcmd devices list
```

***

### Lấy Trạng Thái Thiết Bị

**Mục đích:** Hiển thị thông tin trạng thái chi tiết cho các thiết bị lưu trữ vSAN.

**Khi nào sử dụng:**

* Giám sát tình trạng thiết bị
* Phát hiện lỗi
* Phân tích hiệu năng
* Lập kế hoạch bảo trì

**Tham số:**

* **ID thiết bị:** Thiết bị cụ thể cần truy vấn

**Cú pháp CLI:**

```bash
vcmd device status [DEVICE_ID]
```

***

### Lấy Mức Sử Dụng Thiết Bị

**Mục đích:** Hiển thị thống kê sử dụng cho từng thiết bị lưu trữ.

**Khi nào sử dụng:**

* Giám sát mức sử dụng thiết bị
* Phân tích cân bằng tải
* Tối ưu hóa hiệu năng
* Đánh giá cân bằng hao mòn

**Tham số:**

* **ID thiết bị:** Thiết bị mục tiêu để phân tích

**Cú pháp CLI:**

```bash
vcmd device usage [DEVICE_ID]
```

***

### Lấy Trạng Thái Tệp

**Mục đích:** Truy xuất thông tin trạng thái chi tiết cho các tệp cụ thể trong vSAN.

**Khi nào sử dụng:**

* Xác minh tính toàn vẹn tệp
* Kiểm tra trạng thái sao chép
* Theo dõi vị trí dữ liệu
* Điều tra lỗi hỏng

**Tham số:**

* **Đường dẫn tệp:** Tệp mục tiêu để phân tích

**Cú pháp CLI:**

```bash
vcmd file status [FILE_PATH]
```

***

### Lấy Thông Tin Fuse

**Mục đích:** Hiển thị thông tin gắn kết và thao tác FUSE (Filesystem in Userspace).

**Khi nào sử dụng:**

* Khắc phục sự cố gắn kết hệ thống tệp
* Phân tích hiệu năng FUSE
* Xác minh điểm gắn kết
* Chẩn đoán sự cố truy cập

**Cú pháp CLI:**

```bash
vcmd fuse info
```

***

### Lấy Trạng Thái Kiểm Tra Tính Toàn Vẹn

**Mục đích:** Hiển thị trạng thái của các thao tác kiểm tra tính toàn vẹn đang diễn ra hoặc đã hoàn tất.

**Khi nào sử dụng:**

* Giám sát tính toàn vẹn dữ liệu
* Theo dõi quy trình xác minh
* Phát hiện lỗi hỏng
* Kiểm tra trạng thái bảo trì

**Cú pháp CLI:**

```bash
vcmd integcheck status
```

***

### Lấy Trạng Thái Journal

**Mục đích:** Hiển thị trạng thái và thông tin thao tác của journal vSAN.

**Khi nào sử dụng:**

* Khắc phục sự cố hiệu năng ghi
* Giám sát dung lượng journal
* Phân tích ghi nhật ký giao dịch
* Tối ưu hóa hiệu năng

**Cú pháp CLI:**

```bash
vcmd journal status
```

***

### Lấy Danh Sách Thiết Bị Của Nút

**Mục đích:** Liệt kê các thiết bị lưu trữ cho các nút cụ thể trong cụm.

**Khi nào sử dụng:**

* Kiểm kê thiết bị theo nút
* Lập kế hoạch dung lượng theo từng nút
* Phân tích phân bố thiết bị
* Chuẩn bị bảo trì nút

**Tham số:**

* **ID nút:** Nút mục tiêu để liệt kê thiết bị

**Cú pháp CLI:**

```bash
vcmd node devices [NODE_ID]
```

***

### Lấy Thông Tin Nút

**Mục đích:** Hiển thị thông tin toàn diện về các nút vSAN cụ thể.

**Khi nào sử dụng:**

* Đánh giá tình trạng nút
* Xác minh cấu hình
* Phân tích hiệu năng
* Khắc phục sự cố nút

**Tham số:**

* **ID nút:** Mã định danh nút mục tiêu

**Cú pháp CLI:**

```bash
vcmd node info [NODE_ID]
```

***

### Lấy Danh Sách Nút

**Mục đích:** Liệt kê tất cả các nút tham gia vào cụm vSAN.

**Khi nào sử dụng:**

* Xác minh thành viên cụm
* Quản lý kiểm kê nút
* Phân tích cấu trúc liên kết cụm
* Tổng quan trạng thái sức khỏe

**Cú pháp CLI:**

```bash
vcmd nodes list
```

***

### Lấy Đường Dẫn từ Inode

**Mục đích:** Giải quyết đường dẫn hệ thống tệp từ số inode.

**Khi nào sử dụng:**

* Điều hướng hệ thống tệp
* Ánh xạ inode sang đường dẫn
* Phân tích lỗi hỏng
* Khắc phục sự cố nâng cao

**Tham số:**

* **Số inode:** Inode nguồn để phân giải đường dẫn

**Cú pháp CLI:**

```bash
vcmd path from-inode [INODE_NUMBER]
```

***

### Lấy Read Ahead

**Mục đích:** Hiển thị cấu hình và thống kê bộ nhớ đệm đọc trước.

**Khi nào sử dụng:**

* Tối ưu hóa hiệu năng đọc
* Tinh chỉnh bộ nhớ đệm
* Phân tích truy cập tuần tự
* Khắc phục sự cố hiệu năng

**Cú pháp CLI:**

```bash
vcmd readahead status
```

***

### Lấy Trạng Thái Sửa Chữa

**Mục đích:** Hiển thị trạng thái của các thao tác sửa chữa đang diễn ra và tái tạo dữ liệu.

**Khi nào sử dụng:**

* Giám sát sửa chữa dữ liệu
* Theo dõi quy trình khôi phục
* Đánh giá khôi phục sau lỗi
* Kiểm tra trạng thái bảo trì

**Cú pháp CLI:**

```bash
vcmd repair status
```

***

### Lấy Cấu Hình Đang Chạy

**Mục đích:** Hiển thị cấu hình đang chạy hiện tại của hệ thống vSAN.

**Khi nào sử dụng:**

* Xác minh cấu hình
* Khắc phục sự cố cấu hình
* Tham chiếu cấu hình sao lưu
* Quản lý thay đổi

**Cú pháp CLI:**

```bash
vcmd config show
```

***

### Lấy Danh Sách Đồng Bộ

**Mục đích:** Liệt kê các thao tác đồng bộ và trạng thái của chúng.

**Khi nào sử dụng:**

* Giám sát đồng bộ dữ liệu
* Theo dõi trạng thái sao chép
* Xác minh tính nhất quán
* Phân tích hiệu năng

**Cú pháp CLI:**

```bash
vcmd sync list
```

***

### Lấy Bản Đồ Thiết Bị Của Tầng

**Mục đích:** Hiển thị ánh xạ thiết bị giữa các tầng lưu trữ khác nhau.

**Khi nào sử dụng:**

* Xác minh cấu hình tầng
* Phân tích vị trí thiết bị
* Tối ưu hóa hiệu năng
* Lập kế hoạch dung lượng

**Cú pháp CLI:**

```bash
vcmd tier device-maps
```

***

### Lấy Bản Đồ Nút Của Tầng

**Mục đích:** Hiển thị cách các tầng lưu trữ được phân bố trên các nút cụm.

**Khi nào sử dụng:**

* Phân tích phân bố tầng
* Xác minh cân bằng tải
* Tối ưu hóa hiệu năng
* Lập kế hoạch dung lượng

**Cú pháp CLI:**

```bash
vcmd tier node-maps
```

***

### Lấy Trạng Thái Tầng

**Mục đích:** Hiển thị thông tin trạng thái toàn diện cho các tầng lưu trữ.

**Khi nào sử dụng:**

* Giám sát tình trạng tầng
* Phân tích hiệu năng
* Theo dõi mức sử dụng dung lượng
* Tối ưu hóa tầng

**Cú pháp CLI:**

```bash
vcmd tier status
```

***

### Lấy Tỷ Lệ Sử Dụng Hàng Đầu

**Mục đích:** Xác định các đối tượng tiêu thụ hàng đầu về tài nguyên lưu trữ và hiệu năng.

**Khi nào sử dụng:**

* Xác định nút thắt hiệu năng
* Phân tích mức sử dụng tài nguyên
* Lập kế hoạch dung lượng
* Tối ưu hóa mức sử dụng

**Cú pháp CLI:**

```bash
vcmd usage top-rates
```

***

### Lấy Mức Sử Dụng

**Mục đích:** Hiển thị thống kê và chỉ số sử dụng vSAN toàn diện.

**Khi nào sử dụng:**

* Giám sát mức sử dụng tổng thể của hệ thống
* Lập kế hoạch dung lượng
* Thiết lập đường cơ sở hiệu năng
* Phân tích phân bổ tài nguyên

**Cú pháp CLI:**

```bash
vcmd usage show
```

***

### Lấy Mức Sử Dụng Volume

**Mục đích:** Hiển thị thống kê sử dụng cho từng volume trong vSAN.

**Khi nào sử dụng:**

* Giám sát dung lượng theo từng volume
* Phân tích hiệu năng
* Xác minh phân bổ dung lượng
* Theo dõi tăng trưởng

**Tham số:**

* **ID volume:** Volume mục tiêu để phân tích

**Cú pháp CLI:**

```bash
vcmd volume usage [VOLUME_ID]
```

***

### Kiểm Tra Tính Toàn Vẹn

**Mục đích:** Khởi tạo kiểm tra tính toàn vẹn dữ liệu toàn diện trên vSAN.

**Khi nào sử dụng:**

* Bảo trì theo lịch
* Điều tra lỗi hỏng dữ liệu
* Kiểm tra sức khỏe phòng ngừa
* Xác minh sau lỗi

{% hint style="warning" %}
**Tác động đến hiệu năng**

Các kiểm tra tính toàn vẹn có thể ảnh hưởng đáng kể đến hiệu năng hệ thống và nên được lên lịch trong các cửa sổ bảo trì.
{% endhint %}

**Cú pháp CLI:**

```bash
vcmd integcheck start
```

***

### Kiểm Tra Tính Toàn Vẹn Thiết Bị

**Mục đích:** Thực hiện kiểm tra tính toàn vẹn trên các thiết bị lưu trữ cụ thể.

**Khi nào sử dụng:**

* Xác minh tính toàn vẹn theo thiết bị
* Khắc phục sự cố có mục tiêu
* Xác minh sau sửa chữa
* Bảo trì có chọn lọc

**Tham số:**

* **ID thiết bị:** Thiết bị mục tiêu để kiểm tra tính toàn vẹn

**Cú pháp CLI:**

```bash
vcmd integcheck device [DEVICE_ID]
```

***

### Tóm Tắt Mức Sử Dụng Đĩa

**Mục đích:** Cung cấp bản tóm tắt toàn diện về mức sử dụng đĩa trên toàn bộ vSAN.

**Khi nào sử dụng:**

* Báo cáo dung lượng
* Phân tích xu hướng sử dụng
* Lập kế hoạch tối ưu hóa lưu trữ
* Báo cáo điều hành

**Cú pháp CLI:**

```bash
vcmd usage summarize
```

## Các phương pháp hay nhất

### Quy Trình Giám Sát Sức Khỏe vSAN

1. **Tổng quan hệ thống:** Bắt đầu với Lấy Mức Sử Dụng Cụm và Lấy Tỷ Lệ Cụm
2. **Phân tích hiệu năng:** Xem xét Lấy Tỷ Lệ Sử Dụng Hàng Đầu và các chỉ số theo thiết bị
3. **Đánh giá tình trạng:** Kiểm tra Lấy Trạng Thái Sửa Chữa và Lấy Trạng Thái Kiểm Tra Tính Toàn Vẹn
4. **Lập kế hoạch dung lượng:** Sử dụng Tóm Tắt Mức Sử Dụng Đĩa và thông tin tầng
5. **Khắc phục sự cố:** Sử dụng các lệnh theo thiết bị và theo nút khi cần

### Bảo trì phòng ngừa

* **Kiểm tra sức khỏe thường xuyên:** Giám sát mức sử dụng cụm, trạng thái sửa chữa và tình trạng thiết bị
* **Giám sát hiệu năng:** Theo dõi tỷ lệ cụm và các mô hình sử dụng hàng đầu
* **Xác minh tính toàn vẹn:** Lên lịch kiểm tra tính toàn vẹn định kỳ trong các cửa sổ bảo trì
* **Lập kế hoạch dung lượng:** Thường xuyên xem lại xu hướng sử dụng và các mô hình tăng trưởng

### Tối ưu hóa hiệu năng

* **Phân tích bộ nhớ đệm:** Giám sát thông tin bộ nhớ đệm và tỷ lệ trúng để tìm cơ hội tối ưu hóa
* **Quản lý tầng:** Xem lại bản đồ thiết bị của tầng và bản đồ nút để đảm bảo phân bố cân bằng
* **Cân bằng tải:** Sử dụng thông tin client và mức sử dụng để tối ưu hóa phân bố khối lượng công việc
* **Tối ưu hóa đọc:** Tinh chỉnh cài đặt read-ahead dựa trên các mô hình truy cập

## Khắc phục các sự cố vSAN phổ biến

### Sự cố hiệu năng

1. Kiểm tra **Lấy Tỷ Lệ Cụm** và **Lấy Tỷ Lệ Sử Dụng Hàng Đầu** để tìm nút thắt
2. Xem xét **Lấy Thông Tin Bộ Nhớ Đệm** để tối ưu hiệu quả bộ nhớ đệm
3. Phân tích **Lấy Mức Sử Dụng Thiết Bị** đối với hiệu năng của từng thiết bị

### Sự cố dung lượng

1. Sử dụng **Lấy Mức Sử Dụng Cụm** và **Tóm Tắt Mức Sử Dụng Đĩa** để phân tích dung lượng
2. Xem xét **Lấy Trạng Thái Tầng** đối với dung lượng theo từng tầng
3. Kiểm tra **Lấy Mức Sử Dụng Volume** đối với mức tiêu thụ của từng volume

### Các mối lo ngại về tính toàn vẹn dữ liệu

1. Xem xét **Lấy Trạng Thái Kiểm Tra Tính Toàn Vẹn** đối với các lần kiểm tra tính toàn vẹn gần đây
2. Kiểm tra **Lấy Trạng Thái Sửa Chữa** đối với các hoạt động sửa chữa đang diễn ra
3. Sử dụng **Lấy Trạng Thái Tệp** đối với xác minh tính toàn vẹn của tệp cụ thể

### Sự cố sức khỏe cụm

1. Xác minh **Lấy Master Hiện Tại** đối với trạng thái lãnh đạo
2. Kiểm tra **Lấy Danh Sách Nút** và **Lấy Thông Tin Nút** đối với tình trạng nút
3. Xem xét **Lấy Danh Sách Đồng Bộ** đối với sự cố đồng bộ

### Sự cố thiết bị

1. Sử dụng **Lấy Danh Sách Thiết Bị** và **Lấy Trạng Thái Thiết Bị** đối với tình trạng thiết bị
2. Kiểm tra **Lấy Danh Sách Thiết Bị Của Nút** đối với các vấn đề thiết bị theo từng nút
3. Chạy **Kiểm Tra Tính Toàn Vẹn Thiết Bị** đối với các sự cố thiết bị nghi ngờ

## Chẩn đoán nâng cao

### Phân tích Hệ thống Tệp

* Sử dụng **Tìm Inode** và **Lấy Đường Dẫn từ Inode** để điều tra hệ thống tệp
* Sử dụng **Lấy Trạng Thái Tệp** để phân tích tệp chi tiết
* Kiểm tra **Lấy Thông Tin Fuse** đối với các sự cố liên quan đến gắn kết

### Quản lý cấu hình

* Xem xét **Lấy Cấu Hình Đang Chạy** cho cấu hình hiện tại
* Xác minh ánh xạ tầng và thiết bị bằng các lệnh ánh xạ
* Đối chiếu chéo thông tin nút và thiết bị để đảm bảo tính nhất quán

### Tinh chỉnh hiệu năng

* Phân tích thống kê bộ nhớ đệm và read-ahead để tối ưu hóa
* Giám sát kết nối client và các mô hình sử dụng
* Xem lại trạng thái journal để tối ưu hiệu năng ghi

## Các bước tiếp theo

Sau khi thành thạo chẩn đoán vSAN, hãy cân nhắc khám phá:

* Các kỹ thuật tinh chỉnh hiệu năng vSAN nâng cao
* Các hệ thống giám sát và cảnh báo tự động
* Tích hợp với các công cụ quản lý lưu trữ bên ngoài
* Chiến lược khôi phục sau thảm họa và sao lưu

Đối với các sự cố vSAN phức tạp hoặc hướng dẫn tối ưu hiệu năng, hãy liên hệ [Hỗ trợ VergeOS](/overview/vi/support-and-services.md) với đầu ra chẩn đoán chi tiết và thông tin cấu hình hệ thống.


---

# 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/vi/luu-tru/vsan-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.