Chuyển đến nội dung chính
Kết nối Prometheus để CloudThinker chạy truy vấn PromQL, liệt kê metric và label, kiểm tra tình trạng scrape target, và đọc cảnh báo đang hoạt động cùng các alert rule. Kết nối này chỉ đọc và xác thực bằng một trong ba cách: không xác thực, bearer token hoặc HTTP Basic auth.

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

Quy tắc: endpoint phải trả lời <your URL>/api/v1/query ngay tại gốc địa chỉ, với không xác thực, bearer token hoặc HTTP Basic auth.

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

  • Prometheus HTTP API truy cập được từ internet. Kết nối chạy từ CloudThinker Cloud, không chạy bên trong mạng của bạn.
  • Chứng chỉ TLS được tin cậy công khai nếu URL dùng HTTPS. Không có trường nào để thêm CA riêng.
  • Bearer token hoặc username và password, nếu proxy hay gateway đặt trước Prometheus yêu cầu.
  • Quyền thêm kết nối trong workspace CloudThinker của bạn.
Prometheus chạy trong Kubernetes với địa chỉ riêng? Hãy công khai Prometheus qua một ingress có TLS và một auth proxy kiểm tra bearer token hoặc Basic auth, rồi đưa các egress IP của CloudThinker vào danh sách cho phép. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối liên hệ CloudThinker của bạn, hoặc liên hệ với chúng tôi. Xem Truy cập dịch vụ riêng để biết các lựa chọn khác.
URL không được chứa đường dẫn. Endpoint chỉ trả lời dưới một tiền tố, như https://metrics.example.com/prometheus/api/v1, sẽ không qua được bài kiểm tra kết nối. Hãy công khai API tại gốc của một hostname.

Thiết lập

1

Tìm URL gốc

Dùng địa chỉ đứng trước /api/v1, không có đường dẫn và không có dấu gạch chéo ở cuối, ví dụ https://prometheus.example.com hoặc http://prometheus.example.com:9090.Kiểm tra từ terminal trước khi kết nối:
Chạy lệnh từ một máy bên ngoài mạng của bạn, với đúng thông tin xác thực bạn sẽ cung cấp cho CloudThinker.Trạng thái thành công: phản hồi bắt đầu bằng {"status":"success","data":{"resultType":"vector".
2

Chọn chế độ xác thực

Prometheus để lộ cấu hình đã nạp, hostname nội bộ và địa chỉ target cho bất kỳ ai truy cập được. Chỉ dùng None khi có quy tắc tường lửa chỉ cho phép các egress IP của CloudThinker. Không bao giờ dùng None cho endpoint mở với toàn bộ internet.
3

Thêm kết nối

Ở thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn Prometheus. Điền:
  • Alias (tùy chọn): tên ngắn như prod-metrics. Chỉ gồm chữ thường, số và dấu gạch ngang.
  • Description (tùy chọn): Prometheus này bao phủ những gì. Khi bạn kết nối nhiều instance, agent đọc phần mô tả để chọn đúng instance.
  • PROMETHEUS_URL: URL gốc ở bước 1.
  • PROMETHEUS_AUTH_TYPE: None, Bearer Token hoặc Basic Auth, rồi điền các trường thông tin xác thực hiện ra.
  • LOG_LEVEL: giữ ở Info.
Nhấn Connect. CloudThinker chạy count(up) trên endpoint, hiển thị Connecting và Verifying, rồi chuyển sang trạng thá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 mục Khắc phục sự cố.

Chi tiết kết nối

Quyền yêu cầu

Prometheus không có phân quyền người dùng sẵn có, nên quyền truy cập là những gì proxy hoặc gateway của bạn cho phép. CloudThinker cần quyền đọc (GET) dưới /api/v1/ cho:
Nếu proxy hỗ trợ, hãy cấp cho CloudThinker token riêng chỉ được gửi yêu cầu GET dưới /api/v1/. Kết nối không ghi bất cứ thứ gì vào Prometheus.

Khả năng của agent

Khi kết nối lần đầu đạt trạng thái Connected, CloudThinker chạy discovery chỉ đọc trên endpoint và lưu những gì học được cho các cuộc chat sau.

Xác minh kết nối

Câu trả lời đúng sẽ cho số target theo trạng thái, số cảnh báo đang kích hoạt, và vài tên metric mẫu từ endpoint của bạn.

Ví dụ prompt

Hãy nêu tên metric và các label bạn quan tâm. CloudThinker liệt kê được tên label, nên prompt như “split by namespace” sẽ cho selector chính xác nhanh hơn. Để chuyển cảnh báo Prometheus vào Resolve và tự động mở sự cố, hãy thiết lập tích hợp webhook.

Khắc phục sự cố

Endpoint trả về 401 hoặc 403. Kiểm tra PROMETHEUS_AUTH_TYPE khớp với yêu cầu của proxy, rồi nhập lại token hoặc username và password. Token bị thu hồi ở proxy cũng thất bại theo cách tương tự.
Endpoint trả về 404. Nhiều khả năng URL chứa đường dẫn, như /api/v1 hoặc /prometheus. Chỉ nhập scheme, host và port. Nếu API của bạn chỉ trả lời dưới một tiền tố, cấu hình đó không được hỗ trợ.
Một thành phần đứng trước Prometheus đã trả lời thay, thường là trang đăng nhập hoặc SSO proxy. Hãy trỏ URL tới chính API, hoặc dùng bearer token hay Basic auth mà proxy chấp nhận không cần đăng nhập qua trình duyệt.
CloudThinker không mở được kết nối. Kiểm tra hostname, port và chứng chỉ TLS, và xác nhận endpoint nhận lưu lượng từ internet. CloudThinker không truy cập được địa chỉ riêng như 10.0.0.5.
Trước tiên, yêu cầu CloudThinker liệt kê các metric khớp với một tên để xác nhận metric tồn tại. Sau đó mở rộng khoảng thời gian, vì truy vấn theo khoảng bắt đầu từ 15 phút.

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.
  • Không ghi: kết nối chỉ đọc Prometheus HTTP API, nên token chỉ được gửi yêu cầu GET là đủ.
  • Cấu hình chứa secret: /api/v1/status/config có thể chứa thông tin xác thực dùng để scrape và hostname nội bộ. Hãy chặn đường dẫn này ở proxy nếu bạn không muốn nó bị đọc.

Liên quan

Kết nối Grafana

Dashboard và alert rule dựa trên metric của bạn

Kết nối Kubernetes

Ghép metric với các workload tạo ra chúng