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

# Sentry

> Kết nối Sentry bằng OAuth để agent tìm kiếm issue, đọc event và trace, và gắn lỗi mới với một release

Kết nối Sentry để các agent CloudThinker tìm kiếm issue, đọc event và trace đằng sau các issue đó, và lấy tín hiệu nguyên nhân gốc khi xử lý sự cố và phân loại release. Bạn đăng nhập Sentry một lần qua OAuth, nên không cần tạo hay dán auth token.

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

* Tài khoản Sentry thuộc organization và team mà bạn muốn agent điều tra.
* Quyền ủy quyền app bên thứ ba trong organization đó.
* Dịch vụ Sentry lưu trữ tại sentry.io. Kết nối luôn đi qua MCP server do Sentry lưu trữ và không có trường URL, nên Sentry tự host không thể kết nối.
* 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).

## Thiết lập

**1. Bắt đầu kết nối**

Mở **More → Workspace settings → Connections**, chọn **Sentry** và nhấn **Connect**. CloudThinker mở trang ủy quyền của Sentry.

**2. Ủy quyền cho CloudThinker**

Đăng nhập tài khoản Sentry thấy được đúng organization, rồi chấp thuận quyền truy cập. Nếu trình duyệt đang đăng nhập một tài khoản Sentry khác, hãy đăng xuất trước.

**3. Quay lại CloudThinker**

Sentry đưa bạn về CloudThinker, nơi lưu token cho bạn.

**Trạng thái thành công:** kết nối hiển thị **Connected**. Chạy prompt trong [Xác minh kết nối](#xác-minh-kết-nối) trong một chat mới để xem tài khoản tiếp cận được project nào.

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

Không có trường nào cần điền.

| Mục | Giá trị |
| - | - |
| **Authentication** | OAuth. Sentry cấp token và CloudThinker lưu trữ |
| **Endpoint** | `https://mcp.sentry.dev/mcp`, MCP server do Sentry lưu trữ |

## Quyền yêu cầu

Agent thấy các organization, project và team mà tài khoản Sentry ủy quyền thấy. CloudThinker không thể thu hẹp quyền này, nên để giới hạn những gì agent tiếp cận, hãy ủy quyền bằng tài khoản chỉ thuộc các team bạn muốn điều tra.

> [!TIP]
>
> Các khả năng bên dưới đều là thao tác đọc. MCP server của Sentry quyết định có những công cụ nào khác, và CloudThinker coi mọi công cụ mà server không đánh dấu là chỉ đọc là thao tác ghi. Chọn **Manual** để có người phê duyệt mọi thay đổi. Khi CloudThinker bật [Rule enforcement](https://docs.cloudthinker.io/vi/guide/approvals/rules.md#khắc-phục-sự-cố) cho workspace của bạn, một [Rule](https://docs.cloudthinker.io/vi/guide/approvals/rules.md) **Deny** có thể từ chối thẳng các thao tác ghi đó.

Mọi thay đổi do agent thực hiện đều đi qua [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) của workspace trước. Ở chế độ mặc định **Auto · Rules + AI · Ask me**, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật [Rule enforcement](https://docs.cloudthinker.io/vi/guide/approvals/rules.md#khắc-phục-sự-cố) cho workspace của bạn. Chọn **Manual** nếu bạn muốn tự phê duyệt mọi thay đổi.

## Khả năng của agent

| Khả năng | Agent có thể làm gì |
| - | - |
| **Xác định phạm vi** | Liệt kê organization, project và team để chọn nơi tìm |
| **Tìm issue** | Tìm và kiểm tra issue trên các project |
| **Event và trace** | Đọc từng event và distributed trace đằng sau một issue |
| **Tín hiệu nguyên nhân gốc** | Lấy stack trace, tag và ngữ cảnh mà Sentry gắn vào issue |
| **Phân loại release** | Đối chiếu lỗi mới với các release gần đây |

Agent kết hợp Sentry với các kết nối khác trong quá trình điều tra. Ví dụ, agent có thể khớp một đợt tăng đột biến của issue Sentry với một lần deploy trong hệ thống CI hoặc một thay đổi metric trong công cụ giám sát. Xem [Phân tích nguyên nhân gốc](https://docs.cloudthinker.io/vi/guide/incident/root-cause-analysis.md).

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

Hỏi CloudThinker trong một chat mới:

```text theme={null}
List my Sentry projects and summarize the top unresolved issues
```

Bạn sẽ thấy các project mà tài khoản ủy quyền thấy được, mỗi project kèm các issue chưa giải quyết hàng đầu và tần suất xuất hiện. Project bạn mong đợi nhưng không thấy nằm ngoài quyền truy cập của tài khoản đó.

### Ví dụ prompt

```text theme={null}
New Sentry errors in the payments project since the last release, ranked by affected users
Show the trace behind the checkout timeout issue and where it spends the most time
Which issues regressed in release 2.14.0 of web, and which tags (browser, region) do they share?
```

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

> **Luồng OAuth không hoàn tất**
>
> Có thể trình duyệt đang đăng nhập sai tài khoản Sentry, hoặc chưa đăng nhập. Đăng nhập đúng tài khoản trong Sentry, rồi nhấn **Connect** lần nữa.

> **Agent không tìm thấy project bạn mong đợi**
>
> Tài khoản ủy quyền không phải thành viên của team hoặc organization của project đó. Thêm tài khoản vào team đó trong Sentry, hoặc ngắt kết nối và kết nối lại bằng tài khoản có quyền truy cập.

> **Kết nối từng hoạt động rồi ngừng**
>
> Có thể quyền truy cập đã bị thu hồi trong Sentry. Mở kết nối Sentry, nhấn **Connect** và ủy quyền lại bằng cùng tài khoản. Kết nối giữ nguyên agent, cài đặt và bộ nhớ. Để chuyển sang tài khoản khác, hãy ngắt kết nối và kết nối lại.

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

- **Giới hạn theo tài khoản**: kết nối thấy đúng những gì tài khoản Sentry ủy quyền thấy. Dùng tài khoản riêng chỉ thuộc một số ít team để agent không chạm tới các project không cần thiết.
- **Thu hồi khi không dùng**: gỡ CloudThinker trong **User Settings → Authorized Applications** ở Sentry (`sentry.io/settings/account/authorizations/`), rồi xóa kết nối trong CloudThinker.

## Liên quan

> **[Rollbar](https://docs.cloudthinker.io/vi/guide/connections/rollbar.md)**
>
> Lỗi hàng đầu, deployment và session replay.

> **[Phân tích nguyên nhân gốc](https://docs.cloudthinker.io/vi/guide/incident/root-cause-analysis.md)**
>
> Cách agent truy ngược một sự cố về nguyên nhân gây ra.


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