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

# Better Stack

> Kết nối Better Stack với CloudThinker để giám sát uptime, phân loại sự cố, xem lịch trực và tìm kiếm log

Kết nối tài khoản Better Stack của bạn để cho phép các agent CloudThinker giám sát uptime, phân loại sự cố, xem lịch trực và tìm kiếm log. Better Stack sử dụng **OAuth** — bạn ủy quyền cho CloudThinker một lần từ bên trong Better Stack, được giới hạn phạm vi theo team bạn chọn.

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

* Một **tài khoản Better Stack** với quyền truy cập vào team bạn muốn kết nối.
* Quyền ủy quyền ứng dụng bên thứ ba cho team đó.

<Info>
  OAuth giới hạn kết nối theo những gì người dùng Better Stack của bạn đã có thể xem. Kết nối với người dùng ít quyền nhất mà vẫn hoạt động được.
</Info>

## Thiết lập

<Steps>
  <Step title="Mở CloudThinker">
    Điều hướng đến **Connections → Better Stack** trong workspace CloudThinker của bạn.
  </Step>

  <Step title="Bắt đầu luồng OAuth">
    Nhấn **Connect** để mở trang ủy quyền của Better Stack.
  </Step>

  <Step title="Ủy quyền cho CloudThinker">
    Đăng nhập, chọn team cần kết nối và chấp nhận quyền truy cập.
  </Step>

  <Step title="Quay lại CloudThinker">
    Bạn sẽ được chuyển hướng trở lại. Kết nối hiển thị trạng thái **Connected**.
  </Step>
</Steps>

<Tip>
  Để chuyển team hoặc thu hồi quyền truy cập, hãy ngắt kết nối trong CloudThinker và kết nối lại, hoặc xóa ủy quyền trong cài đặt ứng dụng Better Stack.
</Tip>

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

Better Stack sử dụng OAuth — không có trường thông tin xác thực nào để lưu trữ. CloudThinker giữ authorization token do Better Stack cấp sau khi bạn phê duyệt quyền truy cập.

## Quyền yêu cầu

CloudThinker kế thừa khả năng hiển thị của người dùng ủy quyền trong team đã kết nối.

* **Các thao tác đọc** (monitor, sự cố, lịch trực, log, số liệu) hoạt động với quyền thành viên tiêu chuẩn.
* **Các thao tác ghi** (xác nhận sự cố, đăng báo cáo, chỉnh sửa dashboard hoặc cảnh báo) cần quyền Better Stack phù hợp **và** [phê duyệt](/vi/guide/approval) rõ ràng trong CloudThinker.

## Khả năng của agent

Sau khi kết nối, các agent có quyền đọc trên hai bề mặt Better Stack và quyền ghi được kiểm soát bởi phê duyệt.

**Uptime**

| Danh mục             | Chức năng của agent                                                         |
| -------------------- | --------------------------------------------------------------------------- |
| **Monitor**          | Liệt kê monitor, kiểm tra % khả dụng và thời gian phản hồi trong một cửa sổ |
| **Heartbeat**        | Kiểm tra heartbeat cron/scheduled-job và tỷ lệ hit                          |
| **Sự cố**            | Liệt kê và kiểm tra sự cố, timeline, bình luận và tùy chọn leo thang        |
| **Lịch trực**        | Xem lịch trực, ca hiện tại và sự kiện ca trực                               |
| **Leo thang**        | Kiểm tra chính sách leo thang và định nghĩa mức độ nghiêm trọng             |
| **Trang trạng thái** | Liệt kê trang trạng thái, các thành phần được theo dõi và báo cáo trước đây |

**Telemetry**

| Danh mục                | Chức năng của agent                                                |
| ----------------------- | ------------------------------------------------------------------ |
| **Log**                 | Tìm kiếm log theo phạm vi nguồn, kiểm tra trường và cấu hình nguồn |
| **Số liệu**             | Truy vấn số liệu và kiểm tra cardinality                           |
| **Dashboard & Biểu đồ** | Liệt kê và kiểm tra dashboard, biểu đồ và template                 |
| **Cảnh báo**            | Liệt kê và kiểm tra cảnh báo biểu đồ                               |
| **Lỗi**                 | Liệt kê các lỗi gần đây và kiểm tra nhóm lỗi                       |

**Các thao tác ghi (được kiểm soát bởi phê duyệt)**

| Danh mục                | Chức năng của agent                                               |
| ----------------------- | ----------------------------------------------------------------- |
| **Sự cố**               | Xác nhận, giải quyết, mở lại, leo thang, bình luận hoặc tạo sự cố |
| **Trang trạng thái**    | Đăng báo cáo và cập nhật trang trạng thái                         |
| **Dashboard & Biểu đồ** | Tạo, chỉnh sửa, đổi tên hoặc xóa dashboard và biểu đồ             |
| **Cảnh báo**            | Tạo, chỉnh sửa, xóa hoặc tạm dừng cảnh báo biểu đồ                |
| **Lỗi**                 | Cập nhật trạng thái lỗi (giải quyết / bỏ qua)                     |

<Warning>
  Các thao tác ghi thay đổi giám sát trực tiếp và trạng thái sự cố. CloudThinker yêu cầu [phê duyệt](/vi/guide/approval) rõ ràng, nêu tên tài nguyên, trước khi bất kỳ thao tác ghi nào được thực thi.
</Warning>

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

```text theme={null}
@alex list open Better Stack incidents and #alert on anything hitting production
```

### Ví dụ lệnh

```text theme={null}
@alex summarize Better Stack incidents from the last 24h and #recommend follow-ups
@alex search api-gateway logs for 5xx in the last hour and #chart by status code
@alex report 24h availability for production monitors
```

<Note>
  Tìm kiếm log **được giới hạn theo nguồn**, nên không có tìm kiếm toàn cục. Hãy nêu tên nguồn (ví dụ `api-gateway`) để agent có thể xác định trước khi truy vấn.
</Note>

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

<Accordion title="Kết nối thất bại với 401 Unauthorized">
  OAuth token đã hết hạn hoặc quyền truy cập không đủ. Ngắt kết nối và kết nối lại.
</Accordion>

<Accordion title="Tài nguyên trả về 404 Not Found">
  Tài nguyên thuộc về một team khác hoặc đã bị xóa. Liệt kê lại trong team đã kết nối để lấy ID hiện tại.
</Accordion>

<Accordion title="Yêu cầu thất bại với 429 Too Many Requests">
  Bạn đã đạt giới hạn tốc độ của Better Stack. Các agent tự động dừng và thử lại.
</Accordion>

<Accordion title="Truy vấn log trả về lỗi cú pháp">
  Better Stack sử dụng cú pháp Live Tail. Yêu cầu agent tải hướng dẫn truy vấn cho nguồn, rồi tinh chỉnh.
</Accordion>

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

- **Người dùng ít quyền nhất** — ủy quyền chỉ với quyền truy cập mà CloudThinker cần; giới hạn tư cách thành viên team của người dùng ủy quyền theo những gì CloudThinker cần xem.
- **Thu hồi khi không dùng** — xóa ủy quyền trong cài đặt ứng dụng Better Stack nếu bạn ngừng sử dụng kết nối.

## Liên quan

<CardGroup cols={2}>
  <Card title="Kết nối Datadog" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/datadog.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=e8382167f2a1eb1e00971b5f4d703d48" href="/vi/guide/connections/datadog" width="24" height="24" data-path="images/icons/datadog.svg">
    Quan sát và giám sát
  </Card>

  <Card title="Kết nối PagerDuty" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/pagerduty.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=cdc34a966d5d46da70c3bc509a2a7492" href="/vi/guide/connections/pagerduty" width="24" height="24" data-path="images/icons/pagerduty.svg">
    Cảnh báo sự cố và lịch trực
  </Card>
</CardGroup>