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.
Thiết lập
1
Tìm URL gốc
Dùng địa chỉ đứng trước 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
/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:{"status":"success","data":{"resultType":"vector".2
Chọn chế độ xác thực
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.
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:
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
Ví dụ prompt
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ố
Prometheus rejected the credentials
Prometheus rejected the credentials
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ự.
Prometheus has no query API at that URL
Prometheus has no query API at that URL
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ợ.That URL answered, but not as a Prometheus query API
That URL answered, but not as a Prometheus query API
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.
Prometheus is unreachable or didn't answer in time
Prometheus is unreachable or didn't answer in time
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.Truy vấn không trả về dữ liệu
Truy vấn không trả về dữ liệu
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
GETlà đủ. - Cấu hình chứa secret:
/api/v1/status/configcó 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