메트릭

1. 개요

ECI 포털에서 가상머신(VM)의 성능 지표를 실시간으로 모니터링하고 분석할 수 있는 메트릭 기능에 대해 설명합니다. 메트릭 기능을 통해 CPU, GPU, 메모리, 네트워크, 스토리지의 사용 현황을 시각적으로 파악하여 리소스 운영 효율을 높일 수 있습니다.

ECI 포털은 두 가지 메트릭 조회 페이지를 제공합니다.

페이지	경로	용도
VM 메트릭	컴퓨트 > 가상머신 > VM 선택 > 메트릭 탭	단일 VM의 리소스 사용량 모니터링
모니터링 메트릭 탐색기	모니터링 > 메트릭	여러 VM을 동시에 비교·분석하는 고급 메트릭 탐색

2. VM 메트릭 페이지

2.1 접근 방법

1. 좌측 사이드바에서 컴퓨트 > 가상머신을 클릭합니다.
2. 목록에서 조회하려는 VM을 클릭합니다.
3. 상단 탭에서 메트릭을 선택합니다.

참고

VM이 실행 중 상태여야 메트릭 데이터가 수집됩니다. 중지된 VM은 데이터가 표시되지 않을 수 있습니다.

2.2 리소스 선택

상단 좌측의 드롭다운에서 조회할 리소스 유형을 선택합니다.

리소스	설명
CPU	CPU 사용률 및 세부 지표
GPU	GPU 사용률, 메모리 사용량 (GPU 장착 VM만 표시)
메모리	시스템 메모리 사용 현황
네트워크	네트워크 송수신 트래픽
스토리지	블록 스토리지 I/O 성능

참고

GPU가 없는 VM에서는 GPU 옵션이 표시되지 않습니다. GPU가 있는 VM은 GPU가 기본 선택됩니다.

2.3 리소스별 세부 메트릭

리소스 유형에 따라 조회할 수 있는 세부 메트릭이 달라집니다.

CPU 메트릭

메트릭	단위	설명
CPU 사용률 (Utilization)	%	전체 CPU 사용률 (100% - Idle%)
User	%	사용자 프로세스 CPU 사용률
System	%	시스템(커널) CPU 사용률
Idle	%	유휴 상태 비율
I/O Wait	%	I/O 대기 비율
IRQ	%	하드웨어 인터럽트 처리 비율
Soft IRQ	%	소프트웨어 인터럽트 처리 비율
Steal	%	하이퍼바이저에 의해 대기한 비율
Guest	%	게스트 OS 실행 비율
Nice	%	Nice 우선순위 프로세스 비율
Guest Nice	%	게스트 Nice 프로세스 비율

• 체크박스로 표시할 메트릭을 복수 선택할 수 있습니다.
• 코어별 분리 조회가 가능합니다. 코어 수가 많은 경우 범위 선택 기능을 사용하세요.

GPU 메트릭

메트릭	단위	설명
GPU 사용률 (Utilization)	%	GPU 연산 장치 사용률
GPU 메모리 사용량 (Memory Used)	MiB	사용 중인 GPU 메모리
GPU 메모리 총량 (Memory Total)	MiB	전체 GPU 메모리

• 멀티 GPU 환경에서는 카드별 체크박스로 개별 GPU를 선택할 수 있습니다.

메모리 메트릭

메트릭	단위	설명
Total	KiB	전체 메모리 용량
Available	KiB	사용 가능한 메모리
Active	KiB	활성 상태 메모리
Inactive	KiB	비활성 상태 메모리
Cached	KiB	캐시 메모리
Buffers	KiB	버퍼 메모리
Free	KiB	미사용 메모리
Shared Memory	KiB	공유 메모리
Swap Total	KiB	전체 스왑 용량
Swap Free	KiB	사용 가능한 스왑

네트워크 메트릭

메트릭	단위	설명
RX/TX 대역폭 (Bandwidth)	Bytes/s	수신/송신 초당 처리량
RX/TX 바이트 (Bytes)	Bytes	누적 수신/송신 바이트
RX/TX 패킷 (Packets)	Count	수신/송신 패킷 수
RX/TX 드롭 (Dropped)	Count	수신/송신 중 유실된 패킷 수
RX/TX 에러 (Errors)	Count	수신/송신 에러 발생 수

• 여러 네트워크 인터페이스가 있는 경우 인터페이스별 분리 조회가 가능합니다.

스토리지 메트릭

메트릭	단위	설명
사용량 (Usage)	Bytes	디스크 사용 용량
읽기/쓰기 처리량 (Throughput)	Bytes/s	읽기/쓰기 초당 전송량
읽기/쓰기 IOPS	ops/s	초당 I/O 작업 수
읽기/쓰기 지연 시간 (Latency)	sec	I/O 응답 시간

• 여러 블록 스토리지가 연결된 경우 디스크별 분리 조회가 가능합니다.

2.4 차트 유형 변경

각 차트의 우측 상단에서 시각화 유형을 변경할 수 있습니다.

차트 유형	설명
Line (선형)	시계열 데이터를 선으로 표시. 추세 파악에 적합
Area (영역)	선 아래 영역을 채워 표시. 전체적인 양 비교에 적합
Bar (막대)	시간대별 막대 그래프. 구간별 비교에 적합
Grid (테이블)	원시 데이터를 표 형태로 표시. 정확한 수치 확인에 적합

3. 모니터링 메트릭 탐색기

3.1 접근 방법

좌측 사이드바에서 모니터링 > 메트릭을 클릭합니다.

3.2 도구 모음

페이지 상단의 도구 모음에서 전체 차트에 적용되는 기능을 사용할 수 있습니다.

기능	설명
차트 추가	새 차트 패널을 추가합니다 (최대 8개)
새로고침	모든 차트의 데이터를 새로 불러옵니다
CSV 다운로드	모든 차트의 데이터를 CSV 파일로 내려받습니다
링크 복사	현재 차트 설정이 포함된 공유 링크를 클립보드에 복사합니다
저장된 쿼리	자주 사용하는 차트 구성을 저장/불러오기합니다 (최대 20개)

3.3 차트 패널

각 차트 패널은 독립적인 분석 단위입니다.

차트 패널 도구

기능	설명
메트릭 추가	차트에 새 메트릭 쿼리를 추가합니다 (최대 12개)
차트 유형	Line, Area, Bar, Grid 중 선택
설정 (톱니바퀴)	Y축 범위, 범례, 호버 카드 등 상세 설정
위로/아래로 이동	차트 순서를 변경합니다
복제	동일한 설정의 차트를 복사합니다
삭제	차트를 제거합니다 (최소 1개는 유지)

메트릭 쿼리 구성

각 쿼리는 다음 항목을 설정합니다.

[VM 선택] → [카테고리 선택] → [메트릭 선택] → [집계 방식] → [구성 요소 선택]

항목	설명
VM	조회할 가상머신 선택 (검색 가능)
카테고리	CPU, GPU, 메모리, 네트워크, 스토리지 중 선택
메트릭	카테고리에 따른 세부 메트릭 선택
집계 방식	평균(avg), 합계(sum), 최솟값(min), 최댓값(max)
구성 요소	CPU 코어, GPU 카드, 네트워크 인터페이스 등 개별 구성 요소 선택

참고

하나의 차트에 서로 다른 단위의 메트릭을 추가하면 자동으로 좌/우 Y축이 분리됩니다. 단, 최대 2개 단위까지 지원하며, 3개 이상의 단위가 혼합되면 경고가 표시됩니다.

차트 설정 패널

톱니바퀴 아이콘을 클릭하면 차트 우측에 설정 패널이 열립니다.

설정 항목	설명
Y축 범위	각 축의 최솟값/최댓값을 수동 지정 (기본: 자동 스케일링)
Y축 순서 변경	좌/우 Y축을 교체
범례	표시/숨김, 위치(하단/우측) 설정
호버 카드	차트 위 마우스 호버 시 정보 카드 표시/숨김

3.4 차트 줌 기능

차트 영역에서 마우스를 드래그하면 해당 시간 범위로 확대(줌인)됩니다.

• 드래그한 구간이 새로운 시간 범위로 설정됩니다.
• 차트 우측 상단의 줌 되돌리기 버튼으로 이전 범위로 복원할 수 있습니다.
• 배지에 현재 줌 깊이가 표시됩니다 (최대 50단계).
• 시간 범위 필터를 변경하면 줌 이력이 초기화됩니다.

3.5 쿼리 저장 및 공유

쿼리 저장

1. 도구 모음의 저장된 쿼리 드롭다운을 클릭합니다.
2. 저장을 선택합니다.
3. 이름을 입력하고 저장합니다.
4. 저장된 쿼리는 브라우저에 보관되며 (조직별 최대 20개), 같은 브라우저에서 다시 불러올 수 있습니다.

링크 공유

1. 도구 모음의 공유 > 링크 복사를 클릭합니다.
2. 현재 차트 구성(쿼리, 시간 범위, 설정 등)이 URL에 인코딩되어 클립보드에 복사됩니다.
3. 해당 링크를 다른 사용자에게 전달하면 동일한 차트 화면을 볼 수 있습니다.

3.6 알림 규칙 표시

모니터링 메트릭 차트에는 활성화된 알림 규칙이 자동으로 오버레이됩니다.

• 차트의 메트릭과 일치하는 알림 규칙이 있으면 임계값 선이 표시됩니다.
• 알림 이벤트가 발생한 시점에는 이벤트 마커가 표시됩니다.

4. 공통 필터 옵션

VM 메트릭 페이지와 모니터링 메트릭 탐색기 모두 동일한 시간 필터를 제공합니다.

4.1 시간 범위

조회할 시간 범위를 선택합니다.

옵션	범위
최근 30분	현재 시각 기준 30분 전부터
최근 1시간	현재 시각 기준 1시간 전부터
최근 4시간	현재 시각 기준 4시간 전부터
최근 12시간	현재 시각 기준 12시간 전부터
최근 24시간	현재 시각 기준 24시간 전부터
최근 48시간	현재 시각 기준 48시간 전부터
최근 3일	현재 시각 기준 3일 전부터
최근 7일	현재 시각 기준 7일 전부터
최근 30일	현재 시각 기준 30일 전부터
사용자 지정	시작/종료 시각을 직접 지정

프리셋(최근 N시간/일)을 선택하면 현재 시각 기준으로 자동 갱신됩니다.

4.2 시간 단위 (Granularity)

데이터 집계 간격을 설정합니다. 간격이 짧을수록 상세하지만 데이터 포인트가 많아집니다.

옵션	설명
자동 (기본)	시간 범위에 맞춰 적절한 간격을 자동 선택
1분	1분 단위로 집계
5분	5분 단위로 집계
15분	15분 단위로 집계
30분	30분 단위로 집계
1시간	1시간 단위로 집계
4시간	4시간 단위로 집계
12시간	12시간 단위로 집계
24시간	24시간 단위로 집계

자동 시간 단위 매핑 기준:

시간 범위	자동 적용 단위
최근 30분	1분
최근 1시간	1분
최근 4시간	5분
최근 12시간	15분
최근 24시간	30분
최근 48시간	1시간
최근 3일	1시간
최근 7일	4시간
최근 30일	12시간

참고

데이터 포인트가 240개를 초과하면 경고 메시지가 표시됩니다. 이 경우 시간 범위를 줄이거나 시간 단위를 늘려주세요.

4.3 집계 방식

같은 시간 단위 내의 데이터를 어떻게 집계할지 선택합니다.

방식	설명	활용 예시
평균 (기본)	구간 내 평균값	일반적인 사용률 추이 확인
합계	구간 내 합산값	누적 트래픽, 총 전송량 확인
최솟값	구간 내 최저값	최소 리소스 사용량 확인
최댓값	구간 내 최고값	피크 사용량 확인, 병목 탐지

5. 활용 시나리오

5.1 VM CPU 사용률이 높을 때 원인 분석

1. VM 메트릭 페이지에서 CPU를 선택합니다.
2. 시간 범위를 최근 4시간으로 설정합니다.
3. 세부 메트릭에서 User, System, I/O Wait를 체크합니다.
4. User가 높으면 → 애플리케이션 부하, System이 높으면 → 커널 작업 과다, I/O Wait가 높으면 → 디스크 병목을 의심합니다.

5.2 여러 VM의 GPU 사용률 비교

1. 모니터링 메트릭 탐색기로 이동합니다.
2. 첫 번째 쿼리에서 VM-A를 선택하고 GPU > 사용률을 설정합니다.
3. 메트릭 추가를 클릭하여 VM-B, VM-C를 같은 방식으로 추가합니다.
4. 하나의 차트에서 여러 VM의 GPU 사용률을 비교합니다.

5.3 네트워크 트래픽 급증 구간 확인

1. VM 메트릭 페이지에서 네트워크를 선택합니다.
2. 시간 범위를 최근 24시간, 집계 방식을 최댓값으로 설정합니다.
3. 대역폭(Bandwidth) 차트에서 피크 구간을 확인합니다.
4. 해당 구간을 마우스 드래그로 줌인하여 상세 분석합니다.

5.4 분석 결과를 팀에 공유

1. 모니터링 메트릭 탐색기에서 원하는 차트를 구성합니다.
2. 도구 모음에서 공유 > 링크 복사를 클릭합니다.
3. 복사된 링크를 팀원에게 전달합니다.
4. 자주 사용하는 구성은 저장된 쿼리에 저장해 두면 빠르게 불러올 수 있습니다.

6. 자주 묻는 질문 (FAQ)

Q. 메트릭 데이터가 표시되지 않습니다.

• VM이 실행 중 상태인지 확인하세요. 중지된 VM은 메트릭이 수집되지 않습니다.
• 선택한 시간 범위에 데이터가 없을 수 있습니다. 시간 범위를 넓혀보세요.
• 메트릭 조회 권한(ACL.Metric.Metric.READ)이 있는지 관리자에게 확인하세요.

Q. 차트에 "데이터 포인트 초과" 경고가 표시됩니다.

시간 단위를 늘리거나(예: 1분 → 5분) 시간 범위를 줄여 데이터 포인트 수를 240개 이하로 조정하세요.

Q. GPU 메트릭 옵션이 보이지 않습니다.

해당 VM에 GPU가 할당되어 있지 않으면 GPU 옵션은 자동으로 숨겨집니다.

Q. 저장된 쿼리가 다른 브라우저에서 보이지 않습니다.

저장된 쿼리는 브라우저의 로컬 저장소(localStorage)에 보관됩니다. 다른 브라우저나 기기에서 접근하려면 링크 공유 기능을 사용하세요.

Q. 모니터링 메트릭 탐색기에서 차트를 더 추가할 수 없습니다.

차트는 최대 8개, 차트당 쿼리는 최대 12개까지 추가할 수 있습니다. 불필요한 차트를 삭제하거나 기존 차트에 쿼리를 추가하는 방식을 활용하세요.