VMware 수집 항목
서버 모니터링 에이전트는 VMware API를 통해 ESXi 호스트와 가상 머신의 상태를 함께 수집합니다. 가상 머신 안에서 본 자원 사용량만으로는 성능 저하의 원인을 알기 어렵습니다. 호스트의 팬이 고장 났거나, 한 호스트에 가상 머신이 과도하게 몰려 vCPU가 서로 순서를 기다리는 상황은 게스트 지표에 잘 드러나지 않기 때문입니다. 이 문서는 가상화 기반 인프라를 운영하며 호스트 단위 원인까지 추적해야 하는 운영자를 대상으로, VMware 연동으로 수집하는 항목을 안내합니다.
VMware 데이터 연동은 vCenter가 없어도 ESXi 호스트에 직접 연동해 데이터를 수집할 수 있습니다. 다만 vm_vcenter_inventory 카테고리는 vCenter에 연동한 경우에만 수집합니다.
지원 에이전트 버전은 Linux·Windows 2.9.23 이상입니다. 각 표의 비고 열에 2.9.23 신규로 표시한 필드는 2.9.23에서 추가된 항목이며, 표시가 없는 필드는 이전 버전부터 제공합니다.
수집한 값을 보는 화면
이 문서는 수집 항목의 목록입니다. 수집을 시작하고 값을 조회하는 방법은 다음 문서를 참조하세요.
- VM 수집 설정: vCenter·ESXi Host 접속 정보 등록
- VM 인벤토리: vCenter·vHost·vmGuest 구성 정보 조회
- vHost 성능 요약: 호스트별 성능 지표 비교
- vHost 성능 상세: 호스트 한 대의 자원 추이와 GuestVM 기여도
infra_vm_vhost_hw
ESXi 호스트의 하드웨어 상태를 부위별로 모아 수집하는 카테고리입니다. 호스트 하나가 한 행이 되며, 전원·냉각·메모리·프로세서 등 부위별 상태와 최고 온도를 제공합니다. 하드웨어 고장이 성능 저하나 장애로 이어지기 전에 확인할 때 사용합니다. 2.9.23에서 추가한 카테고리로, 표의 모든 필드가 신규입니다.
- 수집 대상: VMware ESXi
상태 값은 다음 네 가지로 표준화합니다. 부위별 센서가 여러 개면 가장 심각한 상태를 대표 값으로 표시하고, 센서 데이터가 제공되지 않는 부위는 unknown으로 표시합니다.
| Item | Description |
|---|---|
green | 정상 |
yellow | 경고 |
red | 장애 |
unknown | 상태를 확인할 수 없음 |
| Field | Type | Unit | Description |
|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 하드웨어 상태가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 |
hardwareHealth | string | - | 수집 가능한 전체 하드웨어 상태 중 가장 심각한 상태를 대표하는 종합 상태 |
powerSupplyStatus | string | - | 전원 공급 장치의 상태 |
powerSupplyRedundancyStatus | string | - | 전원 공급 장치의 이중화 상태. 일부 장애로 이중화가 저하됐는지 확인할 때 사용 |
networkDeviceStatus | string | - | 물리 네트워크 장치와 네트워크 어댑터의 하드웨어 상태. 네트워크 링크의 Up·Down 상태와는 구분되는 정보 |
batteryStatus | string | - | 내부 배터리 또는 하드웨어 관리 컨트롤러 배터리의 상태. CMOS 배터리, RAID 캐시 배터리 등이 포함 |
processorsStatus | string | - | 물리 프로세서와 CPU 소켓의 하드웨어 상태. CPU 사용률과는 무관한 물리 하드웨어 상태 |
memoryModulesStatus | string | - | 물리 메모리 모듈의 하드웨어 상태. DIMM 오류나 모듈 장애·경고 상태를 포함 |
coolingUnitStatus | string | - | 팬, 블로어 등 냉각 장치의 상태 |
coolingUnitRedundancyStatus | string | - | 냉각 장치의 이중화 상태. 일부 팬이 고장 나도 냉각 기능이 유지되는지 확인할 때 사용 |
temperatureStatus | string | - | CPU, 시스템 보드, 메모리, 흡기구 등 온도 센서의 종합 상태 |
temperatureMax | - | °C | 수집 시점에 확인된 온도 센서 값 중 가장 높은 온도. 센서 원시값에 VMware가 제공하는 단위 보정값을 적용해 계산하며, 온도 센서가 없으면 빈 값 |
hardwareHealthDataAvailable | boolean | - | 호스트에서 하드웨어 상태 또는 센서 데이터가 하나 이상 제공됐는지 여부 |
hardwareHealthSupportStatus | string | - | 하드웨어 상태 수집 지원 여부. supported는 센서 데이터가 제공되는 상태, unsupported는 API가 지원되지 않거나 센서가 노출되지 않는 상태 |
hardwareHealthUnavailableReason | string | - | 하드웨어 상태 데이터를 수집할 수 없는 이유. Hardware Health API 미지원, 센서 미노출, 수집 오류 등이 기록되며 정상 수집 시 빈 값 |
temperatureMaxSensor | string | - | temperatureMax 값이 측정된 온도 센서의 이름. CPU, 시스템 보드, 메모리, 흡기구 중 실제로 가장 높은 온도를 기록한 센서를 식별 |
temperatureUnit | string | - | temperatureMax에 적용되는 온도 단위. 보통 Degrees C 형태이며 센서 제공자에 따라 표현 방식이 다를 수 있음 |
infra_vm_vhost_resource_capacity
ESXi 호스트의 물리 자원과 가상 머신에 할당한 자원을 함께 수집하는 카테고리입니다. 호스트 하나가 한 행이 되며, 물리 용량 대비 할당량의 비율(오버커밋)을 제공합니다. 특정 호스트에 가상 머신을 과도하게 배치하지 않았는지 점검할 때 사용합니다. 2.9.23에서 추가한 카테고리로, 표의 모든 필드가 신규입니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description |
|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 자원 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 |
cpuCores | - | count | 호스트 전체의 물리 CPU 코어 수. 가상 머신 할당 가능 자원과 CPU 용량 산정의 기준 |
totalMemory | - | byte | 호스트에 장착된 전체 메모리 용량. 가상 머신 배치 가능 용량과 메모리 자원 계획의 기준 |
activeVCpu | - | count | 전원이 켜진 가상 머신에 할당된 vCPU 수의 합계 |
allocatedVCpu | - | count | 호스트에 배치된 전체 가상 머신에 설정된 vCPU 수의 합계. 전원이 꺼졌거나 일시 중지된 가상 머신도 모두 포함 |
activeOverCommitCore | - | - | activeVCpu를 물리 CPU 코어 수로 나눈 값. 실행 중인 가상 머신 기준으로 물리 코어 하나당 평균 몇 개의 vCPU가 할당됐는지를 배수로 표시 |
allocatedOverCommitCore | - | - | allocatedVCpu를 물리 CPU 코어 수로 나눈 값. 전원이 꺼졌거나 일시 중지된 가상 머신까지 포함한 구성 기준의 vCPU 오버커밋 배수 |
activeMemory | - | byte | 전원이 켜진 가상 머신에 설정된 메모리 용량의 합계 |
allocatedMemory | - | byte | 호스트에 배치된 전체 가상 머신에 설정된 메모리 용량의 합계. 전원이 꺼졌거나 일시 중지된 가상 머신도 모두 포함 |
activeOverCommitMemory | - | - | activeMemory를 물리 메모리 용량으로 나눈 값. 실행 중인 가상 머신 기준으로 물리 메모리 대비 몇 배의 메모리가 할당됐는지를 배수로 표시 |
allocatedOverCommitMemory | - | - | allocatedMemory를 물리 메모리 용량으로 나눈 값. 전원이 꺼졌거나 일시 중지된 가상 머신까지 포함한 구성 기준의 메모리 오버커밋 배수 |
vmGuestCount | - | count | 호스트에 연결된 가상 머신 객체 수. 호스트별 배치 현황과 밀집도를 파악할 때 사용 |
poweredOffVMCount | - | count | 전원이 꺼진 가상 머신 수. allocatedVCpu에는 포함되지만 activeVCpu에는 포함되지 않음 |
suspendedVMCount | - | count | 일시 중지 상태의 가상 머신 수. vCPU가 설정돼 있어 allocatedVCpu에는 포함되지만, 실행 중이 아니므로 activeVCpu에는 포함되지 않음 |
unknownPowerStateVMCount | - | count | 전원 상태를 확인할 수 없거나 poweredOn·poweredOff·suspended 중 하나로 식별되지 않은 가상 머신 수. vCenter 응답 지연, 권한, 일시적인 상태 불일치로 발생할 수 있음 |
vcpuSkippedVMCount | - | count | vCPU 설정값을 읽지 못해 vCPU 합산에서 제외한 가상 머신 수. 설정 정보 접근 실패, 권한 부족, 비정상 구성, 일시적인 vCenter 응답 오류가 원인일 수 있음 |
memorySkippedVMCount | - | count | 메모리 설정값을 읽지 못해 메모리 합산에서 제외한 가 상 머신 수. 원인은 vcpuSkippedVMCount와 같음 |
오버커밋 비율은 소수점 두 자리까지 표시합니다. 값이 1을 넘으면 물리 자원보다 많은 자원을 가상 머신에 할당한 상태입니다. 가상화 환경에서는 일정 수준의 오버커밋이 일반적이므로, 절대값보다 같은 클러스터 내 호스트 사이의 편차와 시간에 따른 증가 추이를 함께 보는 것이 좋습니다.
수집 여부는 다음 옵션으로 조정합니다.
vm.vhost.perf.resource_capacity.enabled=true # 수집 여부 (기본값: true)
infra_vm_vhost_cpu
ESXi 호스트의 CPU 사용량과 대기 시간을 집계하는 카테고리입니다. 호스트 하나가 한 행이 되며, 호스트에 올라간 전체 가상 머신의 CPU 사용과 경합을 함께 제공합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description | 비고 |
|---|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 CPU 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 | |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 | |
usage | - | percent | 호스트의 전체 CPU 자원 중 실제로 사용한 비율. 호스트의 CPU 부하 수준을 확인하는 기본 지표 | |
usageMhz | - | MHz | 호스트에서 실제 사용 중인 CPU 자원량. CPU 용량이 다른 호스트를 비교할 때는 usage와 함께 확인 | |
totalCapacity | - | MHz | 호스트가 제공할 수 있는 전체 CPU 용량. 사용률·사용량·요구량·예약 용량을 해석하는 기준값 | |
demand | - | MHz | 호스트의 가상 머신이 실제로 사용하려고 요구한 CPU 자원량 | |
readiness | - | percent | 가상 머신이 실행 가능한 상태였지만 물리 CPU를 즉시 할당받지 못한 비율. 호스트의 CPU 경합을 판단하는 핵심 지표 | |
ready | - | ms/s | 실행 가능한 상태에서 물리 CPU를 할당받지 못해 대기한 시간 | |
latency | - | percent | CPU 자원을 요청한 뒤 실제 실행되기까지의 지연 수준 | |
costop | - | ms/s | 멀티 vCPU 가상 머신이 동시에 스케줄링되기를 기다리며 멈춰 있던 시간 | |
wait | - | ms/s | CPU가 실제 연산을 수행하지 않고 대기한 시간. 유휴, I/O 대기, 스왑 대기가 모두 포함 | |
swapwait | - | ms/s | 메모리 스왑 처리 때문에 CPU 실행이 지연된 시간 | |
idle | - | ms/s | CPU가 유휴 상태였던 시간 | |
reservedCapacity | - | MHz | 예약으로 확보한 CPU 용량. 전체 용량 대비 크면 실제 가용 CPU 여유가 줄어듦 | |
demandPct | - | percent | demand를 totalCapacity로 나눈 비율 | 2.9.23 신규 |
costopPct | - | percent | costop을 비율로 환산한 값(1,000ms/s = 100%) | 2.9.23 신규 |
CPU 경합 여부는 단일 지표로 판단하지 말고 함께 보는 것이 좋습니다. usage가 높으면서 readiness·ready도 함께 높으면 CPU 경합 가능성이 큽니다. 반대로 usage가 낮은데 readiness가 높다면 vCPU 과다 할당, 자원 제한, 스케줄링 정책을 함께 확인하세요. usageMhz보다 demand가 지속적으로 높으면 가상 머신이 요구한 만큼 CPU를 받지 못하는 상태일 수 있습니다.
wait에는 유휴 상태와 I/O 대기, 스왑 대기가 모두 포함되므로 값이 높다고 해서 CPU 부족으로 단정하면 안 됩니다. idle, swapwait와 나눠서 확인하세요. swapwait는 CPU 지표로 표시되지만 원인은 메모리 부족이나 메모리 경합일 수 있어, 값이 늘어나면 호스트와 가상 머신의 메모리 사용률, 벌루닝, 스왑 발생 여부를 함께 확인해야 합니다.
ms/s 단위 지표는 수집 주기가 달라져도 같은 기준으로 비교할 수 있도록 초당 값으로 환산해 제공합니다.
demandPct와 costopPct는 호스트에 있는 모든 가상 머신 vCPU를 합산한 값이라 100%를 넘을 수 있으며, 별도로 상한을 적용하지 않습니다. costopPct가 지속적으로 높으면 가상 머신에 할당한 vCPU 수가 호스트 용량에 비해 많은 상태일 수 있습니다.
infra_vm_vhost_mem
ESXi 호스트의 메모리 사용량과 회수 동작을 집계하는 카테고리입니다. 호스트 하나가 한 행이 되며, 실제 점유량과 워킹셋부터 벌루닝·압축·스왑 같은 메모리 회수 지표까지 함께 제공합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description |
|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 메모리 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 |
consumed | - | byte | 호스트가 실제로 소비 중인 물리 메모리 양. 가상 머신, VMkernel, ESXi 시스템 영역이 점유한 메모리를 모두 포함 |
active | - | byte | 호스트의 가상 머신이 최근 실제로 활발하게 사용한 메모리 양. 실질적인 워킹셋에 가까운 값 |
activeConsumedRatio | - | percent | active를 consumed로 나눈 비율. 소비 중인 메모리 가운데 실제로 활발히 사용된 비중 |
granted | - | byte | 호스트가 가상 머신에 할당한 메모리 양 |
latency | - | percent | 메모리 접근이나 할당 과정에서 발생하는 지연 수준 |
vmmemctl | - | byte | 벌룬 드라이버가 가상 머신에서 회수한 메모리 양 |
swapused | - | byte | 호스트에서 스왑으로 밀려난 메모리 양 |
swapInRate | - | bytes/s | 스왑 영역에서 메모리로 다시 읽어오는 속도 |
swapOutRate | - | bytes/s | 메모리 페이지가 스왑 영역으로 밀려나는 속도 |
compressed | - | byte | 메모리 압축으로 압축된 메모리 양 |
compressionRate | - | bytes/s | 메모리 압축이 발생하는 속도 |
shared | - | byte | 가상 머신 사이 또는 메모리 페이지 사이에서 공유되고 있는 메모리 양 |
overhead | - | byte | 가상 머신을 실행하기 위해 ESXi가 추가로 사용하는 메모리 오버헤드 |
sysUsage | - | byte | ESXi 시스템 영역에서 사용 중인 메모리 양 |
heapFree | - | byte | ESXi Heap 영역 중 사용 가능한 여유 메모리 양 |
consumed는 높은데 active가 낮으면 할당과 점유는 많지만 실제 사용은 적은 가상 머신이 많은 상태입니다. 두 값의 관계는 activeConsumedRatio로 바로 확인할 수 있습니다.
메모리 부족 여부는 한 지표로 판단하지 마세요. ESXi는 메모리 압박이 커지면 벌루닝, 압축, 스왑 순으로 회수 단계를 올립니다. vmmemctl이 늘어난 뒤 compressed와 compressionRate가 오르고 swapused와 swapOutRate까지 발생하면 메모리 경합이 상당히 진행된 상태입니다. latency가 함께 높으면 실제로 가상 머신 성능에 영향이 있을 가능성이 큽니다.
swapInRate가 높으면 가상 머신이 필요로 하는 페이지가 스왑에 있어 다시 읽어오는 중이라는 뜻이며, 성능 지연으로 이어질 수 있습니다.
shared, overhead, sysUsage, heapFree는 단독으로 문제를 나타내지 않습니다. shared는 메모리 절감 효과를 참고하는 보조 지표이고, overhead는 가상 머신 수가 많거나 가상 장치 구성이 복잡할수록 커집니다. sysUsage나 heapFree가 비정상적으로 변하면 ESXi 시스템 상태를 별도로 점검하세요.
infra_vm_vhost_disk
ESXi 호스트의 디스크 I/O를 집계하는 카테고리입니다. 호스트 하나가 한 행이 되 며, 호스트에 연결된 전체 디스크를 합산한 처리량과 가장 높은 지연 시간을 제공합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description |
|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 디스크 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 |
usage | - | bytes/s | 호스트에서 발생한 전체 디스크 I/O 처리량. 읽기와 쓰기를 합한 값 |
read | - | bytes/s | 호스트에서 발생한 디스크 읽기 처리량 |
write | - | bytes/s | 호스트에서 발생한 디스크 쓰기 처리량 |
maxTotalLatency | - | ms | 호스트에 연결된 디스크·장치 중 가장 높은 디스크 I/O 지연 시간 |
usage가 지속적으로 높으면 해당 호스트의 가상 머신에서 디스크 I/O가 많이 발생하는 상태입니다. maxTotalLatency와 함께 확인해 단순 처리량 증가인지 스토리지 병목인지 구분하세요.
read가 높으면서 지연도 함께 늘어나면 읽기 I/O 경합, 캐시 미스, 백 엔드 스토리지 응답 지연을 확인합니다. write가 높으면서 지연이 늘어나면 쓰기 I/O 경합, 스토리지 컨트롤러 지연, RAID·캐시·동기화 지연을 확인하세요.
maxTotalLatency는 특정 디스크, 데이터스토어, LUN, 스토리지 경로에서 지연이 발생하면 높아집니다. 호스트 전체 처리량이 높지 않더라도 이 값이 높으면 일부 스토리지 경로나 특정 가상 머신의 I/O 지연을 확인하는 것이 좋습니다.
infra_vm_vhost_disk_perf
ESXi 호스트에 연결된 디스크 장치별 성능입니다. 디스크 하나가 한 행이 되며, 처리량과 요청 수, 계층별 지연 시간을 함께 제공합니다. 어느 디스크에서 병목이 생기는지 좁힐 때 사용합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description |
|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 디스크 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 |
diskName | string | - | 지표가 수집된 디스크 또는 장치 이름. 호스트에 연결된 개별 디스크, LUN, 로컬 디스크, 스토리지 장치를 구분하는 기준 |
usage | - | bytes/s | 해당 디스크의 전체 I/O 처리량. read와 write의 합 |
read | - | bytes/s | 해당 디스크의 읽기 처리량 |
write | - | bytes/s | 해당 디스크의 쓰기 처리량 |
numberTotal | - | counts/s | 전체 I/O 요청 수. numberRead와 numberWrite의 합 |
numberRead | - | counts/s | 읽기 I/O 요청 수 |
numberWrite | - | counts/s | 쓰기 I/O 요청 수 |
totalLatency | - | ms | 전체 I/O 요청 처리에 걸린 평균 지연 시간. 커널·장치·큐 지연의 영향이 모두 포함된 대표 지표 |
totalReadLatency | - | ms | 읽기 I/O 요청 처리에 걸린 평균 지연 시간 |
totalWriteLatency | - | ms | 쓰기 I/O 요청 처리에 걸린 평균 지연 시간 |
deviceLatency | - | ms | 물리 디스크나 백엔드 스토리지 장치 에서 I/O를 처리하는 데 걸린 평균 지연 시간 |
queueLatency | - | ms | I/O 요청이 처리되기 전 큐에서 대기한 평균 시간 |
kernelLatency | - | ms | ESXi VMkernel 계층에서 I/O를 처리하는 동안 발생한 평균 지연 시간 |
maxQueueDepth | - | count | 해당 디스크에서 사용할 수 있거나 관찰된 최대 큐 깊이 |
busResets | - | counts/s | 해당 디스크 또는 스토리지 버스에서 발생한 버스 리셋 횟수 |
처리량(usage, read, write)과 요청 수(numberTotal, numberRead, numberWrite)를 함께 보면 I/O 블록 크기를 가늠할 수 있습니다. 요청 수는 많은데 처리량이 낮으면 작은 블록 I/O가 많은 상태입니다.
지연이 어디서 생기는지는 지연 지표를 나눠 보면 좁힐 수 있습니다.
| 높은 지표 | 확인할 곳 |
|---|---|
deviceLatency | 스토리지 장치, LUN, 어레이, SAN·NAS 등 백엔드 스토리지 계층 |
kernelLatency | 호스트 내부 I/O 처리, 드라이버, HBA·스토리지 어댑터, VMkernel 스토리지 스택 |
queueLatency | 요청 처리 속도가 따라가지 못해 대기열이 쌓이는 상태. maxQueueDepth, 요청 수와 함께 확인 |
busResets가 0이 아닌 상태로 반복 발생하면 스토리지 경로 안정성, HBA·컨트 롤러 로그, ESXi 이벤트를 함께 확인하세요.
호스트 전체를 합산한 값은 infra_vm_vhost_disk에서 확인합니다.
infra_vm_vhost_storageadapter_perf
ESXi 호스트의 스토리지 어댑터(HBA)별 성능입니다. 어댑터 하나가 한 행이 되며, 어댑터에 연결된 디스크와 LUN의 성능을 합산해 제공합니다. 어느 HBA에 부하가 몰리는지 확인할 때 사용합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description |
|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 어댑터 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 |
memberCount | - | count | 해당 어댑터 집계에 포함된 canonical 디스크 또는 LUN 인스턴스 수. 값이 클수록 여러 디스크·LUN의 성능을 어댑터 하나로 합산한 결과 |
memberPathNames | string | - | 해당 어댑터에 매핑된 디스크·LUN 경로 목록. 어댑터 성능값이 어 떤 경로를 기준으로 집계됐는지 확인할 때 사용 |
adapterName | string | - | 성능값이 집계된 스토리지 어댑터 이름. 보통 vmhba0 같은 HBA 또는 스토리지 컨트롤러 이름 |
total | - | bytes/s | 해당 어댑터의 전체 I/O 처리량. read와 write의 합 |
read | - | bytes/s | 해당 어댑터로 읽은 데이터 처리량. 하위 디스크·LUN의 읽기 처리량을 합산한 값 |
write | - | bytes/s | 해당 어댑터로 기록한 데이터 처리량. 하위 디스크·LUN의 쓰기 처리량을 합산한 값 |
numberTotalAveraged | - | counts/s | 해당 어댑터에서 발생한 전체 평균 I/O 수. numberReadAveraged와 numberWriteAveraged의 합 |
numberReadAveraged | - | counts/s | 해당 어댑터에서 발생한 평균 읽기 I/O 수 |
numberWriteAveraged | - | counts/s | 해당 어댑터에서 발생한 평균 쓰기 I/O 수 |
commandsAveraged | - | counts/s | 해당 어댑터에 연결된 디스크·LUN에서 발생한 전체 I/O 명령 수 |
totalReadLatency | - | ms | 해당 어댑터의 읽기 I/O 평균 지연 시간. 하위 디스크·LUN의 읽기 지연을 읽기 요청 수 기준으로 가중 평균한 값 |
totalWriteLatency | - | ms | 해당 어댑터의 쓰기 I/O 평균 지연 시간. 하위 디스크·LUN의 쓰기 지연을 쓰기 요청 수 기준으로 가중 평균한 값 |
이 카테고리의 값은 어댑터 하위 디스크·LUN을 합산한 결과입니다. 처리량과 요청 수는 단순 합계이고, 지연 시간은 요청 수를 가중치로 한 평균입니다. memberCount가 크면 그만큼 많은 디스크·LUN이 하나의 값으로 묶였다는 뜻이라, 특정 디스크만 느려도 어댑터 평균에는 잘 드러나지 않을 수 있습니다.
어댑터 지연이 높게 보이면 memberPathNames로 어떤 경로가 묶였는지 확인한 뒤, infra_vm_vhost_storagepath_perf에서 경로 단위로, infra_vm_vhost_disk_perf에서 디스크 단위로 좁혀 들어가세요.
infra_vm_vhost_storagepath_perf
ESXi 호스트의 스토리지 경로별 성능입니다. 경로 하나가 한 행이 되며, 어댑터·타깃·LUN 정보와 함께 경로 단위의 처리량과 지연 시간을 제공합니다. 멀티패스 구성에서 특정 경로만 느려지는 상황을 찾을 때 사용합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description |
|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 경로 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 |
pathName | string | - | 스토리지 경로의 표시 이름. 어댑터, 타깃, LUN, canonical 디스크 정보를 조합한 경로명 |
canonicalDiskName | string | - | 호스트가 인식하는 SCSI LUN의 canonical 이름(예: naa.*, t10.*, mpx.*). 성능 카운터 인스턴스와 매핑되는 기준 |
adapterName | string | - | 해당 경로가 연결된 스토리지 어댑터 이름. 보통 vmhba0 같은 HBA 또는 스토리지 컨트롤러 이름 |
targetName | string | - | 어댑터와 타깃을 조합한 이름(예: vmhba0:T0). 어댑터 하위의 타깃 경로를 식별할 때 사용 |
targetId | string | - | ESXi SCSI 토폴로지에서 해당 경로가 연결된 타깃 번호. 같은 어댑터 안의 여러 타깃을 구분할 때 사용 |
lunId | string | - | 해당 경로가 연결된 LUN 번호 |
adapterKey | string | - | vSphere 내부에서 스토리지 어댑터를 식별하는 키. API 매핑이나 장기 데이터 정합성 확인에 사용 |
total | - | bytes/s | 해당 경로의 전체 I/O 처리량. read와 write의 합 |
read | - | bytes/s | 해당 경로로 읽은 데이터 처리량 |
write | - | bytes/s | 해당 경로로 기록한 데이터 처리량 |
numberTotalAveraged | - | counts/s | 해당 경로에서 발생한 전체 평균 I/O 수. numberReadAveraged와 numberWriteAveraged의 합 |
numberReadAveraged | - | counts/s | 해당 경로에서 발생한 평균 읽기 I/O 수 |
numberWriteAveraged | - | counts/s | 해당 경로에서 발생한 평균 쓰기 I/O 수 |
commandsAveraged | - | counts/s | 해당 경로에서 발생한 전체 I/O 명령 수. 읽기와 쓰기를 포함한 스토리지 명령 부하 |
totalReadLatency | - | ms | 해당 경로의 읽기 I/O 평균 지연 시간 |
totalWriteLatency | - | ms | 해당 경로의 쓰기 I/O 평균 지연 시간 |
경로를 식별하는 필드가 여러 개인 이유는 문제 지점을 좁히는 단위가 다르기 때문입니다. adapterName은 HBA 단위, targetId는 같은 어댑터 안의 타깃 단위, lunId는 LUN 단위입니다. 같은 LUN에 경로가 여러 개일 때 어느 경로에서만 지연이 생기는지 비교하면 경로 장애와 스토리지 장치 문제를 구분할 수 있습니다.
totalReadLatency나 totalWriteLatency가 지속적으로 높으면 해당 경로의 HBA, 타깃, LUN, SAN 구간을 확인하세요. 같은 canonicalDiskName을 쓰는 모든 경로에서 함께 높다면 경로가 아니라 백엔드 스토리지 쪽 문제일 가능성이 큽니다.
infra_vm_vhost_datastore_perf
ESXi 호스트가 접근하는 데이터스토어별 성능과 용량입니다. 데이터스토어 하나가 한 행이 되며, I/O 처리량과 지연 시간에 더해 용량 사용 현황까지 함께 제공합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description |
|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 데이터스토어 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 |
datastoreName | string | - | 성능과 용량 정보가 수집된 데이터스토어 이름. VMFS, NFS, vSAN 등 vSphere가 인식하는 표시 이름 |
datastoreInstanceId | string | - | 성능 카운터 인스턴스와 매핑되는 데이터스토어 식별자. 데이터스토어 URL에서 추출한 VMFS 볼륨 UUID 등으로, 이름이 바뀌거나 중복될 수 있는 환경에서 안정적으로 연결할 때 사용 |
datastoreType | string | - | 데이터스토어의 유형(예: VMFS, NFS, vSAN). 스토리지 백엔드 종류를 구분할 때 사용 |
accessible | boolean | - | 호스트에서 해당 데이터스토어에 접근 가능한지 여부 |
datastoreUrl | string | - | 데이터스토어의 vSphere 내부 URL. VMFS 볼륨 UUID나 접근 경로가 포함 |
total | - | bytes/s | 데이터스토어의 전체 I/O 처리량. read와 write의 합 |
read | - | bytes/s | 데이터스토어에서 읽은 데이터 처리량 |
write | - | bytes/s | 데이터스토어에 기록한 데이터 처리량 |
numberTotalAveraged | - | counts/s | 데이터스토어에서 발생한 전체 평균 I/O 수. numberReadAveraged와 numberWriteAveraged의 합 |
numberReadAveraged | - | counts/s | 데이터스토어에서 발생한 평균 읽기 I/O 수 |
numberWriteAveraged | - | counts/s | 데이터스토어에서 발생한 평균 쓰기 I/O 수 |
totalReadLatency | - | ms | 데이터스토어 읽기 I/O의 평균 지연 시간 |
totalWriteLatency | - | ms | 데이터스토어 쓰기 I/O의 평균 지연 시간 |
capacity | - | byte | 데이터스토어의 전체 용량 |
allocated | - | byte | 할당 기준 공간. used와 uncommitted를 합산한 값 |
used | - | byte | 실제 사용량. 전체 용량에서 여유 공간을 뺀 값 |
uncommitted | - | byte | Thin Provisioning 환경에서 아직 실제로 쓰이지는 않았지만 앞으로 사용될 수 있는 미확정 할당 공간 |
free | - | byte | 데이터스토어의 여유 공간 |
usedPct | - | percent | used를 capacity로 나눈 사용률 |
용량 필드는 다음 관계를 갖습니다.
capacity=used+freeallocated=used+uncommitted
allocated가 capacity를 넘으면 Thin Provisioning으로 실제 용량보다 많은 공간을 약속한 오버커밋 상태입니다. 가상 머신 디스크가 커지면서 uncommitted가 실제 사용량으로 전환되므로, usedPct만 보지 말고 allocated와 capacity의 관계를 함께 확인하세요.
accessible이 false이면 호스트와 데이터스토어 사이의 연결, 스토리지 경로, SAN·NAS 네트워크, 권한, 데이터스토어 장애 여부를 확인해야 합니다.
지연 시간이 지속적으로 높으면 스토리지 응답 지연, 경로 문제, 백엔드 스토리지 부하, 스토리지 네트워크 지연을 확인하세요. 같은 데이터스토어를 여러 호스트가 공유하는 경우, 다른 호스트에서도 같은 지연이 보이는지 비교하면 호스트 문제와 백엔드 문제를 구분할 수 있습니다.
infra_vm_vhost_network
ESXi 호스트의 네트워크 사용량을 집계하는 카테고리입니다. 호스 트 하나가 한 행이 되며, 호스트의 전체 물리 네트워크 인터페이스를 합산한 값을 제공합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description | 비고 |
|---|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 네트워크 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 | |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 | |
usage | - | bytes/s | 호스트 전체의 네트워크 사용량. 수신과 송신 트래픽을 합산한 값 | |
bytesRx | - | bytes/s | 호스트가 네트워크를 통해 수신한 데이터 처리량. 가상 머신, VMkernel, 관리 네트워크를 모두 포함 | |
bytesTx | - | bytes/s | 호스트가 네트워크를 통해 송신한 데이터 처리량. 가상 머신, VMkernel, 관리 네트워크를 모두 포함 | |
packetsTotal | - | counts/s | 수신 패킷(packetsRx)과 송신 패킷(packetsTx)의 합 | |
packetsRx | - | counts/s | 호스트가 수신한 네트워크 패킷 수 | |
packetsTx | - | counts/s | 호스트가 송신한 네트워크 패킷 수 | |
errorsRx | - | counts/s | 수신 과정에서 발생한 오류 수 | |
errorsTx | - | counts/s | 송신 과정에서 발생한 오류 수 | |
droppedRx | - | counts/s | 수신 중 드롭된 패킷 수 | |
droppedTx | - | counts/s | 송신 중 드롭된 패킷 수 | |
errorsRxTx | - | counts/s | 수신 오류(errorsRx)와 송신 오류(errorsTx)의 합 | 2.9.23 신규 |
droppedRxTx | - | counts/s | 수신 드롭(droppedRx)과 송신 드롭(droppedTx)의 합 | 2.9.23 신규 |
errorsRx가 지속적으로 늘어나면 물리 NIC, 케이블, 스위치 포트, 드라이버, MTU 설정 문제를 의심할 수 있습니다. errorsTx가 늘어나면 물리 NIC, 스위치 포트, 링크 상태, 드라이버, 네트워크 혼잡을 확인하세요.
droppedRx는 수신 큐 부족, 네트워크 폭주, NIC·드라이버 문제, vSwitch 처리 지연이 원인일 수 있습니다. droppedTx는 송신 큐 부족, 네트워크 혼잡, 물리 NIC 또는 vSwitch 처리 지연을 확인할 때 사용합니다.
errorsRxTx와 droppedRxTx는 송수신을 나눠 보지 않고 호스트 단위의 총량만 확인할 때 사용합니다.
infra_vm_vhost_nic_perf
ESXi 호스트의 물리 네트워크 인터페이스별 사용량입니다. 인터페이스 하나가 한 행이 되며, 어떤 인터페이스에서 오류나 폐기가 발생하는지 확인할 때 사용합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description | 비고 |
|---|---|---|---|---|
vhostName | string | - | 수집 대상 호스트 이름. 각 NIC 지표가 어느 ESXi 호스트에서 수집됐는지 식별하는 기준 | |
uuid | string | - | 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 | |
nicName | string | - | 지표가 수집된 네트워크 인스턴스 이름. 보통 vmnic0, vmnic1 같은 물리 NIC 이름이며, 환경에 따라 다른 이름이 표시될 수 있음 | |
usage | - | bytes/s | 해당 NIC의 전체 네트워크 처리량. 수신과 송신을 합산한 값 | |
bytesRx | - | bytes/s | 해당 NIC로 수신한 데이터 처리량 | |
bytesTx | - | bytes/s | 해당 NIC로 송신한 데이터 처리량 | |
packetsTotal | - | counts/s | 수신 패킷(packetsRx)과 송신 패킷(packetsTx)의 합 | |
packetsRx | - | counts/s | 해당 NIC가 수신한 네트워크 패킷 수 | |
packetsTx | - | counts/s | 해당 NIC가 송신한 네트워크 패킷 수 | |
errorsRx | - | counts/s | 수신 과정에서 발생한 오류 수 | |
errorsTx | - | counts/s | 송신 과정에서 발생한 오류 수 | |
droppedRx | - | counts/s | 수신 중 드롭된 패킷 수 | |
droppedTx | - | counts/s | 송신 중 드롭된 패킷 수 | |
errorsRxTx | - | counts/s | 수신 오류(errorsRx)와 송신 오류(errorsTx)의 합 | 2.9.23 신규 |
droppedRxTx | - | counts/s | 수신 드롭(droppedRx)과 송신 드롭(droppedTx)의 합 | 2.9.23 신규 |
특정 NIC에서만 오류나 드롭이 늘어나면 해당 NIC의 케이블, 스위치 포트, 드라이버, MTU 설정을 먼저 확인하세요. 호스트 전체를 합산한 값은 infra_vm_vhost_network에서 확인합니다.
errorsRxTx와 droppedRxTx는 송수신을 나눠 보지 않고 인터페이스 단위의 총량만 확인할 때 사용합니다.
infra_vm_vhost_vmguest_perf
ESXi 호스트에서 실행 중인 가상 머신의 성능 지표입니다. 전원이 켜진 가상 머신 하나가 한 행이 되며, 호스트 관점에서 본 가상 머신의 CPU·메모리·디스크·네트워크 사용량을 제공합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description | 비고 |
|---|---|---|---|---|
vHostName | string | - | 가상 머신이 실행 중인 호스트 이름 | |
uuid | string | - | 가상 머신이 실행 중인 ESXi 호스트의 하드웨어 UUID. 호스트 이름이나 IP가 바뀌어도 같은 호스트를 식별하는 보조 기준 | |
vmName | string | - | 성능 정보가 수집된 가상 머신 이름. vCenter 인벤토리에 표시되는 이름 | |
vmInstanceUuid | string | - | vCenter 안에서 가상 머신 인스턴스를 식별하는 UUID. 이름 변경이나 vMotion과 무관하게 같은 가상 머신을 추적하는 주요 식별자 | |
cpuUsage | - | percent | 가상 머신의 CPU 사용률. vSphere cpu.usage.average 값을 백분율로 변환 | |
cpuUsagemhz | - | MHz | 가상 머신이 실제로 사용 중인 CPU 자원. 사용률과 함께 실제 소비량을 확인할 때 사용 | |
cpuCostop | - | ms | SMP 가상 머신에서 여러 vCPU가 동시에 스케줄링되지 못해 대기한 시간 | |
cpuCostopPct | - | percent | cpuCostop을 샘플링 간격으로 나눠 비율로 환산한 값. esxtop에서 VM 그룹 단위로 조회할 때의 %CSTP와 일치 | 2.9.23 신규 |
cpuCostopPctPerVcpu | - | percent | cpuCostopPct를 vCPU 수로 나눈 vCPU당 평균 비율. 항상 0에서 100 사이 | 2.9.23 신규 |
cpuReadiness | - | ms | 가상 머신이 CPU를 사용할 준비를 마쳤으나 물리 CPU 자원 부족으로 스케줄링되지 못하고 대기한 시간 | |
cpuReadinessPct | - | percent | cpuReadiness를 샘플링 간격으로 나눠 비율로 환산한 값. esxtop에서 VM 그룹 단위로 조회할 때의 %RDY와 일치 | 2.9.23 신규 |
cpuReadinessPerVcpu | - | percent | vCPU당 평균 대기 비율. vSphere cpu.readiness.average 카운터로 직접 제공하며 항상 0에서 100 사이 | 2.9.23 신규 |
cpuMaxlimited | - | percent | CPU limit 설정 등으로 사용할 수 있었지만 제한된 CPU 시간의 비율 | |
memConsumed | - | MB | 가상 머신이 호스트 메모리에서 실제로 소비한 메모리 | |
memVmmemctl | - | KB | 벌룬 드라이버(vmmemctl)가 회수한 가상 머신 메모리 | |
memActive | - | KB | 최근 실제로 활발히 사용한 것으로 판단되는 메모리. 실질적인 working set을 추정할 때 사용 | |
memGranted | - | KB | 호스트가 가상 머신에 부여한 메모리 | |
memSwapped | - | KB | 호스트가 가상 머신 메모리 일부를 스왑 처리한 양 | |
memSwapoutRate | - | KB/s | 가상 머신 메모리가 호스트 스왑으로 빠져나가는 속도 | |
memCompressed | - | KB | 호스트가 가상 머신 메모리를 압축해 보관 중인 양 | |
memCompressionRate | - | KB/s | 가상 머신 메모리가 압축되는 속도 | |
diskUsage | - | KB/s | 게스트 관점의 전체 디스크 사용량. 읽기와 쓰기를 합산한 값 | |
networkUsage | - | KB/s | 게스트 관점의 전체 네트워크 사용량. 수신과 송신을 합산한 값 |
cpuCostopPct와 cpuReadinessPct는 멀티 vCPU 가상 머신에서 vCPU 수만큼 값이 커져 100%를 넘을 수 있습니다. 임계값을 판단할 때는 vCPU 수를 함께 고려하거나, vCPU 하나 기준으로 환산한 cpuCostopPctPerVcpu, cpuReadinessPerVcpu를 사용하세요. vCPU 기준 값은 항상 0에서 100 사이라 vCPU 수가 다른 가상 머신끼리 같은 기준으로 비교할 수 있습니다.
VMware 공식 가이드의 판단 기준은 다음과 같습니다.
| 지표 | 정상 | 주의 | 심각 |
|---|---|---|---|
cpuCostopPctPerVcpu | 3% 이하 | 3 ~ 10% | 10% 이상 |
cpuReadinessPerVcpu | 5% 이하 | 5 ~ 10% | 10% 이상 |
cpuCostopPctPerVcpu가 심각 수준이면 가상 머신에 할당한 vCPU 수를 줄이거나 다른 호스트로 옮기는 것을 검토하세요. cpuReadinessPerVcpu가 심각 수준이면 호스트의 CPU 자원 부족 또는 가상 머신 재배치를 검토합니다.
memVmmemctl, memSwapped, memCompressed가 늘어나면 호스트의 메모리 압박을 의심할 수 있습니다. 압축은 보통 스왑보다 먼저 발생하므로, memCompressed가 증가한 뒤 memSwapped까지 늘어나면 메모리 부족이 심해지는 상태입니다.
vCenter가 제공하지 않는 카운터는 빈 값으로 수집합니다.
vm_vcenter_inventory
vCenter 서버 자체의 구성 정보입니다. 관리 대상 개체 수, 활성 알람 수, 인증서와 라이선스 만료 정보를 제공합니다. vCenter 인증서 만료처럼 미리 대비해야 하는 항목을 점검할 때 사용합니다. 2.9.23에서 추가한 카테고리로, 표의 모든 필드가 신규입니다.
- 수집 대상: VMware vCenter
| Field | Type | Unit | Description |
|---|---|---|---|
vCenterHostname | string | - | vCenter 서버의 호스트명. vCenter를 식별하는 대표 이름 |
fqdn | string | - | vCenter 서버의 FQDN(정규 도메인 이름). DNS에 등록된 경우에만 수집 |
ip | string | - | vCenter 서버의 대표 IP 주소 |
allIPs | string | - | vCenter 서버에 연결 가능한 전체 IP 주소 목록 |
connectionAddress | string | - | 에이전트가 vCenter API 접속에 사용 한 주소(IP 또는 호스트명) |
uuid | string | - | vCenter 서버의 고유 식별자. 서버 이전이나 이름 변경과 무관하게 같은 인스턴스를 식별 |
overallHealth | string | - | vCenter 인벤토리 전체의 종합 상태. green·yellow·red 중 가장 높은 심각도를 표시 |
redAlarmCount | string | count | 현재 활성화된 위험(Red) 알람 수 |
yellowAlarmCount | string | count | 현재 활성화된 경고(Yellow) 알람 수 |
alarmCount | string | count | 현재 활성화된 전체 알람 수 |
hostCount | string | count | vCenter에서 관리 중인 ESXi 호스트 수 |
vmCount | string | count | vCenter에서 관리 중인 가상 머신 수 |
datacenterCount | string | count | 등록된 데이터센터 수 |
clusterCount | string | count | 등록된 클러스터 수 |
datastoreCount | string | count | 등록된 데이터스토어 수 |
networkCount | string | count | 등록된 네트워크 수 |
resourcePoolCount | string | count | 등록된 리소스 풀 수 |
folderCount | string | count | vCenter 인벤토리의 폴더 수 |
certificateDaysRemaining | string | count | vCenter HTTPS 인증서 만료까지 남은 일수 |
certificateExpiration | string | - | vCenter HTTPS 인증서의 만료 일시 |
certificateValidFrom | string | - | vCenter HTTPS 인증서의 발급 시작 일시 |
certificateSubject | string | - | vCenter HTTPS 서버 인증서의 주체(DN) 정보 |
certificateIssuer | string | - | vCenter HTTPS 서버 인증서를 발급한 발급자(CA) 정보 |
certificateThumbprint | string | - | vCenter HTTPS 인증서의 SHA-256 지문 |
licenseExpiration | string | - | vCenter 라이선스 만료 일시. 영구 라이선스면 비어 있을 수 있음 |
licenseEdition | string | - | 적용된 vCenter 라이선스 에디션 |
licenseName | string | - | 적용된 vCenter 라이선스 이름 |
licenseTotal | string | count | 라이선스에서 제공하는 총 할당 수량 |
licenseUsed | string | count | 현재 사용 중인 라이선스 수량 |
version | string | - | vCenter 서버 버전 |
build | string | - | vCenter 서버 빌드 번호 |
fullName | string | - | VMware가 제공하는 전체 제품명과 버전 문자열 |
apiVersion | string | - | vSphere Web Services API 버전 |
deploymentType | string | - | vCenter 배포 형태(예: Embedded PSC) |
timeZone | string | - | vCenter 어플라이언스에 설정된 표준 시간대 |
agentName | string | - | VMware 정보를 수집하는 에이전트가 설치된 서버의 호스트명 |
일부 항목은 vSphere 7 이상의 어플라이언스 API에서만 제공합니다. 해당 API를 사용할 수 없는 환경에서는 값이 비어 있거나 대체 값으로 표시합니다.
수집 여부는 다음 옵션으로 조정합니다.
vm.inventory.vcenter.enabled=true # 수집 여부 (기본값: true)
vm_vhost_inventory
ESXi 호스트의 구성 정보입니다. 호스트 하나가 한 행이 되며, 값이 바뀔 때만 전송합니다. 호스트가 어느 vCenter·데이터센터·클러스터에 속하는지부터 CPU·메모리·GPU·네트워크 구성과 운영 상태까지 함께 제공합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description |
|---|---|---|---|
vCenterServerIp | string | - | 해당 ESXi 호스트 정보를 수집한 vCenter 서버의 IP 주소. 여러 vCenter를 통합 수집하는 환경에서 호스트가 어느 vCenter에 속하는지 구분하는 기준 |
dataCenterName | string | - | vCenter 인벤토리 구조상 호스트가 포함된 데이터센터 이름 |
clusterName | string | - | 호스트가 소속된 클러스터 이름. 단독 호스트이거나 클러스터에 속하지 않으면 빈 값 또는 None |
folder | string | - | vSphere 인벤토리에서 호스트가 위치한 호스트 폴더 경로. 데이터센터 하위의 호스트 폴더나 사용자가 만든 관리 폴더를 기준으로 표시하며, 클러스터·리소스 풀·데이터스토어 같은 실제 리소스 구성 위치와는 별개로 해석 |
vHostName | string | - | vCenter에서 식별되는 ESXi 호스트 이름 또는 접속 주소. 보통 호스트 IP나 FQDN 형태 |
esxiHostNameFqdn | string | - | ESXi 호스트의 전체 도메인 이름. DNS 또는 호스트명 설정에 따라 표시 |
esxiHostNameShort | string | - | ESXi 호스트의 짧은 호스트명. FQDN에서 도메인을 제외한 이름 |
esxiHostNameDomain | string | - | ESXi 호스트명에 설정된 도메인 영역. 도메인이 없으면 빈 값 |
esxiManagementIp | string | - | ESXi 호스트의 관리용 IP 주소. vCenter 접속, 관리 네트워크, API 통신에 사용하는 대표 관리 IP |
esxiVmIps | string | - | 호스트에 구성된 VMkernel 인터페이스의 IP 정보. 관리·vMotion·vSAN·iSCSI/NFS 등의 네트워크 용도로 사용 |
manufacturer | string | - | 호스트 하드웨어 제조사(예: HP, Dell, Lenovo) |
model | string | - | 호스트 하드웨어 모델명. 서버 모델 또는 워크스테이션 모델을 표시 |
hostType | string | - | 호스트의 구성 형태. 클러스터에 속하면 cluster, 단독 호스트면 standalone |
serialNumber | string | - | 호스트 장비의 시리얼 번호. 자산 관리, 유지보수 계약, 벤더 지원 요청 시 식별 정보로 사용 |
uuid | string | - | 호스트 시스템의 고유 식별자. 이름이 같거나 IP가 바뀐 상황에서도 장비를 식별하는 보조 정보 |
cpuModel | string | - | 호스트에 장착된 CPU 모델명(예: Intel Xeon, Intel Core, AMD EPYC) |
cpuSockets | string | - | 물리 CPU 소켓 수. 라이선스, 용량 산정, 물리 CPU 구성 확인에 사용 |
cpuCores | string | - | 호스트 전체의 물리 CPU 코어 수. 가상 머신 할당 가능 자원과 CPU 용량 산정의 기준 |
cpuThreads | string | - | 하이퍼스레딩 등을 포함한 논리 CPU 스레드 수. 실제 가상 머신 스케줄링이 가능한 논리 CPU 단위 |
hyperThreadingEnabled | string | - | 호스트에서 하이퍼스레딩이 활성화되어 있는지 여부. cpuCores와 cpuThreads 값의 차이를 해석할 때 사용 |
cpuTotalMhz | string | MHz | 호스트 전체 CPU의 총 처리 용량. CPU 코어 수와 클럭 정보를 기반으로 산정 |
totalMemoryGb | string | GiB | 호스트에 장착된 전체 메모리 용량. 가상 머신 배치 가능 용량과 메모리 자원 계획의 기준 |
gpuCount | string | count | 호스트에서 확인된 물리 GPU 장치 수. PCI 장치 정보 중 VGA·3D Controller·Display Controller 계열을 기준으로 산정 |
gpuDevices | string | - | 호스트에서 확인된 GPU 장치 목록. 제조사, 모델명, PCI 장치 식별자를 표시(예: NVIDIA A100, NVIDIA T4, NVIDIA L40) |
gpuProfiles | string | - | 호스트에서 확인 가능한 vGPU 프로파일 또는 Shared Passthrough GPU 타입 후보 목록. NVIDIA vGPU Manager, ESXi·vCenter 버전, 라이선스와 API 노출 방식에 따라 값이 없을 수 있음 |
vmGuestCount | string | - | 호스트에 연결된 가상 머신 객체 수. 호스트별 가상 머신 배치 현황과 밀집도를 파악할 때 사용 |
datastoreCount | string | - | 호스트에서 접근 가능한 데이터스토어 수. 호스트가 사용할 수 있는 스토리지 연결 수와 구성 규모를 파악할 때 사용 |
dataStores | string | - | 호스트가 접근 가능한 데이터스토어 목록. 가상 머신 디스크를 저장할 수 있는 스토리지 자원 목록 |
totalCapacityGb | string | GiB | 호스트에서 접근 가능한 데이터스토어의 전체 용량 합계. 공유 데이터스토어가 포함될 수 있으므로 호스트 단독 용량으로 단정하지 않도록 주의 |
networkCount | string | - | 호스트에 연결된 네트워크 또는 포트 그룹 수 |
networks | string | - | 호스트에 연결된 네트워크 또는 포트 그룹 목록. 가상 머신의 네트워크 연결 가능 범위를 확인할 때 사용 |
nicCount | string | - | 호스트에 구성된 물리 NIC 수. 관리·가상 머신·vMotion·스토리지 네트워크의 물리 연결 규모를 확인하는 기준 |
nics | string | - | 호스트에 구성된 물리 NIC 목록 |
vSwitchCount | string | - | 호스트에 구성된 가상 스위치 수. 표준 vSwitch 또는 분산 스위치 사용 여부와 네트워크 구성 규모를 파악할 때 사용 |
vSwitchs | string | - | 호스트에 구성된 vSwitch 목록 |
networkInfo | string | - | 호스트에 구성된 vSwitch 또는 네트워크 구성 정보 |
vMotionEnabled | string | - | 호스트에서 vMotion 기능이 활성화되어 있는지 여부. 가상 머신의 무중단 이동 가능 여부를 판단할 때 사용 |
haEnabled | string | - | 호스트가 속한 클러스터에서 HA 기능이 활성화되어 있는지 여부. 단독 호스트이거나 클러스터 HA가 비활성 상태면 None 또는 false |
productVersion | string | - | ESXi 제품 버전. 패치 수준, 기능 지원 여부, 호환성 판단에 사용 |
buildNumber | string | - | ESXi 빌드 번호. 세부 패치 버전 확인, 보안 취약점 대응, 호환성 검토의 기준 |
license | string | - | 호스트에 적용된 VMware 라이선스 종류. 사용 가능한 기능 범위와 운영 제약을 판단할 때 사용 |
bootTime | string | - | 호스트가 마지막으로 부팅된 시각. 장기 운영 여부와 장애 이후 복구 시점을 확인할 때 사용 |
upTime | string | - | 호스트가 마지막 부팅 이후 계속 동작한 시간. 장기 미재기동 서버 식별에 사용 |
timezone | string | - | 호스트 또는 vCenter 기준 시간대 정보. 이벤트 발생 시각과 성능 데이터의 시각을 해석하는 기준 |
connectionState | string | - | vCenter 기준 호스트 연결 상태. connected·disconnected·notResponding 등으로 표시하며 수집 가능 여부와 직접 관련 |
powerState | string | - | 호스트의 전원 상태. 보통 poweredOn이 정상 운영 상태 |
overallStatus | string | - | vCenter가 판단한 호스트의 종합 상태. green·yellow·red·gray 등으로 표시하며 경고·장애 여부를 빠르게 판단할 때 사용 |
maintenanceMode | string | - | 호스트가 유지보수 모드인지 여부. true이면 가상 머신 이동이나 패치 작업 등을 위해 운영 투입이 제한된 상태일 수 있음 |
vm_vmguest_inventory의 vHostKey로 가상 머신 목록과 이 표의 호스트 목록을 연결할 수 있습니다.
vm_vmguest_inventory
가상 머신의 구성 정보입니다. 가상 머신 하나가 한 행이 되며, 값이 바뀔 때만 전송합니다.
- 수집 대상: VMware ESXi
| Field | Type | Unit | Description | 비고 |
|---|---|---|---|---|
vHostKey | - | - | 가상 머신이 실행 중인 ESXi 호스트의 식별 키. vm_vhost_inventory의 키와 같은 값 | 2.9.23 신규 |
vmName | string | - | vCenter 또는 ESXi에서 관리되는 가상 머신의 표시 이름. 운영자가 vSphere 환경에서 식별하는 대표 이름 | |
guestHostname | string | - | 게스트 운영체제 내부에서 인식되는 호스트명. VMware Tools로 수집하며, Tools 상태나 게스트 설정에 따라 값이 없을 수 있음 | |
vCenterServerInfo | string | - | 해당 가상 머신 정보를 수집한 vCenter 서버 정보. 여러 vCenter를 통합 수집하는 환경에서 가상 머신이 어느 vCenter에 속하는지 구분하는 기준 | |
datacenter | string | - | 가상 머신이 포함된 vCenter 데이터센터 이름 | |
folder | string | - | vSphere 인벤토리에서 가상 머신이 위치한 VM 폴더 경로. VMs and Templates 관점의 논리적 폴더 위치이며, 호스트·클러스터·리소스 풀 같은 실행 위치나 자원 할당 위치와는 별개 | |
cluster | string | - | 가상 머신이 속한 ESXi 클러스터 이름. 독립 호스트 환경이거나 클러스터에 속하지 않으면 값이 없을 수 있음 | |
vHostInfo | string | - | 가상 머신이 실행 중이거나 등록되어 있는 ESXi 호스트 정보. 수집 기준에 따라 호스트 이름·IP·FQDN 등으로 표시 형식이 달라질 수 있음 | |
resourcePool | string | - | 가상 머신이 속한 리소스 풀 이름. 자원 정책, 할당 구조, 서비스 단위 그룹을 파악할 때 사용 | |
ipAddress | string | - | 게스트 운영체제에서 확인되는 대표 IP 주소. VMware Tools 상태, 네트워크 설정, 다중 NIC 구성에 따라 값이 없거나 대표 IP만 표시될 수 있음 | |
guestOS | string | - | 가상 머신에 설정된 게스트 운영체제 유형. vSphere에서 선택한 OS 타입 기준이라 실제 OS 정보와 다를 수 있음 | |
guestFullName | string | - | 게스트 운영체제의 상세 이름. VMware Tools 또는 가상 머신 설정 정보로 확인 | |
guestId | string | - | vSphere에서 사용하는 게스트 운영체제 식별자(예: rhel8_64Guest, windows9Server64Guest) | |
vcpu | string | count | 가상 머신에 할당된 가상 CPU 수 | |
sockets | string | count | 가상 머신에 설정된 가상 CPU 소켓 수. vCPU 구성 방식과 게스트 운영체제의 CPU 인식 구조를 확인할 때 사용 | |
coresPerSocket | string | count | 가상 머신에 설정된 소켓당 코어 수. 게스트 운영체제가 인식하는 CPU 토폴로지와 라이선스 정책 확인에 사용 | |
totalMemory | string | MiB | 가상 머신에 할당된 총 메모리 용량. 자원 할당 규모와 메모리 증설 여부를 판단하는 기준 | |
vGpuCount | string | count | 가상 머신에 할당된 vGPU 수. Virtual PCI Passthrough 장치로 연결된 vGPU 수를 기준으로 산정하며, 할당되지 않은 가상 머신은 0 | |
vGpuProfiles | string | - | 가상 머신에 할당된 vGPU 프로파일 정보(예: grid_a100-1-5c, grid_t4-2q). vCenter·ESXi 버전, NVIDIA vGPU Manager 구성, API 노출 방식에 따라 값이 없거나 표시 형식이 다를 수 있음 | |
provisionedSpace | string | GiB | 가상 머신에 프로비저닝된 전체 스토리지 용량. Thin Provisioning 환경에서는 실제 사용량보다 클 수 있음 | |
usedSpace | string | GiB | 가상 머신이 실제로 사용 중인 스토리지 용량. 데이터스토어 사용량 분석과 용량 관리에 사용 | |
datastore | string | - | 가상 머신이 사용 중인 데이터스토어 목록. 디스크 파일과 설정 파일이 위치한 스토리지 구성을 확인할 때 사용 | |
network | string | - | 가상 머신에 연결된 네트워크 또는 포트 그룹 정보. 네트워크 연결 구성과 서비스망·관리망 구분을 확인할 때 사용 | |
vmPathName | string | - | 가상 머신 구성 파일이 위치한 데이터스토어 경로. 보통 [datastore] path/vm.vmx 형식 | |
vmToolsVersion | string | - | 가상 머신에 설치된 VMware Tools 버전. 게스트 정보 수집, IP 확인, 하트비트 상태 확인 가능 여부와 관련 | |
template | string | - | 해당 객체가 VM 템플릿인지 여부. true이면 실행 중인 가상 머신이 아니라 배포용 템플릿 | |
firmware | string | - | 가상 머신의 펌웨어 유형. bios 또는 efi로 표시하며 부팅 방식, 보안 부팅, 호환성 확인에 사용 | |
version | string | - | 가상 머신의 가상 하드웨어 버전. ESXi·vCenter 호환성, 지원 기능, 마이그레이션 가능 여부를 판단할 때 사용 | |
cpuHotAddEnabled | string | - | 가상 머신 실행 중 vCPU 추가 기능이 활성화되어 있는지 여부. true이면 전원을 끄지 않고 CPU를 추가할 수 있음 | |
cpuHotRemoveEnabled | string | - | 가상 머신 실행 중 vCPU 제거 기능이 활성화되어 있는지 여부. 지원 운영체제와 설정에 따라 실제 동작 여부가 달라질 수 있음 | |
memoryHotAddEnabled | string | - | 가상 머신 실행 중 메모리 추가 기능이 활성화되어 있는지 여부. true이면 전원을 끄지 않고 메모리를 증설할 수 있음 | |
maxMksConnections | string | count | 가상 머신 콘솔에 동시 접속 가능한 최대 MKS 연결 수. 콘솔 접속 제한과 운영 접근 제어를 확인할 때 사용 | |
creationDate | string | - | 가상 머신이 생성된 일시. 수명 주기와 신규 생성 가상 머신 추적에 사용 | |
uuid | string | - | 가상 머신의 BIOS UUID. 게스트 운영체제 내부에서도 참조할 수 있으며, 복제나 재생성 방식에 따라 중복될 수 있음 | |
instanceUuid | string | - | vCenter가 가상 머신 인스턴스를 식별하는 데 사용하는 UUID. 같은 vCenter 안에서 가상 머신을 식별하는 주요 기준 | |
annotation | string | - | vSphere 가상 머신 설정에 입력한 설명 또는 메모 | |
powerState | string | - | 가상 머신의 전원 상태. poweredOn·poweredOff·suspended 등으로 표시 | |
overallStatus | string | - | 가상 머신 객체의 전체 상태. green·yellow·red·gray 등으로 표시하며 알람이나 구성 문제 여부를 빠르게 확인할 때 사용 | |
vmGuestState | string | - | VMware Tools 또는 게스트 운영체제 관점에서 확인되는 상태. running·notRunning·shuttingDown·standby 등으로 표시 | |
guestHeartbeatStatus | string | - | VMware Tools로 확인되는 게스트 운영체제 하트비트 상태. green·yellow·red·gray 등으로 표시 |
vHostKey로 가상 머신 목록과 호스트 목록을 연결할 수 있습니다. 특정 호스트에 올라간 가상 머신을 한 번에 찾을 때 사용합니다.
기존 vCenter 모니터링(피쳐 프로젝트)은 2026년 12월 31일부로 서비스를 종료하며, 서버 모니터링 제품의 vCenter 기능으로 대체될 예정입니다. 자세한 내용은 vCenter 모니터링 문서를 참조하세요.