Chuyển đến nội dung chính
Kết nối Zabbix để agent của CloudThinker phân loại các problem đang hoạt động, đọc metric và log item của host, xem trigger, template và dashboard, và nếu bạn cho phép, xác nhận event hoặc lên lịch bảo trì. Kết nối đăng nhập vào Zabbix API bằng API token hoặc username và password, và agent chỉ làm được những gì người dùng Zabbix đó được phép làm.

Đ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.
Nhấn Connect. CloudThinker đăng nhập và liệt kê host để kiểm tra thông tin xác thực.Trạng thái thành công: kết nối hiển thị trạng thái Connected. Trạng thái này chỉ chứng minh việc đăng nhập, vì vậy hãy chạy prompt trong mục Xác minh kết nối ở một cuộc chat mới để kiểm tra các host bạn mong đợi đều hiển thị.

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.
Tránh dùng Super admin. Super admin bỏ qua quyền trên host group và có thể tạo, thay đổi user, nên chỉ một lần phê duyệt nhầm, dù do người hay do AI đánh giá, cũng có thể chạm tới mọi host và tài khoản. Nếu bắt buộc phải dùng, hãy chọn Manual để có người phê duyệt mọi thay đổi. Khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Deny cho thao tác tạo user trên Zabbix có thể chặn hẳn thao tác đó.
Hãy bắt đầu với role loại User và quyền Read trên các host group bạn quan tâm. Mọi thao tác ghi vẫn đi qua Approvals, nhưng với người dùng Zabbix chỉ đọc, không lần phê duyệt nào, dù nhầm hay tự động, có thể thay đổi được gì.

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.
Maintenance window do agent tạo bắt đầu ngay lập tức, và cảnh báo của các host đó bị chặn cho đến khi window kết thúc. Bạn không thể đặt thời điểm bắt đầu trong tương lai, nên hãy yêu cầu đúng lúc công việc bắt đầu. Kiểm tra danh sách host và thời lượng trong yêu cầu phê duyệt trước khi duyệt. Xóa host hoặc gỡ liên kết template kèm dữ liệu là không thể hoàn tác.

Xác minh kết nối

Hỏi CloudThinker trong một cuộc chat mới:
Bạn sẽ nhận được phiên bản Zabbix server, số host kèm một vài host mẫu, các host group, và problem đang hoạt động nhóm theo mức độ nghiêm trọng. Nếu thiếu host, group của user không đọc được host group chứa các host đó.

Ví dụ prompt

Prompt cuối cần role loại Admin với quyền Read-write trên host group đó, và phải đi qua Approvals trước. Ở chế độ Manual, yêu cầu chờ người duyệt; ở chế độ Auto mặc định, AI có thể đánh giá và cho chạy mà không hỏi.

Khắc phục sự cố

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.
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.
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.
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 đó.
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ố.