> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Zabbix

> Kết nối Zabbix với CloudThinker để giám sát cơ sở hạ tầng, cảnh báo và phân tích hiệu suất

Kết nối nền tảng giám sát Zabbix của bạn để cho phép các agent CloudThinker quản lý host, phân tích sự cố, xử lý maintenance window và thực hiện các thao tác giám sát cơ sở hạ tầng.

Zabbix xác thực bằng **tên đăng nhập và mật khẩu** (Zabbix 4.4+) hoặc **API token** (Zabbix 5.4+). Xác thực bằng API token được ưu tiên cho môi trường production.

***

## Các nền tảng được hỗ trợ

| Nền tảng         | Hỗ trợ                                                            |
| ---------------- | ----------------------------------------------------------------- |
| **Zabbix**       | 4.4+ (xác thực tên đăng nhập/mật khẩu), 5.4+ (xác thực API token) |
| **Zabbix Cloud** | Tất cả các cấp                                                    |

***

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

* Một **Zabbix frontend** (phiên bản 4.4 trở lên) có thể truy cập từ CloudThinker.
* Một **người dùng Zabbix riêng** với quyền truy cập API được bật, hoặc một **API token** (Zabbix 5.4+).
* **URL Zabbix frontend** của bạn.

***

## Thiết lập

<Steps>
  <Step title="Đăng nhập Zabbix">
    Đăng nhập vào Zabbix frontend với quyền admin.
  </Step>

  <Step title="Tạo người dùng riêng">
    Vào **Users → Users** và tạo người dùng mới:

    * **Username**: `cloudthinker`
    * **Password**: mật khẩu mạnh, duy nhất
    * **Role**: vai trò Super Admin (yêu cầu để truy cập API đầy đủ) hoặc vai trò tùy chỉnh với quyền truy cập API được bật
  </Step>

  <Step title="Tạo API token (khuyến nghị cho Zabbix 5.4+)">
    Vào **Administration → General → API Tokens** và nhấn **Create API token**:

    * **Name**: `cloudthinker`
    * **User**: chọn người dùng vừa tạo ở trên
    * **Expires at**: đặt ngày hết hạn phù hợp

    Sao chép token — nó sẽ không hiển thị lại.
  </Step>

  <Step title="Tìm URL Zabbix của bạn">
    URL Zabbix là địa chỉ của Zabbix frontend, ví dụ `https://zabbix.your-domain.com`.
  </Step>

  <Step title="Thêm kết nối trong CloudThinker">
    Điều hướng đến **Connections → Zabbix** và nhập:

    * **Zabbix URL**: URL Zabbix frontend của bạn
    * **Auth Type**: chọn **Username & Password** hoặc **API Token**
    * **Username / Password** hoặc **API Token**: thông tin xác thực vừa tạo

    Nhấn **Connect**. CloudThinker xác minh thông tin xác thực và hiển thị trạng thái **Connected**.
  </Step>
</Steps>

<Warning>
  API token yêu cầu Zabbix 5.4 trở lên. Với các phiên bản cũ hơn, hãy dùng xác thực tên đăng nhập và mật khẩu.
</Warning>

***

## Chi tiết kết nối

| Trường                 | Mô tả                                       | Ví dụ                            |
| ---------------------- | ------------------------------------------- | -------------------------------- |
| **ZABBIX\_URL**        | URL Zabbix frontend của bạn                 | `https://zabbix.your-domain.com` |
| **ZABBIX\_AUTH\_TYPE** | Phương thức xác thực                        | `credentials` hoặc `token`       |
| **ZABBIX\_USERNAME**   | Tên đăng nhập Zabbix (xác thực credentials) | `cloudthinker`                   |
| **ZABBIX\_PASSWORD**   | Mật khẩu Zabbix (xác thực credentials)      | —                                |
| **ZABBIX\_TOKEN**      | Zabbix API token (xác thực token)           | —                                |

***

## Quyền yêu cầu

**Tối thiểu (giám sát chỉ đọc):**

* Vai trò người dùng với quyền truy cập Zabbix API được bật
* Quyền đọc đối với các nhóm host bạn muốn giám sát

**Khuyến nghị (hoạt động đầy đủ):**

* Vai trò Super Admin hoặc vai trò tùy chỉnh với quyền truy cập API được bật, quyền đọc/ghi đối với host, template, trigger và sự kiện, và quyền tạo và sửa đổi maintenance window

<Tip>
  Tuân theo nguyên tắc ít quyền nhất: chỉ cấp các nhóm host và quyền mà CloudThinker cần cho trường hợp sử dụng của bạn.
</Tip>

***

## Khả năng của agent

Sau khi kết nối, các agent có thể thực hiện các tác vụ giám sát và vận hành trên toàn bộ môi trường Zabbix của bạn.

| Khả năng               | Mô tả                                                           |
| ---------------------- | --------------------------------------------------------------- |
| **Quản lý host**       | Liệt kê, kiểm tra, bật và tắt các host được giám sát            |
| **Phân tích sự cố**    | Lấy các sự cố đang hoạt động, phân tích mẫu, tương quan sự kiện |
| **Quản lý trigger**    | Xem và sửa đổi cấu hình alert trigger                           |
| **Maintenance window** | Tạo và quản lý các khoảng thời gian bảo trì để tắt cảnh báo     |
| **Thao tác template**  | Kiểm tra và áp dụng template giám sát trên các host             |
| **Truy cập dashboard** | Lấy dashboard Zabbix và dữ liệu đồ thị                          |

### Xác minh kết nối

```text theme={null}
@alex list Zabbix hosts and summarize active problem count by severity
```

### Ví dụ lệnh

```text theme={null}
@alex list all Zabbix hosts with active problems and their severity
@alex analyze active Zabbix problems with severity >= High and #recommend remediation steps
@oliver review Zabbix trigger configurations for security-related alerts
```

***

## Khắc phục sự cố

<Accordion title="Kết nối bị từ chối">
  Xác minh URL Zabbix có thể truy cập từ CloudThinker. Kiểm tra quy tắc firewall để đảm bảo cho phép kết nối đến trên cổng 80 hoặc 443, và xác nhận Zabbix frontend đang chạy.
</Accordion>

<Accordion title="Xác thực thất bại">
  Xác minh tên đăng nhập và mật khẩu đúng và tài khoản người dùng không bị khóa hoặc vô hiệu hóa. Với xác thực API token, hãy xác minh token chưa hết hạn và người dùng có quyền truy cập API được bật trong vai trò của họ.
</Accordion>

<Accordion title="Quyền bị từ chối">
  Xác minh người dùng có đủ quyền cho các thao tác yêu cầu. Kiểm tra quyền truy cập nhóm host được cấp cho người dùng. Với các thao tác ghi, xác nhận vai trò cho phép quyền ghi API.
</Accordion>

<Accordion title="API token đã hết hạn">
  Vào **Administration → API Tokens** trong Zabbix, xóa token đã hết hạn và tạo token mới. Cập nhật token trong cài đặt kết nối CloudThinker.
</Accordion>

***

## 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.

- **API token thay vì credentials** — dùng xác thực API token (Zabbix 5.4+) thay vì tên đăng nhập/mật khẩu để dễ kiểm tra hơn.
- **Đặt ngày hết hạn token** — cấu hình ngày hết hạn phù hợp cho API token và xoay vòng theo lịch.

***

## Liên quan

<CardGroup cols={2}>
  <Card title="Kết nối Grafana" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/grafana.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c1329049025cd3c3a0909b400baef7be" href="/vi/guide/connections/grafana" width="24" height="24" data-path="images/icons/grafana.svg">
    Hiển thị số liệu Zabbix trong Grafana
  </Card>

  <Card title="Kết nối Elasticsearch" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/elasticsearch.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c7389cfcd0bc8d303aeeb68bd19199ca" href="/vi/guide/connections/elasticsearch" width="24" height="24" data-path="images/icons/elasticsearch.svg">
    Chuyển tiếp log Zabbix sang Elasticsearch
  </Card>
</CardGroup>