Chuyển đến nội dung chính
Kết nối một Grafana instance để CloudThinker làm việc từ chính các dashboard, data source và alert rule mà đội bạn đang có. Agent tìm đúng dashboard, chạy truy vấn Prometheus hoặc Loki qua Grafana, và cho bạn biết cảnh báo nào đang firing, mà bạn không cần sao chép panel vào chat. Kết nối đăng nhập bằng service account token, một danh tính Grafana không phải người mà bạn tạo và giới hạn ở role Viewer.

Nền tảng được hỗ trợ

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

  • Grafana instance truy cập được từ internet công khai qua HTTPS. Kết nối chạy từ CloudThinker Cloud, nên instance riêng tư cần một trong các cách trong Truy cập dịch vụ riêng tư. Nếu bạn đặt firewall, hãy cho phép IP egress của CloudThinker. Tài liệu này không công bố danh sách IP egress của CloudThinker: hãy hỏi đầu mối CloudThinker của bạn, hoặc liên hệ chúng tôi.
  • Chứng chỉ TLS hợp lệ, được tin cậy công khai. Chứng chỉ self-signed sẽ thất bại.
  • Quyền admin Grafana để tạo service account.
  • Mỗi organization Grafana một kết nối. Service account chỉ thấy organization nơi nó được tạo, nên với nhiều org, hãy tạo service account trong từng org và thêm kết nối cho từng org.
  • Vai trò Admin trong workspace CloudThinker, là vai trò được thêm và sửa kết nối. Xem Vai trò.

Thiết lập

1

Tạo service account Viewer

Trong Grafana, vào Administration → Users and access → Service accounts và nhấn Add service account. Đặt:
  • Display name: cloudthinker-readonly
  • Role: Viewer
Nhấn Create.
2

Tạo token

Trên trang của service account mới, nhấn Add service account token, đặt tên (ví dụ cloudthinker), đặt thời hạn như 90 ngày, rồi nhấn Generate token. Khi token hết hạn, kết nối thất bại với lỗi 401 cho tới khi bạn thay token. Xem Token hết hạn.Sao chép token ngay. Token bắt đầu bằng glsa_, và Grafana sẽ không hiển thị lại.
3

Thêm kết nối trong CloudThinker

Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn Grafana. Điền:
  • GRAFANA_URL: base URL của instance, ví dụ https://grafana.example.com hoặc https://your-stack.grafana.net
  • GRAFANA_SERVICE_ACCOUNT_TOKEN: token glsa_
  • Alias và Description: không bắt buộc. Agent đọc phần mô tả để chọn đúng instance, nên hãy ghi tên org hoặc môi trường nếu bạn thêm nhiều kết nối
Nhấn Connect.Trạng thái thành công: kết nối hiển thị Connecting và Verifying, rồi Connected. Nếu xác minh thất bại, kết nối hiển thị Failed kèm thông báo lỗi. Đối chiếu thông báo với Khắc phục sự cố.

Chi tiết kết nối

Quyền yêu cầu

Agent chỉ thấy những gì service account thấy. Nếu một folder dashboard bị giới hạn quyền, hãy thêm service account vào folder đó, nếu không agent sẽ không tìm thấy dashboard bên trong.
Giữ service account ở role Viewer. Khi đó Grafana tự từ chối mọi thay đổi ở phía mình, bất kể agent yêu cầu gì.

Khả năng của agent

Agent truy vấn qua Grafana, nên data source chỉ dùng được khi đã được cấu hình trong Grafana instance và service account có quyền dùng. Khi Grafana đã kết nối, Resolve cũng đọc được alert rule và truy vấn khoảng metric trong lúc điều tra sự cố. Gửi cảnh báo Grafana vào Resolve là một thiết lập webhook riêng: xem Tích hợp webhook.

Xác minh kết nối

Kết quả mong đợi là tên và trạng thái các rule đang firing (hoặc ghi chú rằng không có rule nào firing), sau đó là từng data source kèm loại, như Prometheus hay Loki.

Ví dụ prompt

Quyền ghi

Kết nối có thể gọi các công cụ Grafana làm thay đổi, như sửa dashboard, thêm annotation hay đổi alert rule. Mọi lệnh gọi làm thay đổi đều đi qua Approvals, và Grafana chỉ cho phép khi role của service account cho phép. Với Viewer, Grafana từ chối tất cả. Mọi thay đổi do agent thực hiện đều đi qua Approvals 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 cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi. Kết nối này không có công tắc Allow writes, nên CloudThinker không có cài đặt chỉ đọc riêng ở đây. Role Grafana của service account là thứ chặn thao tác ghi, vì vậy hãy giữ role Viewer trừ khi bạn muốn thay đổi.

Khắc phục sự cố

  • Mở GRAFANA_URL từ trình duyệt bên ngoài mạng của bạn để kiểm tra URL truy cập được từ internet, hoặc cho phép CloudThinker qua firewall.
  • Kiểm tra chứng chỉ TLS hợp lệ và không phải self-signed.
  • Chỉ dùng base URL, không kèm đường dẫn dashboard.
  • Kiểm tra lại token. Sao chép lại nếu bị mất ký tự.
  • Kiểm tra token chưa hết hạn và service account đang được bật trong Administration → Users and access → Service accounts.
Mở service account trong Grafana, tạo token mới, rồi dán vào GRAFANA_SERVICE_ACCOUNT_TOKEN trên kết nối. Xóa token cũ trong Grafana.
Dashboard nằm trong folder mà service account không xem được. Cấp cho service account quyền View trên folder đó.
Việc bạn truy cập được trong Explore không chứng minh service account cũng truy cập được. Kiểm tra hai điều:
  • Trên Grafana Enterprise hoặc Cloud, mở tab Permissions của data source và xác nhận service account (hoặc một role mà service account có) được phép truy vấn.
  • Kiểm tra dưới danh nghĩa service account: curl -H "Authorization: Bearer glsa_..." https://<grafana>/api/datasources. Nếu data source không có trong phản hồi, service account không dùng được data source đó.
Agent chỉ truy vấn được những data source mà chính Grafana truy vấn được.
Đây là các tính năng của Grafana Cloud. Chúng chỉ hoạt động khi stack của bạn đã bật. Một số ứng dụng Grafana Cloud có role truy cập riêng, nên nếu Viewer không đủ, hãy kiểm tra cài đặt role của ứng dụng đó cho service account trong Grafana.

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ỉ Viewer: cấp cho service account CloudThinker role Viewer, không bao giờ Admin.
  • Token có thời hạn: đặt thời hạn cho mọi token và xoay vòng theo lịch thông thường của bạn.

Liên quan

Prometheus

Truy vấn Prometheus trực tiếp khi không đặt sau Grafana.

Tích hợp webhook

Gửi cảnh báo Grafana vào Resolve để cuộc điều tra tự bắt đầu.