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

# Grafana

> Kết nối Grafana với CloudThinker để tích hợp dashboard, phân tích metric và quan sát hợp nhất

Kết nối Grafana instance của bạn để cho phép các agent CloudThinker truy cập dashboard, truy vấn metric và tham chiếu trực quan hóa trong quá trình phân tích.

Grafana xác thực bằng **service account token** được giới hạn phạm vi theo role Viewer.

***

## Nền tảng hỗ trợ

| Nền tảng               | Hỗ trợ           |
| ---------------------- | ---------------- |
| **Grafana OSS**        | 9.x, 10.x        |
| **Grafana Enterprise** | Tất cả phiên bản |
| **Grafana Cloud**      | Tất cả các gói   |

***

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

* Một **Grafana instance** (OSS, Enterprise, hoặc Cloud) có thể truy cập từ CloudThinker.
* Quyền admin để tạo service account trong **Administration → Users and access → Service Accounts**.
* URL của Grafana instance.

***

## Thiết lập

<Steps>
  <Step title="Mở Grafana">
    Truy cập vào Grafana instance của bạn và đăng nhập với quyền admin.
  </Step>

  <Step title="Điều hướng đến service account">
    Vào **Administration → Users and access → Service Accounts**.
  </Step>

  <Step title="Tạo service account">
    Nhấn **Add service account** và nhập:

    * **Name**: `cloudthinker-readonly`
    * **Role**: Chọn **Viewer**

    Nhấn **Create** để tạo service account.
  </Step>

  <Step title="Tạo token">
    Trên trang service account mới:

    1. Nhấn **Add service account token**
    2. Nhập tên token (ví dụ: `cloudthinker-token`)
    3. Tùy chọn đặt ngày hết hạn
    4. Nhấn **Generate token**
    5. **Sao chép ngay token** — sẽ không được hiển thị lại
  </Step>

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

    * **Grafana URL**: URL instance của bạn (ví dụ: `https://grafana.your-domain.com`)
    * **Service Account Token**: token bạn vừa sao chép

    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 service account token ngay sau khi tạo. Grafana sẽ không hiển thị lại token này, và bạn sẽ cần tạo token mới nếu bị mất.
</Warning>

***

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

| Trường                               | Mô tả                        | Ví dụ                               |
| ------------------------------------ | ---------------------------- | ----------------------------------- |
| **GRAFANA\_URL**                     | URL Grafana instance của bạn | `https://your-instance.grafana.net` |
| **GRAFANA\_SERVICE\_ACCOUNT\_TOKEN** | Service account token đã tạo | `glsa_xxxxx...`                     |

***

## Quyền yêu cầu

| Role       | Tính năng cấp phép                                                             |
| ---------- | ------------------------------------------------------------------------------ |
| **Viewer** | Xem dashboard, truy vấn data source, xem annotation, truy cập nội dung thư mục |
| **Editor** | Quyền Viewer, cộng thêm tạo annotation và lưu dashboard snapshot               |

<Tip>
  Gán role **Viewer** để điều tra chỉ đọc. Chỉ dùng Editor nếu bạn cần tạo annotation hoặc dashboard snapshot.
</Tip>

***

## Khả năng của agent

Sau khi kết nối, các agent có thể:

| Khả năng               | Mô tả                                            |
| ---------------------- | ------------------------------------------------ |
| **Truy cập dashboard** | Tham chiếu dashboard hiện có trong phân tích     |
| **Truy vấn metric**    | Truy vấn data source thông qua Grafana           |
| **Đọc annotation**     | Truy cập annotation dashboard để lấy ngữ cảnh    |
| **Trạng thái alert**   | Kiểm tra trạng thái quy tắc alerting của Grafana |

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

```text theme={null}
@alex check Grafana for active alert rules and summarize any that are firing
```

### Ví dụ prompt

```text theme={null}
@alex check the AWS cost dashboard for anomalies
@kai reference the Kubernetes cluster dashboard for pod health
@tony query database metrics from the Grafana data source
```

### Data source được hỗ trợ

CloudThinker có thể truy vấn qua các data source đã cấu hình của Grafana:

| Data source   | Hỗ trợ truy vấn   |
| ------------- | ----------------- |
| Prometheus    | Truy vấn PromQL   |
| InfluxDB      | InfluxQL / Flux   |
| Elasticsearch | Lucene / KQL      |
| CloudWatch    | Metric CloudWatch |
| Loki          | Truy vấn LogQL    |

***

## Xử lý sự cố

<Accordion title="Kết nối thất bại">
  * Xác minh Grafana URL có thể truy cập từ CloudThinker.
  * Kiểm tra chứng chỉ SSL hợp lệ.
  * Đảm bảo không có proxy chặn kết nối.
  * Xác nhận Grafana đang chạy và có thể truy cập.
</Accordion>

<Accordion title="Xác thực thất bại">
  * Xác minh service account token chính xác.
  * Kiểm tra token chưa hết hạn.
  * Đảm bảo service account đang hoạt động.
  * Xác nhận không có hạn chế IP trên tài khoản.
</Accordion>

<Accordion title="Token hết hạn">
  * Điều hướng đến **Administration → Service Accounts**.
  * Chọn service account CloudThinker.
  * Tạo token mới.
  * Cập nhật token trong cài đặt kết nối CloudThinker.
</Accordion>

<Accordion title="Không thể truy cập dashboard">
  * Xác minh service account có role Viewer.
  * Kiểm tra quyền thư mục bao gồm service account.
  * Đảm bảo dashboard không nằm trong thư mục bị hạn chế.
</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.

- **Chỉ role Viewer** — không bao giờ cấp role Editor hoặc Admin cho service account CloudThinker
- **Thời hạn token** — đặt ngày hết hạn và xoay vòng service account token mỗi 90 ngày

***

## Liên quan

<CardGroup cols={2}>
  <Card title="Kết nối Elasticsearch" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/elasticsearch.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c7389cfcd0bc8d303aeeb68bd19199ca" href="/vi/guide/connections/elasticsearch" width="24" height="24" data-path="images/icons/elasticsearch.svg">
    Kết nối data source log
  </Card>

  <Card title="Kết nối AWS" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/aws.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=45d526a3e9345214c0345f277da2e829" href="/vi/guide/connections/aws" width="24" height="24" data-path="images/icons/aws.svg">
    Kết nối metric CloudWatch
  </Card>
</CardGroup>