Chuyển đến nội dung chính
Kết nối SigNoz Cloud hoặc một instance SigNoz tự host để agent CloudThinker xếp hạng các operation chậm nhất của một service, tìm kiếm và nhóm log, mở toàn bộ trace waterfall, truy vấn metric, và rà soát alert rule cùng lịch sử của chúng. Bạn cung cấp cho CloudThinker hai giá trị: base URL của SigNoz và một API key của Service Account. Cách thiết lập giống nhau cho SigNoz Cloud và bản tự host.

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

  • Một instance SigNoz Cloud hoặc SigNoz tự host có ít nhất một service đã được instrument và đang gửi telemetry. SigNoz tạo service từ telemetry của ứng dụng, nên agent không thể tạo service giúp bạn.
  • Một user SigNoz có role SigNoz-Admin, có thể tạo Service Account và API key của account đó.
  • Base URL của SigNoz: https://<your-tenant>.signoz.cloud với SigNoz Cloud, hoặc địa chỉ bạn dùng để mở SigNoz với bản tự host, như https://signoz.internal.example.com.
  • Với SigNoz tự host: instance phải chấp nhận kết nối từ CloudThinker Cloud. Để đưa egress IP của CloudThinker vào allowlist, bạn cần danh sách hiện tại. 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ụ private để biết các lựa chọn khác.
  • Vai trò Admin trong workspace CloudThinker, cần thiết để thêm kết nối. Xem Vai trò.

Thiết lập

1

Tạo Service Account

Trong SigNoz, mở Settings → Service Accounts, nhấn New Service Account và đặt một tên dễ nhận ra về sau, như cloudthinker. Các bước giống nhau trên SigNoz Cloud và bản tự host.
2

Chọn role

Trên tab Overview của account, chọn role hẹp nhất trong danh sách Roles:Nhấn Save trước khi tạo key. SigNoz-Admin còn quản lý được user, role và service account, nên chỉ chọn role này khi thật sự cần.
3

Tạo API key

Mở tab Keys của account, nhấn Add Key, đặt tên (ví dụ cloudthinker-key), đặt thời hạn nếu chính sách của bạn yêu cầu, rồi sao chép key. SigNoz chỉ hiển thị key một lần.
4

Thêm kết nối trong CloudThinker

Trong thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn SigNoz. Điền:
  • SIGNOZ_URL: chỉ base URL, ví dụ https://<your-tenant>.signoz.cloud. Đừng thêm /api/v1 hay bất kỳ đường dẫn nào khác.
  • SIGNOZ_API_KEY: key bạn vừa sao chép.
  • LOG_LEVEL: giữ ở Info. Trường này quyết định mức chi tiết kết nối ghi vào log chẩn đoán của CloudThinker, đội hỗ trợ dùng log này khi xử lý sự cố.
Nhấn Connect.Trạng thái thành công: SigNoz hiển thị Connected.

Chi tiết kết nối

Quyền yêu cầu

Agent làm được đúng những gì role của Service Account cho phép, và SigNoz thực thi giới hạn đó.
  • SigNoz-Viewer đủ cho mọi thao tác đọc trong bảng khả năng bên dưới.
  • SigNoz-Editor thêm quyền ghi dashboard và alert. SigNoz không ghi rõ quyền của Editor với saved view hay notification channel, nên hãy dùng SigNoz-Admin cho các mục đó.
  • SigNoz-Admin thêm mọi quyền ghi, cùng quyền quản lý user, role và service account trong SigNoz.
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. Một Rule có thể buộc CloudThinker hỏi trước khi ghi, hoặc từ chối thẳng thao tác ghi.
Bắt đầu với SigNoz-Viewer. Chuyển sang SigNoz-Editor khi cần thay đổi dashboard và alert, và chỉ dùng SigNoz-Admin khi bạn muốn agent quản lý saved view hoặc channel thay bạn.

Khả năng của agent

Tìm kiếm log, trace và metric luôn chạy trong một khoảng thời gian. Agent bắt đầu với 15 phút gần nhất và mở rộng khi không có kết quả, nên hãy nêu khoảng thời gian trong prompt nếu bạn quan tâm tới một giai đoạn cụ thể.
Thao tác xóa trên SigNoz không thể hoàn tác: alert bị xóa mất toàn bộ lịch sử, còn xóa notification channel khiến các alert được định tuyến tới channel đó không còn nơi gửi. Agent hiển thị bản ghi hiện tại trước khi cập nhật hoặc xóa, nên hãy đọc kỹ trước khi phê duyệt.

Xác minh kết nối

Kết quả mong đợi: số lượng và một vài ví dụ về service, dashboard và alert rule, cùng số alert đang firing.

Ví dụ prompt

Khắc phục sự cố

SIGNOZ_URL có đường dẫn ở cuối. Hãy đặt trường này về base URL, như https://<your-tenant>.signoz.cloud, không kèm /api/v1.
Key sai, đã hết hạn hoặc đã bị thu hồi. Tạo key mới trên tab Keys của Service Account và cập nhật SIGNOZ_API_KEY.
Role của Service Account không cho phép thao tác đó. Key SigNoz-Viewer trả về lỗi này với mọi thao tác ghi. Key SigNoz-Editor có thể trả về lỗi này khi ghi saved view và notification channel, vì SigNoz không ghi rõ quyền của Editor với các mục đó. Hãy đổi role trong SigNoz nếu bạn muốn agent thực hiện thay đổi đó.
Không có gì khớp trong khoảng thời gian đã tìm. Hãy yêu cầu khoảng rộng hơn, như 6 giờ gần nhất, hoặc bỏ bộ lọc rồi thêm lại từng điều kiện một.
Instance SigNoz của bạn đang giới hạn tốc độ hoặc đang khởi động lại. Chờ một phút rồi hỏi lại. Với SigNoz tự host, hãy kiểm tra sức khỏe của query service.

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.
  • Một Service Account riêng cho CloudThinker: đừng dùng lại key của đồng nghiệp. Account riêng cho phép bạn thu hồi quyền của CloudThinker mà không ảnh hưởng tới ai khác.
  • Đặt thời hạn cho key: xoay vòng key và cập nhật SIGNOZ_API_KEY trước khi key hết hạn, nếu không kết nối sẽ ngừng hoạt động với lỗi 401.

Liên quan

Approvals

Quyết định thao tác ghi SigNoz nào được chạy, phải chờ người duyệt hoặc bị từ chối.

Grafana

Kết nối dashboard và data source của Grafana.