zw008/VMware-Monitor

VMware Monitor (Nur-Lesen)

Haftungsausschluss: Dies ist ein von der Community betreutes Open-Source-Projekt und steht in keiner Verbindung zu VMware, Inc. oder Broadcom Inc., wird nicht von diesen unterstützt oder gesponsert. „VMware“ und „vSphere“ sind Marken von Broadcom. Der Quellcode ist öffentlich unter github.com/zw008/VMware-Monitor unter der MIT-Lizenz einsehbar.

Nur-Lesen-Überwachung von VMware vCenter/ESXi — 11 MCP-Tools, kein destruktiver Code.

Sicherheit auf Codeebene: Diese Fähigkeit enthält KEINE Power-, Erstell-, Lösch-, Snapshot- oder Änderungsoperationen. Nicht deaktiviert – sie existieren nicht im Code. Begleitfähigkeiten: vmware-aiops (VM-Lebenszyklus), vmware-storage (iSCSI/vSAN), vmware-vks (Tanzu Kubernetes), vmware-nsx (NSX-Netzwerk), vmware-nsx-security (DFW/Firewall), vmware-aria (Metriken/Alarme/Kapazität), vmware-avi (AVI/ALB/AKO), vmware-harden (Compliance-Grundlinien). | vmware-pilot (Workflow-Orchestrierung) | vmware-policy (Audit/Richtlinien)

Was diese Fähigkeit tut

Kategorie	Fähigkeiten
Inventar	VMs, ESXi-Hosts, Datenspeicher, Cluster, Netzwerke auflisten
Zustand	Aktive Alarme, letzte Ereignisse (nach Schweregrad/Zeit gefiltert), Hardwaresensoren, Host-Dienste
VM-Details	CPU, Speicher, Datenträger, NICs, Snapshots, Gastbetriebssystem, IP
Scanning	Geplante Alarm-/Protokollüberprüfung mit Slack/Discord-Webhooks

Schnellinstallation

uv tool install vmware-monitor
vmware-monitor doctor

Wann diese Fähigkeit verwendet werden sollte

• VMs, Hosts, Datenspeicher, Cluster auflisten oder suchen
• Aktive Alarme oder letzte Ereignisse prüfen
• Detaillierte Informationen zu einer bestimmten VM abrufen
• Geplante Überwachung mit Webhook-Benachrichtigungen einrichten
• Jede Nur-Lesen-VMware-Abfrage, bei der Sicherheit oberste Priorität hat

Alarm-/Ereignisausgabe: Feld suggested_actions

Ergebnisse von get_alarms und get_events enthalten eine Liste suggested_actions. Jeder Eintrag ist ein gebrauchsfertiger Hinweis, der auf die richtige Begleitfähigkeit und das richtige Tool verweist:

{
  "alarm_name": "VM CPU Ready High",
  "entity_name": "prod-db-01",
  "suggested_actions": [
    "vmware-aiops: acknowledge_vcenter_alarm(entity_name='prod-db-01', alarm_name='VM CPU Ready High')",
    "vmware-aiops: reset_vcenter_alarm(entity_name='prod-db-01', alarm_name='VM CPU Ready High')"
  ]
}

KI-Agenten (insbesondere kleinere lokale Modelle) können diese Hinweise direkt lesen, um zu bestimmen, welche Fähigkeit und welches Tool als Nächstes aufgerufen werden sollen, ohne selbst über die Fähigkeitsauswahl nachdenken zu müssen.

Begleitfähigkeiten verwenden für:

• Ein-/Ausschalten, Bereitstellen, Klonen, Migrieren --> vmware-aiops
• iSCSI, vSAN, Datenspeicherverwaltung --> vmware-storage
• Tanzu Kubernetes-Cluster --> vmware-vks
• Lastausgleich, AVI/ALB, AKO, Ingress --> vmware-avi

Verwandte Fähigkeiten — Fähigkeitsauswahl

Benutzerabsicht	Empfohlene Fähigkeit
Nur-Lesen-vSphere-Überwachung, kein Risiko	vmware-monitor ← diese Fähigkeit
Speicher: iSCSI, vSAN, Datenspeicher	vmware-storage
VM-Lebenszyklus, Bereitstellung, Gastoperationen	vmware-aiops
Tanzu Kubernetes (vSphere 8.x+)	vmware-vks
NSX-Netzwerke: Segmente, Gateways, NAT	vmware-nsx
NSX-Sicherheit: DFW-Regeln, Sicherheitsgruppen	vmware-nsx-security
Aria Ops: Metriken, Alarme, Kapazitätsplanung	vmware-aria
Mehrstufige Workflows mit Genehmigung	vmware-pilot
Compliance-Grundlinien (CIS / 等保 / PCI-DSS), Abweichungserkennung, LLM-Problembehebungsberater	vmware-harden (uv tool install vmware-harden)
Lastausgleich, AVI, ALB, AKO, Ingress	vmware-avi (uv tool install vmware-avi)
Audit-Log-Abfrage	vmware-policy (vmware-audit CLI)

Allgemeine Workflows

Diagnostische Untersuchungen: Bevor Sie einen Workflow zur Frage „Warum fällt X aus / ist X nicht verfügbar / ungewöhnlich“ ausführen, folgen Sie references/investigation-protocol.md. Es erzwingt die vier Kriterien für die Vollständigkeit der Ursachenanalyse (Falsifizierbarkeit / Hinlänglichkeit / Notwendigkeit / Mechanismus) und die max. drei Runden tiefere Schleife. Da vmware-monitor schreibgeschützt ist, dient es als Datenquelle – die Ausführung gehört zu Begleitfähigkeiten wie vmware-aiops.

Täglicher Zustandscheck

Beurteilung: Alarme sagen Ihnen, was vCenter als falsch entschieden hat, Ereignisse sagen Ihnen, was passiert ist. Sie weichen voneinander ab – ein Ereignisausbruch ohne Alarme deutet oft auf eine Fehlkalibrierung des Metrikschwellenwerts hin, nicht auf „alles in Ordnung“. Lesen Sie beide.

1. Alarme prüfen --> vmware-monitor health alarms --target prod-vcenter — Fokus auf „Rot“-Schweregrad UND Alarme, die älter als 1 Stunde sind (vorübergehende Alarme löschen sich selbst)
2. Letzte Ereignisse prüfen --> vmware-monitor health events --hours 24 --severity warning — Suchen Sie nach wiederholten Ereignissen von derselben Entität (ein einzelnes Ereignis ist Rauschen; 50 Ereignisse in einer Stunde sind ein Muster)
3. Hosts auflisten --> vmware-monitor inventory hosts — Markieren Sie Hosts, die getrennt sind, unerwartet im Wartungsmodus oder mit Speicherauslastung > 90 %
4. Bei Verbindungsfehler --> vmware-monitor doctor ausführen, um Konfigurations-/Netzwerkprobleme zu diagnostizieren

Eine bestimmte VM untersuchen

1. VM finden --> vmware-monitor inventory vms --power-state poweredOff
2. Details abrufen --> vmware-monitor vm info problem-vm
3. Zugehörige Ereignisse prüfen --> vmware-monitor health events --hours 48
4. Wenn VM nicht gefunden --> VM-Namen mit vmware-monitor inventory vms --limit 100 überprüfen oder Ziel mit --target <other-vcenter> prüfen

Kontinuierliche Überwachung einrichten

1. Webhook in ~/.vmware-monitor/config.yaml konfigurieren
2. Daemon starten --> vmware-monitor daemon start
3. Der Daemon scannt alle 15 Minuten und sendet Warnungen an Slack/Discord

Nutzungsmodus

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

MCP-Tools (11 — alle schreibgeschützt)

Tool	Beschreibung
list_virtual_machines	VMs mit Filterung auflisten (Betriebszustand, Sortierung, Begrenzung, folder_filter für groß-/kleinbuchstabenunabhängige Ordnerbaumsuche); jede VM enthält folder_path
list_esxi_hosts	ESXi-Hosts mit CPU, Speicher, Version, Betriebszeit
list_all_datastores	Datenspeicher mit Kapazität, freiem Speicherplatz, Typ
list_all_clusters	Cluster mit Hostanzahl, DRS/HA-Status
list_all_networks	Netzwerke mit Anzahl angeschlossener VMs und Erreichbarkeit
get_alarms	Alle aktiven/ausgelösten Alarme – enthält suggested_actions-Behebungshinweise
get_events	Letzte Ereignisse gefiltert nach Schweregrad und Zeit – enthält suggested_actions-Hinweise
get_host_sensors	Hardwaresensorstatus (Temperatur/Spannung/Lüfter) pro Host mit grün/gelb/rotem Zustand
get_host_services	Host-Dienststatus (Ausführungszustand und Startrichtlinie), optional nach Host gefiltert
vm_info	Detaillierte VM-Informationen (CPU, Speicher, Datenträger, NICs, Snapshots)
vm_list_snapshots	Snapshot-Liste für eine VM mit Verschachtelungshierarchie (schreibgeschützt)

Alle Tools sind schreibgeschützt. Kein Tool kann Ressourcen ändern, erstellen oder löschen.

CLI-Kurzreferenz

vmware-monitor inventory vms [--target <t>] [--limit 20] [--power-state poweredOn]
vmware-monitor inventory hosts [--target <t>]
vmware-monitor inventory datastores [--target <t>]
vmware-monitor inventory clusters [--target <t>]
vmware-monitor inventory networks [--target <t>]
vmware-monitor health alarms [--target <t>]
vmware-monitor health events [--hours 24] [--severity warning]
vmware-monitor health sensors [--target <t>]
vmware-monitor health services [--host <esxi>] [--target <t>]
vmware-monitor vm info <vm-name> [--target <t>]
vmware-monitor scan now [--target <t>]
vmware-monitor daemon start|stop|status
vmware-monitor doctor [--skip-auth]

Vollständige CLI-Referenz: siehe references/cli-reference.md

Fehlerbehebung

Alarme werden leer zurückgegeben, aber vCenter zeigt Alarme an

Das Tool get_alarms fragt ausgelöste Alarme auf der Stammordnerebene ab. Einige Alarme sind entitätsspezifisch – versuchen Sie stattdessen, Ereignisse zu prüfen: get_events --hours 1 --severity info.

Fehler „Connection refused“

1. Führen Sie vmware-monitor doctor zur Diagnose aus
2. Überprüfen Sie Ziel-Hostname/IP und Port (443) in der config.yaml
3. Für selbstsignierte Zertifikate: setzen Sie disableSslCertValidation: true

Ereignisse liefern zu viele Ergebnisse

Verwenden Sie den Schweregradfilter: --severity warning (Standard) filtert Info-Ereignisse heraus. Verwenden Sie --hours 4, um den Zeitraum einzugrenzen.

VM-Informationen zeigen „guest_os: unknown“

VMware Tools ist nicht installiert oder läuft nicht im Gast. Installieren/starten Sie VMware Tools für Gastbetriebssystemerkennung, IP-Adresse und Gastfamilieninformationen.

Doctor passt, aber Befehle schlagen mit Timeout fehl

vCenter könnte stark ausgelastet sein. Versuchen Sie, direkt einen bestimmten ESXi-Host statt vCenter als Ziel zu verwenden, oder erhöhen Sie das Verbindungs-Timeout in der config.yaml.

Einrichtung

uv tool install vmware-monitor
mkdir -p ~/.vmware-monitor
cp config.example.yaml ~/.vmware-monitor/config.yaml
cp .env.example ~/.vmware-monitor/.env
chmod 600 ~/.vmware-monitor/.env
# Bearbeiten Sie ~/.vmware-monitor/config.yaml (Ziele) und .env (Passwörter)

Alle Tools werden automatisch über vmware-policy auditiert. Audit-Logs: vmware-audit log --last 20

Vollständige Einrichtungsanleitung, Sicherheitsdetails und KI-Plattform-Kompatibilität: siehe references/setup-guide.md

Audit & Sicherheit

Alle Operationen werden automatisch über vmware-policy auditiert (@vmware_tool-Dekorator):

• Jeder Tool-Aufruf wird in ~/.vmware/audit.db protokolliert (SQLite, framework-unabhängig)
• Richtlinienregeln werden über ~/.vmware/rules.yaml durchgesetzt (Verweigerungsregeln, Wartungsfenster, Risikostufen)
• Risikoklassifizierung: Jedes Tool als niedrig/mittel/hoch/kritisch gekennzeichnet
• Letzte Operationen anzeigen: vmware-audit log --last 20
• Verweigerte Operationen anzeigen: vmware-audit log --status denied

vmware-policy wird automatisch als Abhängigkeit installiert – keine manuelle Einrichtung erforderlich.

Lizenz

MIT — github.com/zw008/VMware-Monitor