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
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.comhoặchttps://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
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.
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
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ố
Kết nối thất bại
Kết nối thất bại
- 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.
Xác thực thất bại hoặc lỗi 401
Xác thực thất bại hoặc lỗi 401
- 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.
Token hết hạn
Token hết hạn
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.
Agent không tìm thấy dashboard mà bạn thấy được
Agent không tìm thấy dashboard mà bạn thấy được
Dashboard nằm trong folder mà service account không xem được. Cấp cho service account quyền View trên folder đó.
Truy vấn data source thất bại
Truy vấn data source thất bại
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 đó.
Request tới Incident, OnCall hoặc Sift thất bại
Request tới Incident, OnCall hoặc Sift thất bại
Đâ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.