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

# Coralogix

> Kết nối Coralogix với CloudThinker để tìm kiếm log, truy vấn số liệu, trace, phân loại sự cố và điều tra tình trạng pipeline

Kết nối tài khoản Coralogix của bạn để cho phép các agent CloudThinker tìm kiếm log, truy vấn số liệu và trace, phân loại sự cố và kiểm tra tình trạng data pipeline trên toàn bộ stack quan sát của bạn.

Coralogix xác thực bằng **API key** được giới hạn phạm vi theo **region**. CloudThinker tự động xác định endpoint Coralogix phù hợp từ region, nên cùng một cài đặt hoạt động được trên tất cả các trung tâm dữ liệu US, EU và AP.

***

## Các region được hỗ trợ

Chọn region phù hợp với tên miền đăng nhập của team Coralogix của bạn.

| Trung tâm dữ liệu | Các region          |
| ----------------- | ------------------- |
| US                | `us1`, `us2`, `us3` |
| Europe            | `eu1`, `eu2`        |
| Asia Pacific      | `ap1`, `ap2`, `ap3` |

***

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

* Một **tài khoản Coralogix** với quyền truy cập vào team bạn muốn điều tra.
* Một **API key** với quyền đọc cho dữ liệu quan sát mà CloudThinker cần tiếp cận.
* **Region** của team Coralogix của bạn.

<Info>
  Sử dụng API key với ít quyền nhất cần thiết để điều tra chỉ đọc. Quá trình xác minh kết nối của CloudThinker chỉ đọc dữ liệu — không bao giờ thay đổi tài nguyên Coralogix.
</Info>

***

## Thiết lập

<Steps>
  <Step title="Mở Coralogix">
    Đăng nhập vào tài khoản Coralogix của bạn. URL đăng nhập theo định dạng `https://<team>.app.<region>.coralogix.com` — phần `<region>` chính là region của bạn.
  </Step>

  <Step title="Tạo API key">
    Vào **Settings → Users and Teams → API Keys** và nhấn **Add key**:

    * **Name**: `cloudthinker`
    * **Type**: chọn **Team Key** — key này được chia sẻ và vẫn có hiệu lực ngay cả khi quyền truy cập của người tạo hết hạn, không như Personal Key chỉ gắn với cá nhân và dùng để kiểm thử
    * **Permissions**: cấp quyền đọc cho dữ liệu mà CloudThinker cần truy cập

    Sao chép key ngay lập tức — key có thể không hiển thị lại.
  </Step>

  <Step title="Thêm kết nối trong CloudThinker">
    Điều hướng đến **Connections → Coralogix** và nhập:

    * **API Key**: key vừa tạo
    * **Region**: region từ URL đăng nhập của bạn (ví dụ `eu2`)

    Nhấn **Connect**. CloudThinker xác minh thông tin xác thực và hiển thị trạng thái **Connected**.
  </Step>
</Steps>

<Warning>
  Sao chép API key ngay sau khi tạo. Bạn cần tạo key mới nếu mất key.
</Warning>

***

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

| Trường                  | Mô tả                                 | Ví dụ |
| ----------------------- | ------------------------------------- | ----- |
| **CORALOGIX\_API\_KEY** | Coralogix API key                     | —     |
| **CORALOGIX\_REGION**   | Region từ tên miền đăng nhập của team | `us2` |

<Note>
  CloudThinker suy ra endpoint Coralogix API từ region, vì vậy không cần cấu hình URL thủ công.
</Note>

***

## Quyền yêu cầu

Cấp cho API key quyền **đọc** đối với dữ liệu quan sát mà CloudThinker điều tra — log, số liệu, trace, sự cố, cảnh báo, connector, quy tắc phân tích cú pháp, preset và dashboard.

<Tip>
  Tuân theo nguyên tắc ít quyền nhất: key chỉ đọc là đủ để điều tra. Giữ các quyền thay đổi khỏi key mà CloudThinker sử dụng trừ khi luồng công việc ghi cụ thể yêu cầu.
</Tip>

***

## Khả năng của agent

Sau khi kết nối, các agent có quyền đọc dữ liệu quan sát Coralogix của bạn.

| Khả năng                 | Mô tả                                                                                                                                      |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Khám phá**             | Tóm tắt tình trạng tài khoản — sự cố đang hoạt động, số lượng connector, quy tắc phân tích cú pháp bị vô hiệu hóa và xử lý metric no-match |
| **Phân loại sự cố**      | Liệt kê và kiểm tra các sự cố đang hoạt động và ngữ cảnh của chúng                                                                         |
| **Log**                  | Tìm kiếm và phân tích log trong một khoảng thời gian                                                                                       |
| **Số liệu**              | Truy vấn số liệu và kiểm tra danh mục metric                                                                                               |
| **Trace**                | Kiểm tra distributed trace                                                                                                                 |
| **Tình trạng pipeline**  | Xem xét connector, quy tắc phân tích cú pháp và preset để tìm cấu hình sai                                                                 |
| **Cảnh báo & Dashboard** | Kiểm tra định nghĩa cảnh báo và dashboard                                                                                                  |

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

```text theme={null}
@alex run Coralogix discovery and summarize active incidents, connector count, disabled parsing rule count, and whether metric no-match handling is healthy
```

### Ví dụ lệnh

```text theme={null}
@alex triage active Coralogix incidents and #report anything affecting production
@alex search Coralogix logs for 5xx errors in the api-gateway over the last hour
@alex check Coralogix pipeline health and list any disabled parsing rules
```

<Note>
  Với các danh mục lớn hoặc nhiều nhiễu, hãy giới hạn yêu cầu bằng cửa sổ thời gian ngắn và truy vấn metric hoặc log cụ thể để agent trả về kết quả tập trung.
</Note>

***

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

<Accordion title="401 hoặc 403 Unauthorized">
  API key bị thiếu, hết hạn hoặc thiếu quyền yêu cầu. Tạo một Coralogix API key mới với quyền đọc cần thiết và kết nối lại.
</Accordion>

<Accordion title="404 Not Found">
  API key thuộc về một region Coralogix khác. Kiểm tra tên miền đăng nhập của team và cập nhật **CORALOGIX\_REGION** cho phù hợp.
</Accordion>

<Accordion title="Không tìm thấy số liệu">
  Danh mục metric không có metric phù hợp, hoặc tài khoản không có dữ liệu metric. Hãy coi đây là kết quả trống, rồi thử tên metric đã biết hoặc tiếp tục với sự cố và log.
</Accordion>

<Accordion title="Khám phá hiển thị trạng thái suy giảm">
  Một hoặc nhiều lệnh gọi danh sách Coralogix trả về lỗi. Kiểm tra quyền API key và region, rồi chạy lại khám phá.
</Accordion>

<Accordion title="Kết quả quá lớn hoặc quá nhiều dữ liệu">
  Các truy vấn danh mục hoặc sử dụng không giới hạn trả về quá nhiều dữ liệu. Giới hạn yêu cầu bằng cửa sổ thời gian ngắn và các truy vấn cụ thể để kết quả luôn tập trung.
</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.

- **Region đúng** — khớp region của API key với tên miền đăng nhập của team Coralogix; region không khớp gây lỗi 404.

***

## 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">
    Tìm kiếm log, số liệu và giám sát
  </Card>

  <Card title="Kết nối Better Stack" icon="https://mintcdn.com/cloudthinker/uIxpc0ZqZtveGXWt/images/icons/betterstack.svg?fit=max&auto=format&n=uIxpc0ZqZtveGXWt&q=85&s=61b580a94f2f0b8abd07eb7f494739c2" href="/vi/guide/connections/betterstack" width="24" height="24" data-path="images/icons/betterstack.svg">
    Uptime, sự cố và tìm kiếm log
  </Card>
</CardGroup>