Điều kiện tiên quyết
- Một team Coralogix chứa dữ liệu bạn muốn agent đọc.
- Quyền tạo API key cho team đó.
- Region của team, đọc từ địa chỉ đăng nhập (xem bảng region).
Thiết lập
1
Xác định region
Đăng nhập Coralogix và đối chiếu thanh địa chỉ với bảng region. Một số region không có tên trong địa chỉ:
acme.coralogix.com là EU1, còn acme.app.cx498.coralogix.com là US2.2
Tạo API key
Vào Settings → API Keys và tạo key mới:
- Name:
cloudthinker - Type: Team key. Personal key gắn với một người dùng và ngừng hoạt động khi người đó mất quyền truy cập.
- Permissions: quyền đọc với dữ liệu mà agent cần truy cập (xem Quyền yêu cầu)
3
Thêm kết nối trong CloudThinker
Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections, rồi chọn Coralogix. Điền:
- CORALOGIX_API_KEY: key bạn vừa tạo
- CORALOGIX_REGION: chọn region trong danh sách, ví dụ EU2 (eu2.coralogix.com). Giá trị mặc định là US2 (us2.coralogix.com), nên hãy đổi nếu team của bạn ở region khác.
Chi tiết kết nối
Tìm địa chỉ đăng nhập ở cột bên trái, rồi chọn giá trị tương ứng ở cột bên phải:
Để truy cập team hoặc region khác, hãy thêm một kết nối riêng với key riêng.
Quyền yêu cầu
Cấp cho key quyền đọc với dữ liệu mà agent cần điều tra:
Đừng cấp quyền ghi cho key, trừ khi bạn muốn agent thay đổi tài nguyên Coralogix, chẳng hạn bật một parsing rule. Key chỉ đọc đủ cho mọi cuộc điều tra trên trang này.
Khả năng của agent
Agent không bao giờ thay đổi gì trong lúc khám phá, phân loại hay kiểm tra tình trạng. Thay đổi chỉ xảy ra khi bạn yêu cầu trong cuộc hội thoại, nêu rõ tài nguyên và nội dung thay đổi, và thay đổi đó đi qua Approvals. Theo mặc định, agent chỉ lấy tối đa 10 mục mẫu để danh mục lớn không làm ngập câu trả lời.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Kết nối thất bại hoặc request trả về 401
Kết nối thất bại hoặc request trả về 401
Key bị thiếu, đã hết hạn hoặc bị thu hồi. Tạo team key mới, sửa kết nối và dán key vào CORALOGIX_API_KEY.
Mọi request đều trả về 404
Mọi request đều trả về 404
Key thuộc một region khác. Kiểm tra địa chỉ đăng nhập và đổi CORALOGIX_REGION cho khớp.
Một số loại dữ liệu lỗi, số khác vẫn chạy
Một số loại dữ liệu lỗi, số khác vẫn chạy
Key thiếu quyền đọc với dữ liệu đó. Thêm quyền trong Coralogix, rồi chạy lại yêu cầu. Không cần kết nối lại nếu bản thân key không đổi.
Truy vấn metric không trả về gì
Truy vấn metric không trả về gì
Không có metric nào khớp với tên đó, hoặc team không gửi metric. Agent coi đây là kết quả rỗng. Hãy thử một tên metric bạn biết chắc tồn tại, hoặc tiếp tục với sự cố và log.
Request trả về 429 hoặc 503
Request trả về 429 hoặc 503
Coralogix đang giới hạn tần suất request hoặc đang bảo trì. Đợi một phút, thu hẹp yêu cầu, rồi hỏi lại.
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.
- Team key, ưu tiên quyền đọc: chỉ thêm quyền ghi cho những thay đổi bạn muốn agent có thể đề xuất.
- Mỗi kết nối một key: tạo key chỉ dành cho CloudThinker để bạn có thể thu hồi mà không làm hỏng công cụ khác.
Liên quan
Phân tích nguyên nhân gốc
Xem cách Resolve dùng log và trace để tìm ra thứ bị hỏng.
Approvals
Kiểm soát những thay đổi Coralogix nào phải chờ người duyệt.