메인 콘텐츠로 건너뛰기
Zabbix 모니터링 플랫폼을 연결하면 CloudThinker 에이전트가 호스트를 관리하고, 문제를 분석하고, 유지보수 창을 처리하고, 인프라 모니터링 작업을 수행할 수 있습니다. Zabbix는 사용자 이름 및 비밀번호(Zabbix 4.4+) 또는 API 토큰(Zabbix 5.4+)으로 인증합니다. 프로덕션 사용에는 API 토큰 인증이 권장됩니다.

​
지원 플랫폼

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

​
사전 요구 사항

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

​
설정

1

Zabbix에 로그인

관리자로 Zabbix 프런트엔드에 로그인합니다.
2

전용 사용자 생성

Users → Users로 이동하여 새 사용자를 생성합니다.
  • Username: cloudthinker
  • Password: 강력하고 고유한 비밀번호
  • Role: 전체 API 접근을 위한 Super Admin 역할, 또는 API 접근이 활성화된 커스텀 역할
3

API 토큰 생성 (Zabbix 5.4+ 권장)

Administration → General → API Tokens으로 이동하여 Create API token을 클릭합니다.
  • Name: cloudthinker
  • User: 위에서 생성한 사용자 선택
  • Expires at: 적절한 만료 날짜 설정
토큰을 복사합니다 — 다시 표시되지 않습니다.
4

Zabbix URL 확인

Zabbix URL은 Zabbix 프런트엔드 주소입니다 (예: https://zabbix.your-domain.com).
5

CloudThinker에 연결 추가

Connections → Zabbix로 이동하여 다음을 입력합니다.
  • Zabbix URL: Zabbix 프런트엔드 URL
  • Auth Type: Username & Password 또는 API Token 선택
  • Username / Password 또는 API Token: 위에서 생성한 자격 증명
Connect를 클릭합니다. CloudThinker가 자격 증명을 검증하고 Connected 상태를 표시합니다.
API 토큰은 Zabbix 5.4 이상에서 필요합니다. 이전 버전의 경우 사용자 이름 및 비밀번호 인증을 사용하세요.

​
연결 세부 정보

필드설명예시
ZABBIX_URLZabbix 프런트엔드 URLhttps://zabbix.your-domain.com
ZABBIX_AUTH_TYPE인증 방법credentials 또는 token
ZABBIX_USERNAMEZabbix 사용자 이름 (자격 증명 인증)cloudthinker
ZABBIX_PASSWORDZabbix 비밀번호 (자격 증명 인증)—
ZABBIX_TOKENZabbix API 토큰 (토큰 인증)—

​
필수 권한

최소 (읽기 전용 모니터링):
  • Zabbix API 접근이 활성화된 사용자 역할
  • 모니터링할 호스트 그룹에 대한 읽기 접근
권장 (전체 운영):
  • Super Admin 역할 또는 API 접근이 활성화된 커스텀 역할, 호스트·템플릿·트리거·이벤트에 대한 읽기/쓰기 접근, 유지보수 창 생성 및 수정 권한
최소 권한 원칙을 따르세요. 사용 사례에 맞게 CloudThinker에 필요한 호스트 그룹과 권한만 부여하세요.

​
에이전트 기능

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

​
연결 확인

@alex list Zabbix hosts and summarize active problem count by severity

​
예시 프롬프트

@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

​
문제 해결

CloudThinker에서 Zabbix URL에 접근할 수 있는지 확인하세요. 포트 80 또는 443에서 인바운드 연결이 허용되는지 방화벽 규칙을 확인하고 Zabbix 프런트엔드가 실행 중인지 확인하세요.
사용자 이름과 비밀번호가 올바른지, 사용자 계정이 잠기거나 비활성화되지 않았는지 확인하세요. API 토큰 인증의 경우 토큰이 만료되지 않았고 사용자 역할에 API 접근이 활성화되어 있는지 확인하세요.
사용자가 요청된 작업에 충분한 권한을 갖고 있는지 확인하세요. 사용자에게 호스트 그룹 접근 권한이 부여되어 있는지 확인하세요. 쓰기 작업의 경우 역할이 API 쓰기 접근을 허용하는지 확인하세요.
Zabbix의 Administration → API Tokens으로 이동하여 만료된 토큰을 삭제하고 새 토큰을 생성하세요. CloudThinker 연결 설정에서 토큰을 업데이트하세요.

​
보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 자격 증명보다 API 토큰 — 더 나은 감사 추적을 위해 사용자 이름/비밀번호 대신 API 토큰 인증 (Zabbix 5.4+)을 사용하세요.
  • 토큰 만료 설정 — API 토큰에 적절한 만료 날짜를 구성하고 일정에 따라 교체하세요.

​
관련 항목

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

Grafana 연결

Grafana에서 Zabbix 메트릭 시각화
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

Elasticsearch 연결

Zabbix 로그를 Elasticsearch로 전달