zw008/VMware-Aria

VMware Aria Operations

Avertissement : Ceci est un projet open-source maintenu par la communauté et n'est pas affilié, approuvé ou sponsorisé par VMware, Inc. ou Broadcom Inc. « VMware » et « Aria » sont des marques de Broadcom. Le code source est publiquement vérifiable sur github.com/zw008/VMware-Aria sous licence MIT.

Supervision assistée par IA pour VMware Aria Operations (vRealize Operations) — 27 outils MCP pour les ressources, alertes, définitions d'alertes, planification de capacité, détection d'anomalies, automatisation des rapports et santé de la plateforme.

Compétence de supervision orientée domaine pour Aria Operations 8.x / vRealize Operations 8.x. Compétences complémentaires : vmware-nsx (réseau), vmware-aiops (cycle de vie des VM), vmware-monitor (vSphere en lecture seule), vmware-avi (AVI/ALB/AKO), vmware-harden (bases de conformité). | vmware-pilot (orchestration de workflows) | vmware-policy (audit/politique)

Ce que fait cette compétence

Catégorie	Outils	Nombre
Ressources	lister, obtenir les détails, métriques, badge de santé, plus gros consommateurs	5
Alertes	lister, obtenir détails, accuser réception, annuler, lister les définitions	5
Définitions d'alertes	lister les symptômes, créer une définition, activer/désactiver, supprimer	4
Capacité	aperçu du cluster, capacité restante, temps restant, droitsizing	4
Rapports	lister les modèles, générer, lister, obtenir statut+URL de téléchargement, supprimer	5
Anomalie	lister les anomalies, badge de risque	2
Santé	santé plateforme Aria, statut des groupes de collecteurs	2

Total : 27 outils (20 en lecture seule + 7 en écriture)

Installation rapide

uv tool install vmware-aria
vmware-aria doctor

Quand utiliser cette compétence

Supervision des performances (vérifications proactives quotidiennes) :

• Vérifier la contention des VM : CPU Ready %, Balloon Mémoire, utilisation Swap
• Récupérer des métriques temporelles pour n'importe quelle ressource (CPU, mémoire, disque, réseau)
• Trouver les plus gros consommateurs par CPU/mémoire/disque/réseau
• Vérifier le nombre d'anomalies par ressource et les scores des badges de risque

Gestion des alertes :

• Lister, investiguer, accuser réception ou annuler les alertes actives
• Lister ou filtrer les définitions d'alertes (modèles)
• Créer de nouvelles définitions d'alertes à partir de définitions de symptômes (post-RCA)
• Activer ou désactiver les définitions d'alertes ; supprimer celles obsolètes

Planification de capacité :

• Capacité restante du cluster (CPU, mémoire, marge disque)
• Prédiction du temps jusqu'à saturation par cluster
• Droitsizing : trouver les VM sur-provisionnées ou sous-utilisées
• Aperçu de la capacité avec les recommandations intégrées d'Aria

Automatisation des rapports :

• Générer des rapports planifiés ou à la demande (capacité, performance, SLA)
• Vérifier l'état du rapport jusqu'à COMPLETED ; obtenir l'URL de téléchargement PDF/CSV
• Supprimer les rapports générés après téléchargement

Utilisez les compétences complémentaires pour :

• Cycle de vie des VM : créer, cloner, snapshot, alimentation → vmware-aiops
• Réseau NSX : segments, passerelles, NAT, routage → vmware-nsx
• Inventaire vSphere, alarmes en temps réel, événements → vmware-monitor
• Stockage : iSCSI, vSAN, datastores → vmware-storage
• Équilibrage de charge, AVI/ALB, AKO, Ingress → vmware-avi

Compétences connexes — Routage des compétences

Intention de l'utilisateur	Compétence recommandée
Supervision Aria Operations, alertes, capacité	vmware-aria ← cette compétence
Cycle de vie des VM, déploiement, opérations invitées	vmware-aiops
Réseau NSX : segments, passerelles, NAT, routage	vmware-nsx
Inventaire vSphere en lecture seule, événements, alarmes	vmware-monitor
Stockage : iSCSI, vSAN, datastores	vmware-storage
Workflows multi-étapes avec approbation	vmware-pilot
Bases de conformité (CIS / 等保 / PCI-DSS), détection de dérive, conseiller de correction LLM	vmware-harden (uv tool install vmware-harden)
Équilibreur de charge, AVI, ALB, AKO, Ingress	vmware-avi (uv tool install vmware-avi)
Interrogation des journaux d'audit	vmware-policy (CLI vmware-audit)

Workflows courants

Investigations diagnostiques : Avant d'exécuter tout workflow du type « pourquoi X est lent / échoue / est hors service », suivez references/investigation-protocol.md. Il impose les quatre critères d'exhaustivité de la cause racine (falsifiabilité / suffisance / nécessité / mécanisme) et la boucle d'approfondissement allant jusqu'à trois tours. S'arrêter à une conclusion partielle est un anti-modèle — vérifiez toujours les critères avant de produire un rapport.

Vérification quotidienne de la santé des VM (Ops proactif)

Jugement : ne cherchez pas le plus gros consommateur de CPU — cherchez le plus gros consommateur de contention. Une VM à 90% de CPU sur un hôte calme est saine ; une VM à 30% de CPU mais 15% de Ready est affamée. Métriques clés : CPU Ready, Balloon Mémoire, Latence Disque.

1. Trouver les plus gros consommateurs de CPU → vmware-aria resource top --metric cpu|usage_average --top 20 (c'est l'ensemble de départ, pas la réponse)
2. Vérifier le CPU Ready sur les VM chaudes → vmware-aria resource metrics <vm-id> --metrics cpu.ready.summation --hours 24

   • 5% = avertissement, >10% = problème, >20% = critique

3. Vérifier la pression mémoire → vmware-aria resource metrics <vm-id> --metrics mem.balloon.average,mem.swapped.average --hours 24
   • Balloon >0 = ESXi récupère de la mémoire ; Swap >0 = sévère — agissez immédiatement
4. Lister les alertes CRITIQUES/IMMÉDIATES actives → vmware-aria alert list --criticality CRITICAL
5. Vérifier les compteurs d'anomalies → vmware-aria anomaly list
6. Recouper avec le protocole d'investigation avant de signaler une « cause racine » — une consommation élevée est rarement la racine, généralement un symptôme en aval

Investiguer une alerte de CPU élevé

1. Lister les alertes CRITIQUES actives → vmware-aria alert list --criticality CRITICAL
2. Obtenir les détails de l'alerte + symptômes → vmware-aria alert get <alert-id>
3. Trouver les plus gros consommateurs de CPU → vmware-aria resource top --metric cpu|usage_average
4. Récupérer les métriques CPU sur 24h pour la VM chaude → vmware-aria resource metrics <vm-id> --metrics cpu|usage_average --hours 24
5. Vérifier le badge de risque → vmware-aria anomaly risk <vm-id>
6. Accuser réception de l'alerte → vmware-aria alert acknowledge <alert-id>

Planification de capacité

1. Lister les clusters → vmware-aria resource list --kind ClusterComputeResource
2. Obtenir la capacité restante → vmware-aria capacity remaining <cluster-id>
3. Prédire le temps jusqu'à saturation → vmware-aria capacity time-remaining <cluster-id>
4. Obtenir l'aperçu de capacité avec recommandations → vmware-aria capacity overview <cluster-id>
5. Trouver les candidats au droitsizing → vmware-aria capacity rightsizing

Post-incident : Créer une alerte de détection (Suivi RCA)

Après avoir résolu un incident, créez une alerte d'avertissement précoce pour éviter la récurrence. La gestion des définitions d'alertes est MCP uniquement (pas de sous-commandes CLI) :

1. Trouver les définitions de symptômes correspondantes → MCP list_symptom_definitions (filtrer par name_filter / resource_kind)
2. Créer une définition d'alerte référençant les symptômes → MCP create_alert_definition avec nom, resource_kind, symptom_definition_ids, criticalité (un seul symptôme déclenche l'alerte)
3. Vérifier son apparition dans les définitions → vmware-aria alert definitions --name "Gold VM CPU" (la criticalité affichée est la sévérité maximale entre les états de la définition)
4. Activer ou désactiver plus tard → MCP set_alert_definition_state

Générer un rapport de capacité

1. Trouver un modèle de rapport → vmware-aria report definitions --name "Capacity"
2. Déclencher la génération du rapport → vmware-aria report generate <definition-id> --resources <resource-id> (l'API Report nécessite au moins un UUID de ressource)
3. Vérifier jusqu'à terme → vmware-aria report get <report-id> (répéter jusqu'à status == COMPLETED)
4. Télécharger via l'download_url retourné (PDF) ou csv_url
5. Nettoyer → vmware-aria report delete <report-id>

Opérations multi-cibles

Toutes les commandes acceptent --target <name> pour opérer sur une instance Aria Ops spécifique :

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

Mode d'utilisation

Scénario	Recommandé	Pourquoi
Modèles locaux/petits (Ollama, Qwen)	CLI	~2K tokens contre ~8K pour MCP
Modèles cloud (Claude, GPT-4o)	L'un ou l'autre	MCP donne une I/O JSON structurée
Pipelines automatisés	MCP	Paramètres typés, sortie structurée

Outils MCP (27 — 20 lecture, 7 écriture)

Tous les outils MCP acceptent un paramètre optionnel target pour sélectionner l'instance Aria Operations à laquelle se connecter.

Catégorie	Outil	Type	Description
Ressource	list_resources	Lecture	Lister VM, hôtes, clusters par type de ressource
	get_resource	Lecture	Obtenir les détails de la ressource avec badges santé, risque, efficacité
	get_resource_metrics	Lecture	Récupérer les stats de métriques temporelles pour n'importe quelle ressource
	get_resource_health	Lecture	Obtenir le score du badge santé (0–100)
	get_top_consumers	Lecture	Classer les ressources par utilisation CPU, mémoire, disque ou réseau
Alertes	list_alerts	Lecture	Lister les alertes actives avec criticalité et ID ressource (résoudre les noms via get_resource)
	get_alert	Lecture	Obtenir les détails de l'alerte avec symptômes contributeurs (les recommandations sont sur la définition d'alerte)
	acknowledge_alert	Écriture	Marquer une alerte comme acquittée (ne la ferme pas)
	cancel_alert	Écriture	Annuler (rejeter) une alerte active
	list_alert_definitions	Lecture	Lister les modèles d'alertes configurés dans Aria Ops
Dét. alertes	list_symptom_definitions	Lecture	Lister les définitions de symptômes — utiliser les IDs lors de la création de définitions d'alertes
	create_alert_definition	Écriture	Créer une nouvelle définition d'alerte à partir d'IDs de définitions de symptômes
	set_alert_definition_state	Écriture	Activer ou désactiver une définition d'alerte
	delete_alert_definition	Écriture	Supprimer définitivement une définition d'alerte
Capacité	get_capacity_overview	Lecture	% restant au niveau groupe + marge par dimension et jours avant saturation
	get_remaining_capacity	Lecture	CPU, mémoire, disque restant avant d'atteindre les limites
	get_time_remaining	Lecture	Jours avant épuisement de la capacité du cluster
	list_rightsizing_recommendations	Lecture	VM à redimensionner : sur/sous-provisionnées
Rapports	list_report_definitions	Lecture	Lister les modèles de définitions de rapports disponibles
	generate_report	Écriture	Déclencher la génération d'un rapport (asynchrone ; retourne report_id)
	list_reports	Lecture	Lister les rapports générés, optionnellement par définition
	get_report	Lecture	Vérifier l'état du rapport + obtenir les URL de téléchargement PDF/CSV
	delete_report	Écriture	Supprimer un rapport généré
Anomalie	list_anomalies	Lecture	Compteurs d'anomalies par ressource (métrique System Attributes
	get_resource_riskbadge	Lecture	Score de risque (0–100) : probabilité de problèmes futurs
Santé	get_aria_health	Lecture	Statut des nœuds de la plateforme Aria (ONLINE/OFFLINE)
	list_collector_groups	Lecture	Statut et connectivité des agents collecteurs

Répartition lecture/écriture : 20 en lecture seule, 7 en écriture. Toutes les opérations d'écriture sont enregistrées dans ~/.vmware/audit.db (via vmware-policy).

Référence rapide CLI

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

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

# Définitions d'alertes : création/activation/désactivation/suppression et recherche
# de définitions de symptômes sont des outils MCP uniquement (list_symptom_definitions,
# create_alert_definition, set_alert_definition_state, delete_alert_definition) —
# pas de sous-commandes CLI.

# Capacité
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>]

# Rapports (asynchrone : générer → vérifier → télécharger → supprimer)
vmware-aria report definitions [--name <filter>]
vmware-aria report generate <definition-id> --resources <id1,id2>   # au moins un UUID de ressource requis
vmware-aria report list [--definition-id <id>]
vmware-aria report get <report-id>        # vérifier jusqu'à status == COMPLETED ; montre download_url
vmware-aria report delete <report-id>

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

# Santé
vmware-aria health status
vmware-aria health collectors

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

Noms de métriques clés (pour la commande resource metrics)

Métrique	Clé API	Signification
CPU Ready %	cpu.ready.summation	vCPU en attente de cœur physique ; >5% = avertissement
CPU Utilisé	cpu.used.summation	Temps d'exécution CPU réel
CPU Demand	cpu.demand.average	Total MHz demandé par la VM
Mémoire Active	mem.active.average	Utilisée activement par l'OS invité (dimensionnement)
Mémoire Consommée	mem.consumed.average	Empreinte sur l'hôte (capacité)
Balloon Mémoire	mem.balloon.average	>0 = ESXi récupère de la mémoire
Swap Mémoire	mem.swapped.average	>0 = pression sévère
Latence Lecture Disque	disk.read.average	Latence I/O lecture en ms
Latence Écriture Disque	disk.write.average	Latence I/O écriture en ms
Reçu Réseau	net.received.average	Bande passante réseau entrante en Ko/s
Transmis Réseau	net.transmitted.average	Bande passante réseau sortante en Ko/s

Référence CLI complète avec toutes les options et formats de sortie : voir references/cli-reference.md

Dépannage

Erreur "Token not found" après configuration

...