Chuyển đến nội dung chính
Kết nối một team Coralogix để các agent CloudThinker phân loại sự cố đang mở, tìm kiếm log và trace, truy vấn metric, xem cảnh báo và dashboard, và kiểm tra data pipeline để tìm parsing rule bị tắt hoặc connector cấu hình sai. Kết nối dùng MCP server do Coralogix host, đăng nhập bằng một API key cho một region. Bạn chọn region và CloudThinker tự định tuyến tới endpoint Coralogix tương ứng, nên không cần nhập URL.

Đ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)
Sao chép key ngay. Nếu làm mất, bạn sẽ phải tạo key mớ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 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.
Nhấn Connect.Trạng thái thành công: Coralogix hiển thị Connected. Chạy prompt xác minh bên dưới để chắc chắn key và region khớp nhau.
Key chỉ hoạt động trong region nơi nó được tạo. Chọn sai region sẽ trả về 404 Not Found, trông giống như thiếu dữ liệu. Hãy kiểm tra địa chỉ đăng nhập trước khi debug bất cứ thứ gì 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

Kết quả mong đợi gồm số lượng sự cố, connector, parsing rule và preset, cùng một mẫu ngắn cho từng loại. Thông báo “No metrics matched” ở bước kiểm tra metric là bình thường: bước khám phá thử bằng một tên metric không tồn tại. Nếu bản tóm tắt báo degraded, agent sẽ liệt kê các bước kiểm tra thất bại: incidents, connectors, parsing rules, presets hoặc metrics. Bước nào thất bại thường có nghĩa key thiếu quyền đọc dữ liệu đó. Nếu mọi bước đều thất bại, hãy kiểm tra key và region trước.

Ví dụ prompt

Hãy nêu tên service và một khoảng thời gian ngắn. Truy vấn càng hẹp thì kết quả trả về càng nhanh và dễ đọc.

Khắc phục sự cố

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.
Key thuộc một region khác. Kiểm tra địa chỉ đăng nhập và đổi CORALOGIX_REGION cho khớp.
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.
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.
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.