> 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/automate-protect-and-extend/vi/tich-hop-va-api/external-monitoring.md).

# Giám sát bên ngoài

## Tổng quan

Trang này mô tả cách tích hợp VergeOS với các nền tảng giám sát và quan sát bên ngoài. VergeOS ưu tiên API và cung cấp dữ liệu về tình trạng nền tảng, hiệu năng và cảm biến phần cứng thông qua ba đường dẫn được hỗ trợ.

{% hint style="warning" %}
**Không hỗ trợ SNMP**

VergeOS không bao gồm tác nhân SNMP, MIB hay cơ chế trap. SNMP được thiết kế vào cuối những năm 1980 để quản lý các thiết bị mạng phần cứng, như bộ định tuyến, bộ chuyển mạch và máy in, chứ không phải các nền tảng phần mềm định nghĩa hiện đại. VergeOS ưu tiên API: mọi chỉ số và tài nguyên mà một tác nhân SNMP sẽ hiển thị đều đã có sẵn thông qua REST API và Prometheus Exporter, vốn cung cấp dữ liệu có cấu trúc phong phú hơn qua HTTP chuẩn. Điều này phản ánh sự chuyển dịch rộng hơn của ngành, với việc Microsoft ngừng hỗ trợ dịch vụ SNMP trong Windows Server 2012, và các nền tảng cloud-native cũng như hypervisor đang chuẩn hóa theo định dạng trình bày Prometheus. Nếu công cụ giám sát cũ của bạn yêu cầu SNMP, xem [Công cụ ưu tiên SNMP](#snmp-first-tools) bên dưới để xem các giải pháp thay thế khả dụng.
{% endhint %}

### Các đường dẫn giám sát được hỗ trợ

| Đường dẫn                                                           | Dùng cho                                             | Đối tượng                                             |
| ------------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------- |
| [Trình xuất Prometheus (ioMetrics)](#prometheus-exporter-iometrics) | Chỉ số vSAN, cụm và nút                              | Điểm khởi đầu được khuyến nghị cho hầu hết môi trường |
| [REST API](#rest-api)                                               | Bộ thu thập tùy chỉnh, thăm dò bất kỳ tài nguyên nào | Tích hợp theo từng công cụ, kiểm tra bằng script      |
| [IPMI](#ipmi)                                                       | Tình trạng phần cứng và cảm biến theo từng nút       | Giám sát ở cấp phần cứng bên ngoài VergeOS            |

***

## Trình xuất Prometheus (ioMetrics)

Bộ **Trình xuất Prometheus VergeOS (ioMetrics)** là đường dẫn được khuyến nghị cho các chỉ số ở cấp nền tảng. Nó thu thập các chỉ số cấp vSAN, cụm và nút từ VergeOS và hiển thị chúng theo định dạng Prometheus tiêu chuẩn, sẵn sàng để Prometheus, Grafana, VictoriaMetrics hoặc bất kỳ hệ thống tương thích Prometheus nào quét.

### Vì sao đây là đường dẫn được khuyến nghị

* **Chính chủ** — được duy trì trong tổ chức verge-io
* **— dựa trên tiêu chuẩn** — bất kỳ công cụ giám sát tương thích Prometheus nào cũng có thể sử dụng đầu ra

Xem [Trình xuất Prometheus (ioMetrics)](/automate-protect-and-extend/vi/tich-hop-va-api/prometheus-exporter.md) trang để xem tổng quan trong sản phẩm, các chỉ số được hiển thị và liên kết đến dự án mã nguồn mở.

***

## REST API

REST API của VergeOS hiển thị mọi tài nguyên mà giao diện người dùng có thể đọc, khiến đây là đường dẫn phù hợp cho các bộ thu thập tùy chỉnh, kiểm tra sức khỏe bằng script hoặc tích hợp với các công cụ không hỗ trợ Prometheus.

### Xác thực

Các bộ thu thập giám sát bên ngoài chạy dài hạn và nên xác thực bằng API Key thay vì mã phiên. API Key được tạo theo từng người dùng và có thể giới hạn theo IP cũng như đặt thời hạn. Xem [API Keys](/automate-protect-and-extend/vi/cac-be-mat-quan-tri-dung-chung/api-keys.md) để thiết lập và [Hướng dẫn API](/knowledge-base/vi/automation-api/verge-api-guide.md) để xem danh sách đầy đủ các phương thức xác thực được hỗ trợ.

### Tài liệu Swagger

Tài liệu tham chiếu API đầy đủ, chính xác theo phiên bản, có sẵn trong VergeOS:

1. Nhấp vào **biểu tượng người dùng** ở góc trên bên phải của giao diện VergeOS.
2. Chọn **Hệ thống**.
3. Chọn **Tài liệu API**.

Trang Swagger liệt kê mọi bảng và thao tác, kèm các ví dụ có thể chạy trực tiếp trên hệ thống.

{% hint style="success" %}
**Bắt đầu từ đâu**

Để biết thêm về các quy ước HTTP, lọc, sắp xếp và các yêu cầu mẫu, xem [Hướng dẫn API](/knowledge-base/vi/automation-api/verge-api-guide.md) trong cơ sở tri thức.
{% endhint %}

### Khi nào nên dùng REST API cho giám sát

* Công cụ giám sát hỗ trợ thăm dò HTTP nhưng không hỗ trợ Prometheus
* Một chỉ số hoặc tài nguyên cụ thể không được Trình xuất Prometheus hiển thị
* Cần một bộ thu thập tùy chỉnh để tích hợp với nền tảng quan sát nội bộ

***

## IPMI

Đối với **tình trạng phần cứng và dữ liệu cảm biến theo từng nút** — nhiệt độ, tốc độ quạt, điện áp, mức tiêu thụ điện, lỗi phần cứng — VergeOS hiển thị trực tiếp giao diện IPMI của nút.

1. Điều hướng đến **Hạ tầng > Nút** từ menu trên cùng.
2. Nhấp đúp vào nút mong muốn để mở bảng điều khiển của nút.
3. Trong **IPMI** menu con, nhấp **Kết nối** để mở giao diện web IPMI trong thẻ mới, hoặc **Kiểm tra** để xác minh kết nối từ VergeOS.

{% hint style="info" %}
**Chỉ phần cứng**

IPMI hiển thị **phần cứng vật lý** trạng thái của một nút máy chủ — không phải các chỉ số lớp ứng dụng của VergeOS. Hầu hết các nền tảng giám sát đã bao gồm các bộ thu thập IPMI có thể thăm dò trực tiếp các BMC của nút, song song với các đường dẫn Trình xuất Prometheus và REST API ở trên.
{% endhint %}

Để cấu hình thông tin đăng nhập IPMI đã lưu và kiểm tra kết nối, xem [IPMI](/run-the-platform/vi/quan-tri-he-thong/ipmi.md) trang.

***

## Công cụ ưu tiên SNMP

Các công cụ như **SolarWinds**, **LogicMonitor**, **PRTG**, và **Nagios** thường được cấu hình để giám sát hạ tầng qua SNMP. VergeOS không có tích hợp sẵn cho các công cụ này vì không có tác nhân SNMP để trỏ tới.

{% hint style="success" %}
**Trước tiên hãy kiểm tra hỗ trợ Prometheus gốc**

Một số nền tảng này hiện nay tiếp nhận chỉ số Prometheus một cách gốc — **LogicMonitor** (OpenMetrics DataSource) và **SolarWinds Observability** (tích hợp Prometheus). Nếu nền tảng của bạn là một trong số đó, hãy trỏ nó tới [Trình xuất Prometheus](#prometheus-exporter-iometrics) và bỏ qua phần còn lại của mục này. Hai tùy chọn bên dưới bao gồm các công cụ không hỗ trợ Prometheus — bao gồm cả bản cài đặt tại chỗ **SolarWinds Platform / SAM**, **PRTG**, và **Nagios**.
{% endhint %}

### Tùy chọn 1 — Bộ thu thập REST tùy chỉnh

Hầu hết các nền tảng giám sát doanh nghiệp cho phép bộ thu thập HTTP/REST tùy chỉnh:

| Nền tảng     | Cơ chế                                    |
| ------------ | ----------------------------------------- |
| SolarWinds   | Trình thăm dò API (SAM)                   |
| LogicMonitor | Nguồn dữ liệu bằng script (Groovy / HTTP) |
| PRTG         | Cảm biến tùy chỉnh HTTP XML/REST          |
| Nagios       | `check_http` / plugin tùy chỉnh           |

Trỏ bộ thu thập tới REST API của VergeOS, xác thực theo [Hướng dẫn API](/knowledge-base/vi/automation-api/verge-api-guide.md), và phân tích phản hồi JSON. Đây là đường dẫn ít tốn chi phí vận hành nhất — không có quy trình trung gian nào cần duy trì, và bộ thu thập giao tiếp trực tiếp với nguồn dữ liệu chuẩn.

### Tùy chọn 2 — Cầu nối Prometheus-to-SNMP

Nếu công cụ giám sát chỉ hỗ trợ SNMP và bộ thu thập tùy chỉnh không phải là một lựa chọn, cách làm phổ biến của cộng đồng là chạy [Trình xuất Prometheus](#prometheus-exporter-iometrics) và đặt một cầu nối Prometheus-to-SNMP ở phía trước nó. Cầu nối sẽ hiển thị lại các chỉ số Prometheus dưới dạng các OID SNMP mà bộ thăm dò SNMP có thể quét.

{% hint style="warning" %}
**Không được Verge hỗ trợ**

Các cầu nối Prometheus-to-SNMP là dự án cộng đồng và không được Verge xây dựng, kiểm thử hay hỗ trợ. Chúng tôi không đề xuất một cầu nối cụ thể nào — lựa chọn phụ thuộc vào tập con chỉ số Prometheus nào cần được hiển thị lại và công cụ phía sau tiêu thụ SNMP như thế nào. Hãy xem đường dẫn này như một giải pháp tạm thời, không phải tích hợp lâu dài.
{% endhint %}

***

## Chọn một đường dẫn

| Kịch bản                                                        | Đường dẫn được khuyến nghị                                                                                                                                           |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Triển khai giám sát mới, không có ràng buộc với công cụ hiện có | [Trình xuất Prometheus](#prometheus-exporter-iometrics) + Grafana                                                                                                    |
| Ngăn xếp Prometheus / Grafana / VictoriaMetrics hiện có         | [Trình xuất Prometheus](#prometheus-exporter-iometrics)                                                                                                              |
| Công cụ giám sát thăm dò HTTP nhưng không hỗ trợ Prometheus     | [REST API](#rest-api) bộ thu thập tùy chỉnh                                                                                                                          |
| Tình trạng phần cứng (nhiệt độ, quạt, nguồn)                    | [IPMI](#ipmi)                                                                                                                                                        |
| SolarWinds / LogicMonitor / PRTG / Nagios (ưu tiên SNMP)        | [Bộ thu thập REST tùy chỉnh](#option-1-custom-rest-collector) được ưu tiên, [Cầu nối Prometheus-to-SNMP](#option-2-prometheus-to-snmp-bridge) làm phương án dự phòng |

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

* [Trình xuất Prometheus (ioMetrics)](/automate-protect-and-extend/vi/tich-hop-va-api/prometheus-exporter.md) — tổng quan trong sản phẩm và liên kết đến dự án mã nguồn mở
* [Hướng dẫn API](/knowledge-base/vi/automation-api/verge-api-guide.md) — xác thực, quy ước HTTP và các yêu cầu mẫu
* [IPMI](/run-the-platform/vi/quan-tri-he-thong/ipmi.md) — kiểm tra kết nối, quản lý thông tin xác thực và truy cập giao diện web IPMI

## Tài liệu và tài nguyên

| Tài nguyên                                                               | Mô tả                                               |
| ------------------------------------------------------------------------ | --------------------------------------------------- |
| [vergeos-exporter](https://github.com/verge-io/vergeos-exporter)         | Bộ xuất Prometheus mã nguồn mở cho VergeOS          |
| [Tài liệu Prometheus](https://prometheus.io/docs/introduction/overview/) | Tài liệu Prometheus gốc                             |
| [Tài liệu Grafana](https://grafana.com/docs/)                            | Xây dựng bảng điều khiển trên các chỉ số Prometheus |


---

# 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/automate-protect-and-extend/vi/tich-hop-va-api/external-monitoring.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.