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

> 인프라 모니터링, 알림, 성능 분석을 위해 Zabbix를 CloudThinker에 연결합니다

Zabbix 모니터링 플랫폼을 연결하면 CloudThinker 에이전트가 호스트를 관리하고, 문제를 분석하고, 유지보수 창을 처리하고, 인프라 모니터링 작업을 수행할 수 있습니다.

Zabbix는 **사용자 이름 및 비밀번호**(Zabbix 4.4+) 또는 **API 토큰**(Zabbix 5.4+)으로 인증합니다. 프로덕션 사용에는 API 토큰 인증이 권장됩니다.

***

## 지원 플랫폼

| 플랫폼              | 지원                                      |
| ---------------- | --------------------------------------- |
| **Zabbix**       | 4.4+ (사용자 이름/비밀번호 인증), 5.4+ (API 토큰 인증) |
| **Zabbix Cloud** | 모든 티어                                   |

***

## 사전 요구 사항

* CloudThinker에서 접근 가능한 **Zabbix 프런트엔드** (버전 4.4 이상).
* API 접근이 활성화된 **전용 Zabbix 사용자** 또는 **API 토큰** (Zabbix 5.4+).
* **Zabbix 프런트엔드 URL**.

***

## 설정

<Steps>
  <Step title="Zabbix에 로그인">
    관리자로 Zabbix 프런트엔드에 로그인합니다.
  </Step>

  <Step title="전용 사용자 생성">
    **Users → Users**로 이동하여 새 사용자를 생성합니다.

    * **Username**: `cloudthinker`
    * **Password**: 강력하고 고유한 비밀번호
    * **Role**: 전체 API 접근을 위한 Super Admin 역할, 또는 API 접근이 활성화된 커스텀 역할
  </Step>

  <Step title="API 토큰 생성 (Zabbix 5.4+ 권장)">
    **Administration → General → API Tokens**으로 이동하여 **Create API token**을 클릭합니다.

    * **Name**: `cloudthinker`
    * **User**: 위에서 생성한 사용자 선택
    * **Expires at**: 적절한 만료 날짜 설정

    토큰을 복사합니다 — 다시 표시되지 않습니다.
  </Step>

  <Step title="Zabbix URL 확인">
    Zabbix URL은 Zabbix 프런트엔드 주소입니다 (예: `https://zabbix.your-domain.com`).
  </Step>

  <Step title="CloudThinker에 연결 추가">
    **Connections → Zabbix**로 이동하여 다음을 입력합니다.

    * **Zabbix URL**: Zabbix 프런트엔드 URL
    * **Auth Type**: **Username & Password** 또는 **API Token** 선택
    * **Username / Password** 또는 **API Token**: 위에서 생성한 자격 증명

    **Connect**를 클릭합니다. CloudThinker가 자격 증명을 검증하고 **Connected** 상태를 표시합니다.
  </Step>
</Steps>

<Warning>
  API 토큰은 Zabbix 5.4 이상에서 필요합니다. 이전 버전의 경우 사용자 이름 및 비밀번호 인증을 사용하세요.
</Warning>

***

## 연결 세부 정보

| 필드                     | 설명                       | 예시                               |
| ---------------------- | ------------------------ | -------------------------------- |
| **ZABBIX\_URL**        | Zabbix 프런트엔드 URL         | `https://zabbix.your-domain.com` |
| **ZABBIX\_AUTH\_TYPE** | 인증 방법                    | `credentials` 또는 `token`         |
| **ZABBIX\_USERNAME**   | Zabbix 사용자 이름 (자격 증명 인증) | `cloudthinker`                   |
| **ZABBIX\_PASSWORD**   | Zabbix 비밀번호 (자격 증명 인증)   | —                                |
| **ZABBIX\_TOKEN**      | Zabbix API 토큰 (토큰 인증)    | —                                |

***

## 필수 권한

**최소 (읽기 전용 모니터링):**

* Zabbix API 접근이 활성화된 사용자 역할
* 모니터링할 호스트 그룹에 대한 읽기 접근

**권장 (전체 운영):**

* Super Admin 역할 또는 API 접근이 활성화된 커스텀 역할, 호스트·템플릿·트리거·이벤트에 대한 읽기/쓰기 접근, 유지보수 창 생성 및 수정 권한

<Tip>
  최소 권한 원칙을 따르세요. 사용 사례에 맞게 CloudThinker에 필요한 호스트 그룹과 권한만 부여하세요.
</Tip>

***

## 에이전트 기능

연결 후 에이전트는 Zabbix 환경 전반에서 모니터링 및 운영 작업을 수행할 수 있습니다.

| 기능          | 설명                             |
| ----------- | ------------------------------ |
| **호스트 관리**  | 모니터링 호스트 목록 조회, 검사, 활성화 및 비활성화 |
| **문제 분석**   | 활성 문제 조회, 패턴 분석, 이벤트 연관        |
| **트리거 관리**  | 알림 트리거 구성 보기 및 수정              |
| **유지보수 창**  | 알림을 억제하기 위한 유지보수 기간 생성 및 관리    |
| **템플릿 작업**  | 호스트 전반에 모니터링 템플릿 검사 및 적용       |
| **대시보드 접근** | Zabbix 대시보드 및 그래프 데이터 조회       |

### 연결 확인

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

### 예시 프롬프트

```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
```

***

## 문제 해결

<Accordion title="연결 거부">
  CloudThinker에서 Zabbix URL에 접근할 수 있는지 확인하세요. 포트 80 또는 443에서 인바운드 연결이 허용되는지 방화벽 규칙을 확인하고 Zabbix 프런트엔드가 실행 중인지 확인하세요.
</Accordion>

<Accordion title="인증 실패">
  사용자 이름과 비밀번호가 올바른지, 사용자 계정이 잠기거나 비활성화되지 않았는지 확인하세요. API 토큰 인증의 경우 토큰이 만료되지 않았고 사용자 역할에 API 접근이 활성화되어 있는지 확인하세요.
</Accordion>

<Accordion title="권한 거부">
  사용자가 요청된 작업에 충분한 권한을 갖고 있는지 확인하세요. 사용자에게 호스트 그룹 접근 권한이 부여되어 있는지 확인하세요. 쓰기 작업의 경우 역할이 API 쓰기 접근을 허용하는지 확인하세요.
</Accordion>

<Accordion title="API 토큰 만료">
  Zabbix의 **Administration → API Tokens**으로 이동하여 만료된 토큰을 삭제하고 새 토큰을 생성하세요. CloudThinker 연결 설정에서 토큰을 업데이트하세요.
</Accordion>

***

## 보안

* **최소 권한** — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
* **기본 읽기 전용** — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
* **자격증명 교체** — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
* **오프보딩 시 취소** — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.

- **자격 증명보다 API 토큰** — 더 나은 감사 추적을 위해 사용자 이름/비밀번호 대신 API 토큰 인증 (Zabbix 5.4+)을 사용하세요.
- **토큰 만료 설정** — API 토큰에 적절한 만료 날짜를 구성하고 일정에 따라 교체하세요.

***

## 관련 항목

<CardGroup cols={2}>
  <Card title="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="/ko/guide/connections/grafana" width="24" height="24" data-path="images/icons/grafana.svg">
    Grafana에서 Zabbix 메트릭 시각화
  </Card>

  <Card title="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="/ko/guide/connections/elasticsearch" width="24" height="24" data-path="images/icons/elasticsearch.svg">
    Zabbix 로그를 Elasticsearch로 전달
  </Card>
</CardGroup>