VMware Aria Operations
고지사항: 이는 커뮤니티 유지 관리 오픈소스 프로젝트이며, VMware, Inc. 또는 Broadcom Inc.와 제휴, 보증 또는 후원 관계가 아닙니다. "VMware" 및 "Aria"는 Broadcom의 상표입니다. 소스 코드는 github.com/zw008/VMware-Aria에서 MIT 라이선스 하에 공개적으로 감사 가능합니다.
VMware Aria Operations(vRealize Operations) AI 지원 모니터링 — 리소스, 알림, 알림 정의, 용량 계획, 이상 징후 감지, 보고서 자동화 및 플랫폼 상태를 위한 27개의 MCP 도구.
Aria Operations 8.x / vRealize Operations 8.x를 위한 도메인 중심 모니터링 스킬입니다. 보완 스킬: vmware-nsx (네트워킹), vmware-aiops (VM 라이프사이클), vmware-monitor (vSphere 읽기 전용), vmware-avi (AVI/ALB/AKO), vmware-harden (규정 준수 기준선). | vmware-pilot (워크플로 오케스트레이션) | vmware-policy (감사/정책)
이 스킬의 기능
| 카테고리 | 도구 | 개수 |
|---|---|---|
| 리소스 | 목록, 세부 정보, 메트릭, 상태 배지, 최고 소비자 | 5 |
| 알림 | 목록, 세부 정보, 확인, 취소, 정의 목록 | 5 |
| 알림 정의 | 증상 목록, 정의 생성, 활성화/비활성화, 삭제 | 4 |
| 용량 | 클러스터 개요, 남은 용량, 잔여 시간, 적정 규모 조정 | 4 |
| 보고서 | 템플릿 목록, 생성, 목록, 상태+다운로드 URL 조회, 삭제 | 5 |
| 이상 징후 | 이상 징후 목록, 위험 배지 | 2 |
| 상태 | Aria 플랫폼 상태, 수집기 그룹 상태 | 2 |
합계: 27개 도구 (읽기 전용 20개 + 쓰기 7개)
빠른 설치
uv tool install vmware-aria
vmware-aria doctor
이 스킬을 사용해야 할 때
성능 모니터링 (일일 사전 예방적 점검):
- VM 경합 확인: CPU 준비율, 메모리 벌룬, 스왑 사용량
- 모든 리소스에 대한 시계열 메트릭 조회 (CPU, 메모리, 디스크, 네트워크)
- CPU/메모리/디스크/네트워크별 최고 소비자 찾기
- 리소스별 이상 징후 개수 및 위험 배지 점수 확인
알림 관리:
- 활성 알림 목록, 조사, 확인 또는 취소
- 알림 정의(템플릿) 목록 또는 필터링
- 증상 정의에서 새 알림 정의 생성 (사후 원인 분석)
- 알림 정의 활성화 또는 비활성화; 오래된 정의 삭제
용량 계획:
- 클러스터 남은 용량 (CPU, 메모리, 디스크 여유 공간)
- 클러스터별 완전 포화 예측까지 남은 시간
- 적정 규모 조정: 과잉 프로비저닝 또는 과소 활용 VM 찾기
- Aria 내장 권장 사항이 포함된 용량 개요
보고서 자동화:
- 예약 또는 온디맨드 보고서 생성 (용량, 성능, SLA)
- 보고서 상태를 COMPLETED가 될 때까지 폴링; PDF/CSV 다운로드 URL 획득
- 다운로드 후 생성된 보고서 삭제
보완 스킬 사용 대상:
- VM 라이프사이클: 생성, 복제, 스냅샷, 전원 →
vmware-aiops - NSX 네트워킹: 세그먼트, 게이트웨이, NAT, 라우팅 →
vmware-nsx - vSphere 인벤토리, 실시간 알람, 이벤트 →
vmware-monitor - 스토리지: iSCSI, vSAN, 데이터스토어 →
vmware-storage - 로드 밸런싱, AVI/ALB, AKO, Ingress →
vmware-avi
관련 스킬 — 스킬 라우팅
| 사용자 의도 | 권장 스킬 |
|---|---|
| Aria Operations 모니터링, 알림, 용량 | vmware-aria ← 이 스킬 |
| VM 라이프사이클, 배포, 게스트 작업 | vmware-aiops |
| NSX 네트워킹: 세그먼트, 게이트웨이, NAT, 라우팅 | vmware-nsx |
| vSphere 인벤토리, 이벤트, 알람 읽기 전용 | vmware-monitor |
| 스토리지: iSCSI, vSAN, 데이터스토어 | vmware-storage |
| 승인 포함 다단계 워크플로 | vmware-pilot |
| 규정 준수 기준선 (CIS / 等保 / PCI-DSS), 드리프트 감지, LLM 수정 조언자 | vmware-harden (uv tool install vmware-harden) |
| 로드 밸런서, AVI, ALB, AKO, Ingress | vmware-avi (uv tool install vmware-avi) |
| 감사 로그 쿼리 | vmware-policy (vmware-audit CLI) |
일반 워크플로
진단 조사: "X가 느리다/실패했다/다운되었다"는 워크플로를 실행하기 전에
references/investigation-protocol.md를 따르십시오. 이 프로토콜은 네 가지 근본 원인 완전성 기준(반증 가능성/충분성/필요성/메커니즘)과 최대 3회 심화 루프를 강제합니다. 부분적인 결론에서 멈추는 것은 안티패턴입니다 — 보고서를 출력하기 전에 항상 기준에 따라 자체 점검하십시오.
일일 VM 상태 점검 (사전 예방적 운영)
판단: 가장 높은 CPU 소비자를 쫓지 말고 가장 높은 경합 소비자를 쫓으십시오. 조용한 호스트에서 CPU 90%인 VM은 정상입니다. CPU 30%지만 준비율 15%인 VM은 기아 상태입니다. 주요 메트릭: CPU 준비율, 메모리 벌룬, 디스크 지연 시간.
- 최고 CPU 소비자 찾기 →
vmware-aria resource top --metric cpu|usage_average --top 20(이는 시작 집합이며 답이 아닙니다) - 핫 VM의 CPU 준비율 확인 →
vmware-aria resource metrics <vm-id> --metrics cpu.ready.summation --hours 24-
5% = 경고, >10% = 문제, >20% = 심각
-
- 메모리 압력 확인 →
vmware-aria resource metrics <vm-id> --metrics mem.balloon.average,mem.swapped.average --hours 24- 벌룬 >0 = ESXi가 메모리 회수 중; 스왑 >0 = 심각 — 즉시 조치
- 활성 CRITICAL/IMMEDIATE 알림 목록 →
vmware-aria alert list --criticality CRITICAL - 이상 징후 개수 확인 →
vmware-aria anomaly list - "근본 원인"을 보고하기 전에 조사 프로토콜을 교차 검증 — 높은 소비는 거의 근본 원인이 아니라 일반적으로 하위 증상입니다
높은 CPU 알림 조사
- 활성 CRITICAL 알림 목록 →
vmware-aria alert list --criticality CRITICAL - 알림 세부 정보 + 증상 확인 →
vmware-aria alert get <alert-id> - 최고 CPU 소비자 찾기 →
vmware-aria resource top --metric cpu|usage_average - 핫 VM의 24시간 CPU 메트릭 가져오기 →
vmware-aria resource metrics <vm-id> --metrics cpu|usage_average --hours 24 - 위험 배지 확인 →
vmware-aria anomaly risk <vm-id> - 알림 확인 →
vmware-aria alert acknowledge <alert-id>
용량 계획
- 클러스터 목록 →
vmware-aria resource list --kind ClusterComputeResource - 남은 용량 확인 →
vmware-aria capacity remaining <cluster-id> - 완전 포화까지 예측 시간 →
vmware-aria capacity time-remaining <cluster-id> - 권장 사항이 포함된 용량 개요 확인 →
vmware-aria capacity overview <cluster-id> - 적정 규모 조정 후보 찾기 →
vmware-aria capacity rightsizing
사후 대응: 감지 알림 생성 (사후 원인 분석 후속 조치)
인시던트 해결 후 재발 방지를 위한 조기 경고 알림을 생성합니다. 알림 정의 관리는 MCP 전용입니다 (CLI 하위 명령어 없음):
- 일치하는 증상 정의 찾기 → MCP
list_symptom_definitions(name_filter/resource_kind로 필터링) - 증상을 참조하는 알림 정의 생성 → MCP
create_alert_definition(이름, resource_kind, symptom_definition_ids, criticality 사용 — 증상 하나라도 발동하면 알림 트리거) - 정의에 나타나는지 확인 →
vmware-aria alert definitions --name "Gold VM CPU"(표시된 criticality는 정의 상태 전체의 최대 심각도입니다) - 나중에 활성화 또는 비활성화 → MCP
set_alert_definition_state
용량 보고서 생성
- 보고서 템플릿 찾기 →
vmware-aria report definitions --name "Capacity" - 보고서 생성 트리거 →
vmware-aria report generate <definition-id> --resources <resource-id>(Report API는 최소 하나의 리소스 UUID 필요) - 완료될 때까지 폴링 →
vmware-aria report get <report-id>(status == COMPLETED가 될 때까지 반복) - 반환된
download_url(PDF) 또는csv_url을 통해 다운로드 - 정리 →
vmware-aria report delete <report-id>
다중 대상 작업
모든 명령은 특정 Aria Ops 인스턴스에 대해 작동하도록 --target <name>을 허용합니다:
vmware-aria alert list --target prod
vmware-aria resource top --target lab
사용 모드
| 시나리오 | 권장 | 이유 |
|---|---|---|
| 로컬/소형 모델 (Ollama, Qwen) | CLI | MCP의 ~8K 대비 ~2K 토큰 |
| 클라우드 모델 (Claude, GPT-4o) | 둘 다 가능 | MCP는 구조화된 JSON I/O 제공 |
| 자동화된 파이프라인 | MCP | 타입 안전 매개변수, 구조화된 출력 |
MCP 도구 (27개 — 읽기 20개, 쓰기 7개)
모든 MCP 도구는 연결할 Aria Operations 인스턴스를 선택하기 위해 선택적 target 매개변수를 허용합니다.
| 카테고리 | 도구 | 유형 | 설명 |
|---|---|---|---|
| 리소스 | list_resources | 읽기 | 리소스 종류별 VM, 호스트, 클러스터 목록 |
get_resource | 읽기 | 상태, 위험, 효율성 배지가 포함된 리소스 세부 정보 가져오기 | |
get_resource_metrics | 읽기 | 모든 리소스에 대한 시계열 메트릭 통계 가져오기 | |
get_resource_health | 읽기 | 상태 배지 점수(0–100) 가져오기 | |
get_top_consumers | 읽기 | CPU, 메모리, 디스크 또는 네트워크 사용량별 리소스 순위 | |
| 알림 | list_alerts | 읽기 | criticality 및 리소스 ID로 활성 알림 목록 조회 (get_resource로 이름 확인) |
get_alert | 읽기 | 기여 증상이 포함된 알림 세부 정보 가져오기 (권장 사항은 알림 정의에 있음) | |
acknowledge_alert | 쓰기 | 알림을 확인됨으로 표시 (닫지는 않음) | |
cancel_alert | 쓰기 | 활성 알림 취소 (해제) | |
list_alert_definitions | 읽기 | Aria Ops에 구성된 알림 템플릿 목록 | |
| 알림 정의 | list_symptom_definitions | 읽기 | 증상 정의 목록 — 알림 정의 생성 시 ID 사용 |
create_alert_definition | 쓰기 | 증상 정의 ID에서 새 알림 정의 생성 | |
set_alert_definition_state | 쓰기 | 알림 정의 활성화 또는 비활성화 | |
delete_alert_definition | 쓰기 | 알림 정의 영구 삭제 | |
| 용량 | get_capacity_overview | 읽기 | 그룹 수준 남은 % + 차원별 여유 공간 및 완전 포화까지 남은 일수 |
get_remaining_capacity | 읽기 | 한계 도달 전 남은 CPU, 메모리, 디스크 | |
get_time_remaining | 읽기 | 클러스터 용량이 소진될 때까지 남은 일수 | |
list_rightsizing_recommendations | 읽기 | 크기 조정할 VM: 과잉/과소 프로비저닝 | |
| 보고서 | list_report_definitions | 읽기 | 사용 가능한 보고서 정의 템플릿 목록 |
generate_report | 쓰기 | 보고서 생성 트리거 (비동기; report_id 반환) | |
list_reports | 읽기 | 생성된 보고서 목록 (선택적으로 정의별) | |
get_report | 읽기 | 보고서 상태 폴링 + PDF/CSV 다운로드 URL 가져오기 | |
delete_report | 쓰기 | 생성된 보고서 삭제 | |
| 이상 징후 | list_anomalies | 읽기 | 리소스별 이상 징후 개수 (System Attributes |
get_resource_riskbadge | 읽기 | 위험 점수 (0–100): 향후 문제 발생 가능성 | |
| 상태 | get_aria_health | 읽기 | Aria 플랫폼 노드 상태 (ONLINE/OFFLINE) |
list_collector_groups | 읽기 | 수집기 에이전트 상태 및 연결성 |
읽기/쓰기 구분: 읽기 전용 20개, 쓰기 7개. 모든 쓰기 작업은 ~/.vmware/audit.db에 감사 로깅됩니다 (vmware-policy 통해).
CLI 빠른 참조
# 리소스
vmware-aria resource list [--kind VirtualMachine|HostSystem|ClusterComputeResource] [--name <filter>]
vmware-aria resource get <resource-id>
vmware-aria resource metrics <resource-id> --metrics cpu|usage_average,mem|usage_average --hours 4
vmware-aria resource metrics <vm-id> --metrics cpu.ready.summation,mem.balloon.average --hours 24
vmware-aria resource health <resource-id>
vmware-aria resource top --metric cpu|usage_average --kind VirtualMachine --top 10
# 알림
vmware-aria alert list [--criticality CRITICAL|IMMEDIATE|WARNING|INFORMATION]
vmware-aria alert get <alert-id>
vmware-aria alert acknowledge <alert-id>
vmware-aria alert cancel <alert-id>
vmware-aria alert definitions [--name <filter>]
# 알림 정의: 생성/활성화/비활성화/삭제 및 증상 정의
# 조회는 MCP 전용 도구(list_symptom_definitions, create_alert_definition,
# set_alert_definition_state, delete_alert_definition)입니다 — CLI 하위 명령어 없음.
# 용량
vmware-aria capacity overview <cluster-id>
vmware-aria capacity remaining <resource-id>
vmware-aria capacity time-remaining <resource-id>
vmware-aria capacity rightsizing [--resource-id <vm-id>]
# 보고서 (비동기: 생성 → 폴링 get → 다운로드 → 삭제)
vmware-aria report definitions [--name <filter>]
vmware-aria report generate <definition-id> --resources <id1,id2> # 최소 하나의 리소스 UUID 필요
vmware-aria report list [--definition-id <id>]
vmware-aria report get <report-id> # status == COMPLETED가 될 때까지 폴링; download_url 표시
vmware-aria report delete <report-id>
# 이상 징후
vmware-aria anomaly list [--resource-id <id>]
vmware-aria anomaly risk <resource-id>
# 상태
vmware-aria health status
vmware-aria health collectors
# 진단
vmware-aria doctor [--skip-auth]
주요 메트릭 이름 (resource metrics 명령용)
| 메트릭 | API 키 | 의미 |
|---|---|---|
| CPU 준비율 | cpu.ready.summation | vCPU가 물리적 코어를 기다리는 시간; >5% = 경고 |
| CPU 사용 | cpu.used.summation | 실제 CPU 실행 시간 |
| CPU 수요 | cpu.demand.average | VM이 요청한 총 MHz |
| 활성 메모리 | mem.active.average | 게스트 OS에서 활발히 사용 중 (크기 조정) |
| 소비된 메모리 | mem.consumed.average | 호스트의 점유 공간 (용량) |
| 메모리 벌룬 | mem.balloon.average | >0 = ESXi가 메모리 회수 중 |
| 메모리 스왑 | mem.swapped.average | >0 = 심각한 압력 |
| 디스크 읽기 지연 시간 | disk.read.average | 읽기 I/O 지연 시간 ms |
| 디스크 쓰기 지연 시간 | disk.write.average | 쓰기 I/O 지연 시간 ms |
| 수신 네트워크 | net.received.average | 인바운드 네트워크 KB/s |
| 송신 네트워크 | net.transmitted.average | 아웃바운드 네트워크 KB/s |
모든 옵션 및 출력 형식에 대한 전체 CLI 참조:
references/cli-reference.md참조
문제 해결
설정 후 "토큰을 찾을 수 없음" 오류
...