vCenter를 Zabbix에 연동해서 모니터링하려면 방화벽 포트 오픈, Zabbix 서버 Config 수정, 호스트 등록, 매크로 설정까지 5분이면 기본 연결을 마칠 수 있습니다. Zabbix 5.0.4부터는 VMware 전용 템플릿이 내장되어 있어 별도 에이전트 설치 없이 vCenter API를 통해 ESXi 하이퍼바이저와 가상 머신의 성능 데이터를 수집할 수 있습니다. 아래 순서대로 따라 하면 됩니다.
연동 전 필수 확인사항 방화벽과 Zabbix 버전
Zabbix가 vCenter와 통신하려면 네트워크 단에서 두 개의 포트가 열려 있어야 합니다. 내부망에서 방화벽을 운영 중이라면 vCenter 서버 IP 기준으로 TCP 443과 TCP 10050을 허용해야 합니다. vCenter 외에 다른 서버(VCM, DB, AD 등)에 대한 방화벽 허용은 필요하지 않습니다.
Zabbix 버전이 5.0 이상이라면 VMware 연동을 위한 템플릿이 기본 포함되어 있습니다. 만약 5.0 미만 버전을 사용 중이라면 업그레이드를 권장합니다. 최소 요구 vCenter 또는 vSphere 버전은 5.1입니다.
- 필수 오픈 포트: vCenter 서버 기준 TCP 443, TCP 10050
- Zabbix 최소 버전: 5.0 이상 (5.0.4부터 VMware 템플릿 개선)
- vCenter 최소 버전: 5.1
Zabbix 서버 설정 파일 수정 (StartVMwareCollectors)
Zabbix 서버가 vCenter에서 데이터를 수집하려면 zabbix_server.conf 파일에서 VMware 관련 파라미터를 활성화해야 합니다. 설정 파일 위치는 일반적으로 /etc/zabbix/zabbix_server.conf 입니다.
vi 편집기로 파일을 열고 아래 항목을 찾아 주석을 해제한 후 값을 변경합니다.
StartVMwareCollectors=5
VMwareFrequency=60
VMwarePerfFrequency=60
VMwareCacheSize=2048M
VMwareTimeout=10
각 항목의 의미는 다음과 같습니다. - StartVMwareCollectors: VMware 데이터 수집 프로세스 개수입니다. 모니터링하는 vCenter 서비스 수보다 많게 설정하는 것이 좋습니다. 일반적으로 모니터링 대상 서비스 수의 1배-2배 사이로 설정합니다. 예를 들어 vCenter 1대라면 2-3, 3대라면 5 정도가 적절합니다. - VMwareCacheSize: 수집한 데이터를 저장할 캐시 메모리 크기입니다. 기본값 512MB보다 큰 환경에서는 2048M(2GB)를 추천합니다. - VMwareFrequency: vCenter 설정 데이터(호스트, VM 목록 등) 수집 주기(초)입니다. - VMwarePerfFrequency: 성능 카운터 데이터 수집 주기(초)입니다.
설정을 저장한 후 Zabbix 서버를 재시작해야 변경 사항이 적용됩니다.
systemctl restart zabbix-server
vCenter 호스트 등록 및 매크로 설정
Zabbix 웹 화면에서 설정 → 호스트로 이동한 후 우측 상단 호스트 작성 버튼을 클릭합니다.
- 호스트명: 식별 가능한 이름 입력 (예: vCenter-Production)
- 에이전트 인터페이스: vCenter 서버의 IP 주소 또는 FQDN 입력
- 그룹: VMware 또는 기존 그룹 선택 (문자열 입력 시 자동 생성)
- 템플릿:
Template VM VMware검색 후 선택
매크로 탭에서 vCenter 접속 정보를 입력해야 합니다. Zabbix 버전 5.0 기준으로 아래 형식을 따릅니다.
| 매크로 | 값 |
|---|---|
| {$VMWARE.URL} | https://vCenter_IP_or_FQDN/sdk |
| {$VMWARE.USERNAME} | vCenter 읽기 전용 계정 |
| {$VMWARE.PASSWORD} | 위 계정의 비밀번호 |
vCenter에는 Zabbix 전용 읽기 전용 계정을 만들어 사용하는 것이 보안상 좋습니다. vCenter에서 zabbix-monitor 같은 계정을 생성하고, 최소한의 읽기 권한만 부여하세요.
데이터 수집 확인과 그래프 커스터마이징
호스트 등록 후 약 2시간 이내에 Zabbix가 vCenter로부터 데이터를 수집하기 시작합니다. 수집되는 항목은 ESXi 하이퍼바이저의 CPU/메모리 사용률, 네트워크 트래픽, 데이터스토어 용량, 가상 머신 상태 등입니다.
Zabbix가 기본 제공하는 그래프는 VMware 전용이 아니므로 데이터가 제대로 표시되지 않을 수 있습니다. 직접 커스텀 그래프를 만들어야 유의미한 값을 볼 수 있습니다.
커스텀 그래프 생성 방법
1. 설정 → 호스트에서 등록한 vCenter 호스트 선택
2. 상단 메뉴에서 그래프 탭 클릭
3. 우측 상단 그래프 작성 버튼 클릭
4. 그래프 이름 입력 후 아이템 추가에서 원하는 VMware 아이템 선택
- 예: vmware.hv.cpu.usage, vmware.hv.memory.usage, vmware.hv.network.in
5. 저장 후 모니터링 → 최신 데이터에서 그래프 확인
Guest VM 모니터링 비활성화와 주의점
vCenter를 연동하면 ESXi 호스트뿐 아니라 모든 Guest VM도 자동으로 호스트로 등록됩니다. Template VM VMware Hypervisor 템플릿이 적용된 VM들이 생기는데, 이는 vCenter에서 제공하는 성능 정보를 그대로 가져오는 방식입니다.
하지만 Guest VM의 실제 OS 상태(프로세스, 디스크, 서비스 등)를 모니터링하려면 에이전트 설치가 따로 필요합니다. vCenter API를 통해 수집된 데이터는 OS 내부 정보가 아니므로 실제 사용률과 차이가 있을 수 있습니다.
불필요한 Guest VM 호스트는 Zabbix DB 사용률에 영향을 줄 수 있으므로, 모니터링 대상이 아니라면 비활성화 후 삭제 처리하는 것이 좋습니다. 비활성화 방법은 해당 호스트 상세 페이지에서 비활성화 버튼을 누르면 됩니다.
FAQ
Q. Zabbix에서 VMware 데이터가 전혀 수집되지 않습니다. 무엇을 확인해야 하나요?
A. 가장 먼저 확인할 것은 방화벽과 네트워크 연결입니다. vCenter 서버에서 telnet Zabbix_Server_IP 10050과 curl -k https://vCenter_IP/sdk로 연결 테스트를 해보세요. 다음으로 zabbix_server.conf에서 StartVMwareCollectors 값이 0이 아닌지, Zabbix 서버가 재시작되었는지 확인합니다. 마지막으로 vCenter 계정의 권한이 읽기 전용이라도 최소한의 읽기 권한이 부여되었는지 점검하세요.
Q. vCenter를 여러 대 연동할 때 Collector 수는 어떻게 설정하나요?
A. Zabbix 공식 문서에 따르면 Collector 수는 모니터링하는 vCenter 서비스 수보다 많게 설정하되, 서비스 수의 2배를 넘지 않는 것이 좋습니다. 예를 들어 vCenter 2대라면 StartVMwareCollectors=5 정도가 적절합니다. 환경 규모와 수집 주기에 따라 조정이 필요할 수 있습니다.
Q. vCenter 연동 후 그래프가 비어 있습니다. 어떻게 해야 하나요?
A. 기본 내장 그래프는 VMware 전용이 아닙니다. 설정 → 호스트 → 그래프에서 새 그래프를 만들고, VMware 템플릿이 제공하는 아이템(예: vmware.hv.cpu.usage)을 추가해야 데이터가 표시됩니다. 데이터 수집이 완료되기까지 최대 2시간이 소요될 수 있으니 시간을 두고 확인하세요.