zw008/VMware-Aria

VMware Aria Operations

Haftungsausschluss: Dies ist ein von der Community gepflegtes Open-Source-Projekt und wird nicht von VMware, Inc. oder Broadcom Inc. unterstützt, empfohlen oder gesponsert. „VMware“ und „Aria“ sind Marken von Broadcom. Der Quellcode ist öffentlich unter github.com/zw008/VMware-Aria unter der MIT-Lizenz einsehbar.

VMware Aria Operations (vRealize Operations) KI-gestützte Überwachung – 27 MCP-Tools für Ressourcen, Alarme, Alarmdefinitionen, Kapazitätsplanung, Anomalieerkennung, Berichtsautomatisierung und Plattform-Gesundheit.

Domänenfokussiertes Überwachungs-Skill für Aria Operations 8.x / vRealize Operations 8.x. Begleit-Skills: vmware-nsx (Netzwerk), vmware-aiops (VM-Lebenszyklus), vmware-monitor (schreibgeschütztes vSphere), vmware-avi (AVI/ALB/AKO), vmware-harden (Compliance-Baselines). | vmware-pilot (Workflow-Orchestrierung) | vmware-policy (Audit/Policy)

Was dieses Skill kann

Kategorie	Tools	Anzahl
Ressourcen	auflisten, Details abrufen, Metriken, Health-Badge, Top-Verbraucher	5
Alarme	auflisten, Details abrufen, quittieren, stornieren, Definitionen auflisten	5
Alarmdefinitionen	Symptome auflisten, Definition erstellen, aktivieren/deaktivieren, löschen	4
Kapazität	Cluster-Übersicht, verbleibende Kapazität, verbleibende Zeit, Rightsizing	4
Berichte	Vorlagen auflisten, generieren, auflisten, Status + Download-URL abrufen, löschen	5
Anomalien	Anomalien auflisten, Risiko-Badge	2
Gesundheit	Aria-Plattform-Gesundheit, Collector-Gruppen-Status	2

Gesamt: 27 Tools (20 schreibgeschützt + 7 schreibend)

Schnellinstallation

uv tool install vmware-aria
vmware-aria doctor

Wann dieses Skill verwendet werden sollte

Leistungsüberwachung (tägliche proaktive Prüfungen):

• VM-Überlastung prüfen: CPU Ready %, Memory Balloon, Swap-Nutzung
• Zeitreihenmetriken für jede Ressource abrufen (CPU, Arbeitsspeicher, Festplatte, Netzwerk)
• Top-Verbraucher nach CPU/Arbeitsspeicher/Festplatte/Netzwerk finden
• Anomalieanzahl und Risiko-Badge-Score pro Ressource prüfen

Alarmverwaltung:

• Aktive Alarme auflisten, untersuchen, quittieren oder stornieren
• Alarmdefinitionen (Vorlagen) auflisten oder filtern
• Neue Alarmdefinitionen aus Symptomdefinitionen erstellen (nach RCA)
• Alarmdefinitionen aktivieren oder deaktivieren; veraltete löschen

Kapazitätsplanung:

• Verbleibende Cluster-Kapazität (CPU, Arbeitsspeicher, Festplattenreserve)
• Vorhersage der Zeit bis zur Vollauslastung pro Cluster
• Rightsizing: Über- oder unterdimensionierte VMs finden
• Kapazitätsübersicht mit den integrierten Empfehlungen von Aria

Berichtsautomatisierung:

• Geplante oder bedarfsgesteuerte Berichte generieren (Kapazität, Leistung, SLA)
• Berichtsstatus abfragen, bis „COMPLETED“; PDF/CSV-Download-URL abrufen
• Generierte Berichte nach dem Download löschen

Begleit-Skills verwenden für:

• VM-Lebenszyklus: erstellen, klonen, Snapshot, Stromversorgung → vmware-aiops
• NSX-Netzwerk: Segmente, Gateways, NAT, Routing → vmware-nsx
• vSphere-Inventar, Echtzeit-Alarme, Ereignisse → vmware-monitor
• Speicher: iSCSI, vSAN, Datastores → vmware-storage
• Lastausgleich, AVI/ALB, AKO, Ingress → vmware-avi

Verwandte Skills – Skill-Routing

Benutzerabsicht	Empfohlenes Skill
Aria Operations-Überwachung, Alarme, Kapazität	vmware-aria ← dieses Skill
VM-Lebenszyklus, Bereitstellung, Gastbetrieb	vmware-aiops
NSX-Netzwerk: Segmente, Gateways, NAT, Routing	vmware-nsx
Schreibgeschütztes vSphere-Inventar, Ereignisse, Alarme	vmware-monitor
Speicher: iSCSI, vSAN, Datastores	vmware-storage
Mehrstufige Workflows mit Genehmigung	vmware-pilot
Compliance-Baselines (CIS / 等保 / PCI-DSS), Drifterkennung, LLM-Beratungsassistent	vmware-harden (uv tool install vmware-harden)
Load Balancer, AVI, ALB, AKO, Ingress	vmware-avi (uv tool install vmware-avi)
Audit-Log-Abfrage	vmware-policy (vmware-audit CLI)

Häufige Workflows

Diagnostische Untersuchungen: Bevor Sie einen Workflow mit der Frage „Warum ist X langsam / fehlerhaft / ausgefallen?“ ausführen, befolgen Sie das references/investigation-protocol.md. Es erzwingt die vier Vollständigkeitskriterien für die Ursachenanalyse (Falsifizierbarkeit / Hinlänglichkeit / Notwendigkeit / Mechanismus) und die Vertiefungsschleife von bis zu drei Runden. Bei einer Teil-Schlussfolgerung stehen zu bleiben, ist ein Anti-Pattern – überprüfen Sie sich immer selbst anhand der Kriterien, bevor Sie einen Bericht ausgeben.

Täglicher VM-Gesundheitscheck (Proaktiver Betrieb)

Urteil: Lassen Sie nicht den höchsten CPU-Verbraucher jagen, sondern den höchsten Überlastungs-Verbraucher. Eine VM mit 90 % CPU auf einem ruhigen Host ist gesund; eine VM mit 30 % CPU, aber 15 % Ready hungert. Schlüsselmetriken: CPU Ready, Memory Balloon, Disk Latency.

1. Top-CPU-Verbraucher finden → vmware-aria resource top --metric cpu|usage_average --top 20 (dies ist die Startmenge, nicht die Antwort)
2. CPU Ready auf heißen VMs prüfen → vmware-aria resource metrics <vm-id> --metrics cpu.ready.summation --hours 24

   • 5 % = Warnung, >10 % = Problem, >20 % = kritisch

3. Speicherdruck prüfen → vmware-aria resource metrics <vm-id> --metrics mem.balloon.average,mem.swapped.average --hours 24
   • Balloon >0 = ESXi gibt Speicher zurück; Swap >0 = schwerwiegend – sofort handeln
4. Aktive KRITISCHE/SOFORT-Alarme auflisten → vmware-aria alert list --criticality CRITICAL
5. Anomalieanzahl prüfen → vmware-aria anomaly list
6. Vor der Meldung einer „Ursache“ gegen das Untersuchungsprotokoll validieren – hohe Auslastung ist selten die Ursache, sondern meist ein nachgelagertes Symptom

Hohen CPU-Alarm untersuchen

1. Aktive KRITISCHE Alarme auflisten → vmware-aria alert list --criticality CRITICAL
2. Alarmdetails + Symptome abrufen → vmware-aria alert get <alert-id>
3. Top-CPU-Verbraucher finden → vmware-aria resource top --metric cpu|usage_average
4. 24h-CPU-Metriken für die heiße VM abrufen → vmware-aria resource metrics <vm-id> --metrics cpu|usage_average --hours 24
5. Risiko-Badge prüfen → vmware-aria anomaly risk <vm-id>
6. Alarm quittieren → vmware-aria alert acknowledge <alert-id>

Kapazitätsplanung

1. Cluster auflisten → vmware-aria resource list --kind ClusterComputeResource
2. Verbleibende Kapazität abrufen → vmware-aria capacity remaining <cluster-id>
3. Zeit bis zur Vollauslastung vorhersagen → vmware-aria capacity time-remaining <cluster-id>
4. Kapazitätsübersicht mit Empfehlungen abrufen → vmware-aria capacity overview <cluster-id>
5. Rightsizing-Kandidaten finden → vmware-aria capacity rightsizing

Nach einem Vorfall: Erkennungsalarm erstellen (RCA-Follow-up)

Erstellen Sie nach der Behebung eines Vorfalls einen Frühwarnalarm, um ein erneutes Auftreten zu verhindern. Die Verwaltung von Alarmdefinitionen erfolgt nur über MCP (keine CLI-Unterbefehle):

1. Passende Symptomdefinitionen finden → MCP list_symptom_definitions (Filtern nach name_filter / resource_kind)
2. Alarmdefinition unter Bezugnahme auf Symptome erstellen → MCP create_alert_definition mit Name, resource_kind, symptom_definition_ids, Kritikalität (jedes auslösende Symptom löst den Alarm aus)
3. Überprüfen, ob sie in den Definitionen erscheint → vmware-aria alert definitions --name "Gold VM CPU" (angezeigte Kritikalität ist die maximale Schwere über die Zustände der Definition hinweg)
4. Später aktivieren oder deaktivieren → MCP set_alert_definition_state

Kapazitätsbericht generieren

1. Berichtsvorlage finden → vmware-aria report definitions --name "Capacity"
2. Berichtsgenerierung auslösen → vmware-aria report generate <definition-id> --resources <resource-id> (die Report-API erfordert mindestens eine Ressourcen-UUID)
3. Bis zum Abschluss abfragen → vmware-aria report get <report-id> (wiederholen, bis status == COMPLETED)
4. Über die zurückgegebene download_url (PDF) oder csv_url herunterladen
5. Bereinigen → vmware-aria report delete <report-id>

Multi-Target-Operationen

Alle Befehle akzeptieren --target <name>, um gegen eine bestimmte Aria Ops-Instanz zu arbeiten:

vmware-aria alert list --target prod
vmware-aria resource top --target lab

Nutzungsmodus

Szenario	Empfohlen	Warum
Lokale/kleine Modelle (Ollama, Qwen)	CLI	~2K Tokens vs. ~8K für MCP
Cloud-Modelle (Claude, GPT-4o)	Beides	MCP bietet strukturierten JSON-E/A
Automatisierte Pipelines	MCP	Typsichere Parameter, strukturierte Ausgabe

MCP-Tools (27 – 20 lesend, 7 schreibend)

Alle MCP-Tools akzeptieren einen optionalen target-Parameter, um die V erybundene Aria Operations-Instanz auszuwählen.

Kategorie	Tool	Typ	Beschreibung
Ressource	list_resources	Lesen	VMs, Hosts, Cluster nach Ressourcenart auflisten
	get_resource	Lesen	Ressourcendetails mit Health-, Risiko- und Effizienz-Badges abrufen
	get_resource_metrics	Lesen	Zeitreihen-Metrikdaten für jede Ressource abrufen
	get_resource_health	Lesen	Health-Badge-Score (0–100) abrufen
	get_top_consumers	Lesen	Ressourcen nach CPU-, Speicher-, Festplatten- oder Netzwerkauslastung ordnen
Alarme	list_alerts	Lesen	Aktive Alarme mit Kritikalität und Ressourcen-ID auflisten (Namen über get_resource auflösen)
	get_alert	Lesen	Alarmdetails mit beitragenden Symptomen abrufen (Empfehlungen befinden sich auf der Alarmdefinition)
	acknowledge_alert	Schreiben	Alarm als quittiert markieren (schließt ihn nicht)
	cancel_alert	Schreiben	Aktiven Alarm stornieren (verwerfen)
	list_alert_definitions	Lesen	In Aria Ops konfigurierte Alarmvorlagen auflisten
Alarm-Defs	list_symptom_definitions	Lesen	Symptomdefinitionen auflisten – IDs beim Erstellen von Alarmdefinitionen verwenden
	create_alert_definition	Schreiben	Neue Alarmdefinition aus Symptomdefinitions-IDs erstellen
	set_alert_definition_state	Schreiben	Alarmdefinition aktivieren oder deaktivieren
	delete_alert_definition	Schreiben	Alarmdefinition dauerhaft löschen
Kapazität	get_capacity_overview	Lesen	Gruppenebene verbleibende % + Reserve pro Dimension und Tage bis zur Vollauslastung
	get_remaining_capacity	Lesen	Verbleibende CPU, Arbeitsspeicher, Festplatte vor Erreichen der Grenzen
	get_time_remaining	Lesen	Tage bis zur Erschöpfung der Cluster-Kapazität
	list_rightsizing_recommendations	Lesen	Zu ändernde VMs: über-/unterdimensioniert
Berichte	list_report_definitions	Lesen	Verfügbare Berichtsvorlagen auflisten
	generate_report	Schreiben	Berichtsgenerierung auslösen (async; gibt report_id zurück)
	list_reports	Lesen	Generierte Berichte auflisten, optional nach Definition
	get_report	Lesen	Berichtsstatus abfragen + PDF/CSV-Download-URLs abrufen
	delete_report	Schreiben	Generierten Bericht löschen
Anomalie	list_anomalies	Lesen	Anomalienanzahl pro Ressource (System Attributes
	get_resource_riskbadge	Lesen	Risikoscore (0–100): Wahrscheinlichkeit zukünftiger Probleme
Gesundheit	get_aria_health	Lesen	Status der Aria-Plattformknoten (ONLINE/OFFLINE)
	list_collector_groups	Lesen	Status und Konnektivität der Collector-Agenten

Aufteilung Lesen/Schreiben: 20 schreibgeschützt, 7 schreibend. Alle Schreibvorgänge werden in ~/.vmware/audit.db auditprotokolliert (über vmware-policy).

CLI-Kurzreferenz

# Ressourcen
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

# Alarme
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>]

# Alarmdefinitionen: Erstellung/Aktivierung/Deaktivierung/Löschung und Symptomdefinition-
# Suche sind reine MCP-Tools (list_symptom_definitions, create_alert_definition,
# set_alert_definition_state, delete_alert_definition) – keine CLI-Unterbefehle.

# Kapazität
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>]

# Berichte (async: generieren → abfragen get → herunterladen → löschen)
vmware-aria report definitions [--name <filter>]
vmware-aria report generate <definition-id> --resources <id1,id2>   # mindestens eine Ressourcen-UUID erforderlich
vmware-aria report list [--definition-id <id>]
vmware-aria report get <report-id>        # abfragen, bis status == COMPLETED; zeigt download_url
vmware-aria report delete <report-id>

# Anomalie
vmware-aria anomaly list [--resource-id <id>]
vmware-aria anomaly risk <resource-id>

# Gesundheit
vmware-aria health status
vmware-aria health collectors

# Diagnose
vmware-aria doctor [--skip-auth]

Wichtige Metriknamen (für den Befehl resource metrics)

Metrik	API-Schlüssel	Bedeutung
CPU Ready %	cpu.ready.summation	vCPU wartet auf physischen Kern; >5 % = Warnung
CPU Used	cpu.used.summation	Tatsächliche CPU-Ausführungszeit
CPU Demand	cpu.demand.average	Von VM angeforderte Gesamt-MHz
Memory Active	mem.active.average	Aktiv vom Gastbetriebssystem genutzt (Dimensionierung)
Memory Consumed	mem.consumed.average	Speicher-Fußabdruck auf dem Host (Kapazität)
Memory Balloon	mem.balloon.average	>0 = ESXi gibt Speicher zurück
Memory Swap	mem.swapped.average	>0 = schwerwiegender Druck
Disk Read Latency	disk.read.average	Lese-I/O-Latenz in ms
Disk Write Latency	disk.write.average	Schreib-I/O-Latenz in ms
Net Received	net.received.average	Eingehendes Netzwerk in KB/s
Net Transmitted	net.transmitted.average	Ausgehendes Netzwerk in KB/s

Vollständige CLI-Referenz mit allen Optionen und Ausgabeformaten: siehe references/cli-reference.md

Fehlerbehebung

Fehler "Token not found" nach dem Setzen

...