> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PRTG Network Monitor

> Kết nối PRTG để agent điều tra sensor và alarm, đọc lịch sử và thao tác trên các đối tượng giám sát

Kết nối PRTG Network Monitor bằng API key để điều tra sensor, alarm, device và lịch sử. Khi được cấp quyền, CloudThinker cũng có thể thay đổi một đối tượng giám sát thông qua [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md).

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

* PRTG web server mà CloudThinker truy cập được qua HTTPS, với chứng chỉ được tin cậy. Xem [Truy cập dịch vụ riêng](https://docs.cloudthinker.io/vi/guide/connections/overview.md#truy-cập-dịch-vụ-nội-bộ).
* Tài khoản PRTG đọc được các đối tượng giám sát bạn muốn điều tra.
* Quyền thêm kết nối trong workspace CloudThinker của bạn.

## Thiết lập

**1. Tạo API key**

Trong PRTG, mở **Setup → Account Settings → API Keys**. Di chuột lên biểu tượng thêm và chọn **Add API Key**. Đặt tên cho key và chọn **Read access** để dùng cho điều tra. Sao chép key trước khi nhấn **OK**, vì PRTG sẽ không hiển thị lại. Xem [hướng dẫn API key của Paessler](https://www.paessler.com/manuals/prtg/api_keys).

**2. Thêm kết nối**

Trong CloudThinker, mở **More → Workspace settings → Connections** và chọn **PRTG Network Monitor**. Nhập địa chỉ gốc HTTPS của server vào **Server URL**, không kèm đường dẫn hay query. Dán key vào **API key** rồi nhấn **Connect**.

**Trạng thái thành công:** kết nối hiển thị **Connected**. CloudThinker kiểm tra trạng thái của PRTG server.

## Chi tiết kết nối

| Trường | Mô tả |
| - | - |
| **Server URL** | Địa chỉ HTTPS của PRTG web server, không kèm đường dẫn hay query |
| **API key** | Key đã tạo trong PRTG |

## Quyền yêu cầu

Bắt đầu với **Read access** trên API key và một user đọc được các đối tượng giám sát bạn muốn điều tra. PRTG giới hạn những gì user nhìn thấy theo quyền truy cập của user đó. Xem [hướng dẫn quyền truy cập của Paessler](https://www.paessler.com/manuals/prtg/access_rights_management).

Để cho phép thay đổi, key và user của key phải có đủ quyền cần thiết trong PRTG, đồng thời công cụ ghi của kết nối phải được bật. Hãy xem lại [Approval mode](https://docs.cloudthinker.io/vi/guide/approvals/approval-mode.md) trước khi cho phép thay đổi.

## Khả năng của agent

| Khả năng | CloudThinker làm gì |
| - | - |
| **Khám phá** | Tóm tắt server, sensor, alarm và device |
| **Điều tra alarm** | Đọc các sensor ở trạng thái down, acknowledged, warning và log gần đây |
| **Lịch sử sensor** | Đọc lịch sử gần đây và giá trị channel của một sensor |
| **Thay đổi** | Tạm dừng, tiếp tục, acknowledge, quét, đổi tên hoặc đổi mức ưu tiên của một đối tượng được hỗ trợ |

Tạm dừng một device hoặc group cũng tạm dừng các sensor bên trong. Kết nối này không hỗ trợ xóa, nhân bản đối tượng hay thay đổi các thiết lập khác.

### Xác minh kết nối

```text theme={null}
Summarize my PRTG sensor and device counts and show the current down and warning sensors
```

Đối chiếu câu trả lời với PRTG. Bài kiểm tra kết nối thành công chỉ xác nhận trạng thái server, nên hãy kiểm tra thêm rằng CloudThinker nhìn thấy đúng các đối tượng giám sát bạn mong đợi.

### Ví dụ prompt

```text theme={null}
Which PRTG sensors are down, and what are their latest messages?
Show the last 24 hours of history for this sensor
```

## Khắc phục sự cố

> **PRTG rejected the API key**
>
> Kiểm tra key còn hiệu lực và được sao chép đúng. Nếu cần, tạo key mới trong PRTG rồi cập nhật kết nối.

> **PRTG answered with a redirect**
>
> Dùng đúng địa chỉ HTTPS của PRTG web server, không kèm đường dẫn. Kiểm tra cả API key.

> **Could not reach the PRTG server**
>
> Kiểm tra địa chỉ server, quyền truy cập mạng và chứng chỉ. CloudThinker yêu cầu chứng chỉ được tin cậy.

> **The API key's user cannot read the server status**
>
> Kiểm tra quyền của user PRTG và quyền truy cập vào server cùng các đối tượng giám sát.

## Bảo mật

* **Quyền tối thiểu** — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
* **Chỉ đọc theo mặc định** — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
* **Xoay vòng thông tin xác thực** — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
* **Thu hồi khi bàn giao** — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.

- **Bắt đầu với quyền đọc**: dùng key và tài khoản chỉ giới hạn ở những đối tượng CloudThinker cần.
- **Xem xét thay đổi**: dùng thiết lập Approval và quyền trong PRTG để kiểm soát các thao tác.

## Liên quan

> **[Approval mode](https://docs.cloudthinker.io/vi/guide/approvals/approval-mode.md)**
>
> Chọn cách phê duyệt thay đổi.

> **[Nguồn cảnh báo](https://docs.cloudthinker.io/vi/guide/incident/connect-alert-sources.md)**
>
> Gửi cảnh báo giám sát vào Resolve.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.