Đ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.cloudvớ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/v1hay 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ố.
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.
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ể.
Xác minh kết nối
Ví dụ prompt
Khắc phục sự cố
Mọi request đều trả về 404
Mọi request đều trả về 404
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.403 Forbidden
403 Forbidden
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 đó.
Tìm kiếm log hoặc trace không trả về gì
Tìm kiếm log hoặc trace không trả về gì
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.
Lỗi 429 hoặc 503
Lỗi 429 hoặc 503
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.