Điều kiện tiên quyết
- Zabbix frontend mà CloudThinker truy cập được qua internet, ví dụ
https://zabbix.example.com. Nếu frontend nằm sau tường lửa hoặc phải giữ ở mạng riêng, xem Truy cập dịch vụ riêng. - Một Super admin của Zabbix có quyền tạo user, user group và API token.
- Zabbix 5.4 trở lên nếu bạn muốn dùng API token. Các phiên bản cũ hơn dùng username và password.
- Vai trò Admin trong workspace CloudThinker, vai trò cần để thêm kết nối. Xem Vai trò.
Thiết lập
1
Tạo role có quyền truy cập API
Vào Users → User roles (trong Zabbix 6.x là Administration → User roles) và nhấn Create user role. Đặt tên
CloudThinker, đặt User type là User (hoặc Admin nếu cần ghi, xem Quyền yêu cầu), bảo đảm Access to API đang bật, rồi nhấn Add.2
Tạo user group có quyền vào host group
Vào Users → User groups (trong 6.x là Administration → User groups) và nhấn Create user group. Đặt tên
CloudThinker. Trên tab Host permissions (trong 6.x là Permissions), chọn các host group mà agent cần thấy, chọn Read, rồi nhấn Add.3
Tạo user
Vào Users → Users (trong 6.x là Administration → Users) và tạo user tên
cloudthinker trong group CloudThinker. Trên tab Permissions, chọn role CloudThinker, rồi nhấn Add.4
Tạo API token (Zabbix 5.4+)
Vào Users → API tokens (trong Zabbix 5.4 đến 6.x là Administration → General → API tokens) và nhấn Create API token. Chọn user
cloudthinker, đặt Expires at khớp với lịch xoay vòng của bạn, rồi nhấn Add. Sao chép token. Zabbix chỉ hiển thị token một lần.Với phiên bản cũ hơn 5.4, bỏ qua bước này và dùng password của user.5
Thêm kết nối trong CloudThinker
Ở thanh bên, nhấn More → Workspace settings → Connections, chọn Zabbix, rồi điền:
- ZABBIX_URL: URL của Zabbix frontend, ví dụ
https://zabbix.example.com. - ZABBIX_AUTH_TYPE: chuyển sang API Token. Mặc định là Username & Password, nhưng token có thể hết hạn và bị thu hồi mà không cần đổi password.
- ZABBIX_TOKEN, hoặc ZABBIX_USERNAME và ZABBIX_PASSWORD: thông tin xác thực từ các bước trên. CloudThinker chỉ hiển thị các trường của kiểu xác thực bạn đã chọn.
Chi tiết kết nối
Biểu mẫu hiển thị tên các trường đúng như viết dưới đây.Quyền yêu cầu
Zabbix quyết định quyền truy cập ở hai nơi: role của user (user thuộc loại nào, và có dùng được API không) và user group của user (đọc hoặc thay đổi được những host group nào). Agent chỉ thấy host trong các host group mà user group đọc được.Khả năng của agent
Agent dùng thang mức độ nghiêm trọng của Zabbix: Not classified, Information, Warning, Average, High, Disaster.
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.
Vì vậy, ở chế độ mặc định, agent có thể tạo maintenance window, xóa host hoặc tạo user mà không ai thấy. Hãy chọn Manual để có người phê duyệt mọi thay đổi, đó là biện pháp kiểm soát hoạt động được ngay hôm nay. Khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Ask first có thể thu hẹp việc chờ duyệt về đúng các thao tác đó: trong cuộc chat, gõ
/create-policy Ask first for maintenance windows, host deletes and user creation on the Zabbix connection, rồi chấp nhận Rule trong Approvals → Rules → Needs review.
Xác minh kết nối
Hỏi CloudThinker trong một cuộc chat mới:Ví dụ prompt
Khắc phục sự cố
Failed to connect to Zabbix
Failed to connect to Zabbix
CloudThinker không đăng nhập hoặc không liệt kê được host. Kiểm tra ZABBIX_URL là địa chỉ frontend và CloudThinker truy cập được, ZABBIX_AUTH_TYPE khớp với thông tin xác thực bạn đã nhập, và role của user đã bật quyền truy cập API.
Lỗi 401, hoặc phiên đăng nhập hết hạn
Lỗi 401, hoặc phiên đăng nhập hết hạn
Token đã hết hạn hoặc bị xóa, hoặc password đã thay đổi. Tạo token mới trong API tokens và cập nhật ZABBIX_TOKEN, hoặc cập nhật password.
Thiếu host hoặc problem
Thiếu host hoặc problem
Group của user không có quyền trên host group đó, nên Zabbix bỏ các host đó ra. Cấp quyền Read trên host group trong phần quyền của user group.
Thao tác ghi thất bại với lỗi quyền (403)
Thao tác ghi thất bại với lỗi quyền (403)
User có role loại User hoặc chỉ có quyền Read trên host group. Đổi role sang loại Admin và cấp Read-write nếu bạn muốn agent thực hiện thay đổi đó.
Lỗi 429, 500 hoặc 503
Lỗi 429, 500 hoặc 503
Zabbix API đang giới hạn tần suất, gặp lỗi, hoặc đang bảo trì. Chờ một phút, rồi đặt câu hỏi hẹp hơn, giới hạn trong một host hoặc host group.
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.
- Ưu tiên API token: token thuộc về một user, có thời hạn riêng, và có thể thu hồi mà không cần đổi password.
- Giới hạn theo host group: chỉ cấp quyền cho user group của CloudThinker trên các host group mà agent cần.
Liên quan
Rule phê duyệt
Quyết định thao tác ghi Zabbix nào được chạy, phải chờ người duyệt, hoặc bị từ chối.
Tích hợp webhook
Gửi cảnh báo Zabbix vào Resolve dưới dạng sự cố.