> ## 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.

# UptimeRobot

> Kết nối UptimeRobot bằng Read-only API key để CloudThinker báo cáo monitor đang down, lịch sử uptime và sự cố gần đây.

Kết nối UptimeRobot và hỏi [CloudThinker](https://docs.cloudthinker.io/vi/guide/agents/overview.md) monitor nào đang down, uptime của một monitor tuần trước là bao nhiêu, hoặc sự cố nào xảy ra hôm qua. Kết nối dùng **Read-only API key** của UptimeRobot, vốn không thể tạo, thay đổi hoặc tạm dừng monitor, nên CloudThinker chỉ có thể xem.

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

* Một tài khoản UptimeRobot sở hữu các monitor bạn muốn CloudThinker đọc.
* Một **Read-only API Key** từ trang **Integrations & API** của tài khoản đó.
* Vai trò **Admin** trong workspace CloudThinker, cần thiết để thêm kết nối. Xem [Vai trò](https://docs.cloudthinker.io/vi/guide/security/roles.md).

> [!WARNING]
>
> Dùng **Read-only API key**, không bao giờ dùng **Main API key**. Main key có cùng quyền với tài khoản UptimeRobot của bạn. CloudThinker không kiểm tra bạn dán key nào. Với Main key, CloudThinker vẫn chỉ chạy ba thao tác đọc bên dưới, nhưng key đã lưu có thể thay đổi tài khoản của bạn nếu key bị lộ.

## Thiết lập

**1. Mở Integrations & API**

Đăng nhập UptimeRobot và vào **Integrations & API**.

**2. Sao chép Read-only API key**

Sao chép **Read-only API Key**. Bỏ qua Main API Key trên cùng trang. Nếu chưa có Read-only key, hãy tạo một key ở đó trước, rồi sao chép.

**3. Thêm kết nối trong CloudThinker**

Trong thanh bên, nhấn **More → Workspace settings → Connections**, giữ nguyên tab **Builtin Connections** và chọn **UptimeRobot**. Dán key vào **UPTIMEROBOT\_READ\_ONLY\_API\_KEY** và nhấn **Connect**.

**Trạng thái thành công:** thẻ UptimeRobot hiển thị **Connected**.

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

| Trường | Bắt buộc | Mô tả | Ví dụ |
| - | - | - | - |
| **UPTIMEROBOT\_READ\_ONLY\_API\_KEY** | Có | **Read-only API Key** từ **Integrations & API**, không phải Main API Key | `<your-read-only-key>` |

Không cần nhập region hay URL.

## Quyền yêu cầu

Read-only API key là toàn bộ thông tin xác thực cần có, và đã ở mức quyền tối thiểu: key đọc được monitor, thống kê monitor và sự cố, nhưng không thể tạo, thay đổi, tạm dừng hay xóa bất cứ thứ gì trong UptimeRobot.

> [!TIP]
>
> Nếu một tài khoản UptimeRobot thấy nhiều monitor hơn mức CloudThinker nên báo cáo, hãy tạo Read-only key từ một tài khoản chỉ được giới hạn trong các monitor đó.

## Khả năng của agent

CloudThinker cho phép ba thao tác đọc UptimeRobot trên kết nối này: liệt kê monitor, lấy thống kê monitor và liệt kê sự cố. CloudThinker kết hợp chúng thành các câu trả lời sau:

| Khả năng | Bạn nhận được gì |
| - | - |
| **Tình trạng tài khoản** | Monitor đang down hoặc bị tạm dừng, cùng các sự cố gần đây, trong một khoảng thời gian |
| **Danh sách monitor** | Các monitor cùng trạng thái và tình trạng tổng thể |
| **Uptime và thời gian phản hồi** | Thống kê uptime và giá trị thời gian phản hồi trong một khoảng thời gian |
| **Tóm tắt sự cố** | Các sự cố gần đây cùng trạng thái và thời điểm |

Mặc định CloudThinker xem 24 giờ gần nhất và trả về tối đa 10 mục, và bạn có thể yêu cầu tối đa 25. Khi danh sách bị cắt ngắn, CloudThinker sẽ nói rõ.

CloudThinker bỏ qua cài đặt monitor, custom header, log sự cố, liên hệ nhận cảnh báo và chi tiết tích hợp. CloudThinker không đọc được chi tiết sự cố hay danh sách tích hợp, vì những dữ liệu này có thể làm lộ thông tin liên hệ và webhook URL.

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

```text theme={null}
Check UptimeRobot for the last 24 hours and summarize monitors that are down or paused and any recent incidents
```

**Trạng thái thành công:** bạn nhận được bản tóm tắt tình trạng ngắn gọn, khớp với dashboard UptimeRobot. Danh sách sự cố trống là câu trả lời hợp lệ, không phải lỗi.

### Ví dụ prompt

```text theme={null}
Which UptimeRobot monitors are down right now?
What was the uptime of my API monitor over the last 7 days?
List yesterday's UptimeRobot incidents and which monitors they affected
```

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

> **Key bị từ chối**
>
> Key sai hoặc có ký tự thừa. Kiểm tra khoảng trắng quanh giá trị đã dán và xác nhận bạn đã sao chép **Read-only API Key** từ **Integrations & API**. Nếu vẫn thất bại, tạo Read-only key mới trong UptimeRobot và cập nhật kết nối.

> **Tình trạng hiển thị là không khả dụng**
>
> Thao tác đọc thống kê uptime thất bại, nên CloudThinker báo tình trạng là không khả dụng thay vì đoán. Hãy hỏi lại. Nếu UptimeRobot trả về 429, đợi ít nhất 60 giây trước.

> **Tôi đã dán Main API key**
>
> Hãy thay key đó. Sao chép **Read-only API Key** từ **Integrations & API**, mở kết nối UptimeRobot trong **More → Workspace settings → Connections** và cập nhật key. Để an toàn, hãy tạo lại Main key trong UptimeRobot sau đó.

> **429 Too Many Requests**
>
> UptimeRobot giới hạn số yêu cầu trong mỗi cửa sổ trượt 60 giây, tùy theo gói của bạn. Mọi công cụ dùng API của tài khoản đều chia sẻ giới hạn đó. Đợi 60 giây, rồi hỏi một câu hẹp hơn.

> **CloudThinker không thể tạm dừng hoặc thay đổi monitor**
>
> Đây là thiết kế có chủ đích. Read-only key không thể thực hiện thay đổi, và CloudThinker cũng không thử. Hãy thực hiện thay đổi trong UptimeRobot.

## 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.

- **Không bao giờ dùng Main API key**: key này mang cùng quyền với tài khoản UptimeRobot của bạn.
- **Giới hạn tốc độ dùng chung**: các công cụ khác trên cùng tài khoản dùng chung hạn mức yêu cầu.

## Liên quan

> **[Ứng phó sự cố (Resolve)](https://docs.cloudthinker.io/vi/guide/incident/overview.md)**
>
> Biến cảnh báo thành sự cố đã được điều tra

> **[Better Stack](https://docs.cloudthinker.io/vi/guide/connections/betterstack.md)**
>
> Thêm uptime, on-call và tìm kiếm log


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