zw008/VMware-Aria

VMware Aria Operations

Aviso legal: Este es un proyecto de código abierto mantenido por la comunidad y no está afiliado, respaldado ni patrocinado por VMware, Inc. o Broadcom Inc. "VMware" y "Aria" son marcas comerciales de Broadcom. El código fuente es auditado públicamente en github.com/zw008/VMware-Aria bajo la licencia MIT.

Monitoreo asistido por IA para VMware Aria Operations (vRealize Operations) — 27 herramientas MCP para recursos, alertas, definiciones de alertas, planificación de capacidad, detección de anomalías, automatización de informes y estado de la plataforma.

Habilidad de monitoreo enfocada en el dominio para Aria Operations 8.x / vRealize Operations 8.x. Habilidades complementarias: vmware-nsx (redes), vmware-aiops (ciclo de vida de VM), vmware-monitor (vSphere de solo lectura), vmware-avi (AVI/ALB/AKO), vmware-harden (líneas base de cumplimiento). | vmware-pilot (orquestación de flujos de trabajo) | vmware-policy (auditoría/política)

Qué Hace Esta Habilidad

Categoría	Herramientas	Total
Recursos	listar, obtener detalles, métricas, insignia de estado, principales consumidores	5
Alertas	listar, obtener detalles, confirmar, cancelar, listar definiciones	5
Definiciones de Alertas	listar síntomas, crear definición, habilitar/deshabilitar, eliminar	4
Capacidad	resumen de clúster, capacidad restante, tiempo restante, ajuste de tamaño	4
Informes	listar plantillas, generar, listar, obtener estado+URL de descarga, eliminar	5
Anomalías	listar anomalías, insignia de riesgo	2
Estado	estado de la plataforma Aria, estado del grupo de recolectores	2

Total: 27 herramientas (20 de solo lectura + 7 de escritura)

Instalación Rápida

uv tool install vmware-aria
vmware-aria doctor

Cuándo Usar Esta Habilidad

Monitoreo de rendimiento (verificaciones proactivas diarias):

• Verificar contención de VM: % de CPU Ready, Memory Balloon, uso de Swap
• Obtener métricas de series temporales para cualquier recurso (CPU, memoria, disco, red)
• Encontrar principales consumidores por CPU/memoria/disco/red
• Verificar recuentos de anomalías y puntuaciones de insignia de riesgo por recurso

Gestión de alertas:

• Listar, investigar, confirmar o cancelar alertas activas
• Listar o filtrar definiciones de alertas (plantillas)
• Crear nuevas definiciones de alertas a partir de definiciones de síntomas (post-RCA)
• Habilitar o deshabilitar definiciones de alertas; eliminar las obsoletas

Planificación de capacidad:

• Capacidad restante del clúster (margen de CPU, memoria, disco)
• Predicción de tiempo hasta llenarse por clúster
• Ajuste de tamaño: encontrar VMs sobreaprovisionadas o infrautilizadas
• Resumen de capacidad con recomendaciones integradas de Aria

Automatización de informes:

• Generar informes programados o bajo demanda (capacidad, rendimiento, SLA)
• Consultar el estado del informe hasta que esté COMPLETADO; obtener URL de descarga PDF/CSV
• Eliminar informes generados después de la descarga

Use habilidades complementarias para:

• Ciclo de vida de VM: crear, clonar, instantánea, encendido → vmware-aiops
• Redes NSX: segmentos, pasarelas, NAT, enrutamiento → vmware-nsx
• Inventario vSphere, alarmas en tiempo real, eventos → vmware-monitor
• Almacenamiento: iSCSI, vSAN, datastores → vmware-storage
• Balanceo de carga, AVI/ALB, AKO, Ingress → vmware-avi

Habilidades Relacionadas — Enrutamiento de Habilidades

Intención del Usuario	Habilidad Recomendada
Monitoreo de Aria Operations, alertas, capacidad	vmware-aria ← esta habilidad
Ciclo de vida de VM, implementación, operaciones de invitado	vmware-aiops
Redes NSX: segmentos, pasarelas, NAT, enrutamiento	vmware-nsx
Inventario vSphere de solo lectura, eventos, alarmas	vmware-monitor
Almacenamiento: iSCSI, vSAN, datastores	vmware-storage
Flujos de trabajo de múltiples pasos con aprobación	vmware-pilot
Líneas base de cumplimiento (CIS / 等保 / PCI-DSS), detección de deriva, asesor de corrección LLM	vmware-harden (uv tool install vmware-harden)
Balanceador de carga, AVI, ALB, AKO, Ingress	vmware-avi (uv tool install vmware-avi)
Consulta de registros de auditoría	vmware-policy (CLI vmware-audit)

Flujos de Trabajo Comunes

Investigaciones de diagnóstico: Antes de ejecutar cualquier flujo de trabajo "por qué X es lento / falla / está caído", siga references/investigation-protocol.md. Aplica los cuatro criterios de completitud de causa raíz (falsabilidad / suficiencia / necesidad / mecanismo) y el bucle de profundización de hasta tres rondas. Detenerse en una conclusión parcial es un antipatrón: siempre verifique usted mismo con los criterios antes de generar un informe.

Verificación Diaria de Salud de VM (Operaciones Proactivas)

Criterio: no persiga al mayor consumidor de CPU — persiga al mayor consumidor de contención. Una VM al 90% de CPU en un host tranquilo es saludable; una VM al 30% de CPU pero con 15% de Ready se está muriendo de hambre. Métricas clave: CPU Ready, Memory Balloon, Latencia de Disco.

1. Encontrar principales consumidores de CPU → vmware-aria resource top --metric cpu|usage_average --top 20 (este es el conjunto inicial, no la respuesta)
2. Verificar CPU Ready en VMs calientes → vmware-aria resource metrics <vm-id> --metrics cpu.ready.summation --hours 24

   • 5% = advertencia, >10% = problema, >20% = crítico

3. Verificar presión de memoria → vmware-aria resource metrics <vm-id> --metrics mem.balloon.average,mem.swapped.average --hours 24
   • Balloon >0 = ESXi está recuperando memoria; Swap >0 = severo — actúe inmediatamente
4. Listar alertas CRÍTICAS/INMEDIATAS activas → vmware-aria alert list --criticality CRITICAL
5. Verificar recuentos de anomalías → vmware-aria anomaly list
6. Realizar validación cruzada con el protocolo de investigación antes de informar cualquier "causa raíz" — el alto consumo rara vez es la raíz, generalmente es un síntoma posterior

Investigar Alerta de Alta CPU

1. Listar alertas CRÍTICAS activas → vmware-aria alert list --criticality CRITICAL
2. Obtener detalles de la alerta + síntomas → vmware-aria alert get <alert-id>
3. Encontrar principales consumidores de CPU → vmware-aria resource top --metric cpu|usage_average
4. Obtener métricas de CPU de 24h para la VM caliente → vmware-aria resource metrics <vm-id> --metrics cpu|usage_average --hours 24
5. Verificar insignia de riesgo → vmware-aria anomaly risk <vm-id>
6. Confirmar la alerta → vmware-aria alert acknowledge <alert-id>

Planificación de Capacidad

1. Listar clústeres → vmware-aria resource list --kind ClusterComputeResource
2. Obtener capacidad restante → vmware-aria capacity remaining <cluster-id>
3. Predecir tiempo hasta llenarse → vmware-aria capacity time-remaining <cluster-id>
4. Obtener resumen de capacidad con recomendaciones → vmware-aria capacity overview <cluster-id>
5. Encontrar candidatos para ajuste de tamaño → vmware-aria capacity rightsizing

Post-Incidente: Crear Alerta de Detección (Seguimiento de RCA)

Después de resolver un incidente, cree una alerta de advertencia temprana para prevenir la recurrencia. La gestión de definiciones de alertas es solo MCP (sin subcomandos CLI):

1. Encontrar definiciones de síntomas coincidentes → MCP list_symptom_definitions (filtrar por name_filter / resource_kind)
2. Crear definición de alerta haciendo referencia a los síntomas → MCP create_alert_definition con nombre, resource_kind, symptom_definition_ids, criticality (cualquier síntoma que se active dispara la alerta)
3. Verificar que aparece en las definiciones → vmware-aria alert definitions --name "Gold VM CPU" (la criticalidad mostrada es la severidad máxima en los estados de la definición)
4. Habilitar o deshabilitar después → MCP set_alert_definition_state

Generar Informe de Capacidad

1. Encontrar plantilla de informe → vmware-aria report definitions --name "Capacity"
2. Desencadenar la generación del informe → vmware-aria report generate <definition-id> --resources <resource-id> (la API de Informes requiere al menos un UUID de recurso)
3. Consultar hasta que se complete → vmware-aria report get <report-id> (repetir hasta que status == COMPLETED)
4. Descargar a través de la download_url devuelta (PDF) o csv_url
5. Limpiar → vmware-aria report delete <report-id>

Operaciones Multi-Objetivo

Todos los comandos aceptan --target <name> para operar contra una instancia específica de Aria Ops:

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

Modo de Uso

Escenario	Recomendado	Por Qué
Modelos locales/pequeños (Ollama, Qwen)	CLI	~2K tokens vs ~8K para MCP
Modelos en la nube (Claude, GPT-4o)	Cualquiera	MCP proporciona E/S JSON estructurada
Pipelines automatizados	MCP	Parámetros con seguridad de tipos, salida estructurada

Herramientas MCP (27 — 20 lectura, 7 escritura)

Todas las herramientas MCP aceptan un parámetro target opcional para seleccionar qué instancia de Aria Operations conectar.

Categoría	Herramienta	Tipo	Descripción
Recurso	list_resources	Lectura	Listar VMs, hosts, clústeres por tipo de recurso
	get_resource	Lectura	Obtener detalles del recurso con insignias de estado, riesgo, eficiencia
	get_resource_metrics	Lectura	Obtener estadísticas de métricas de series temporales para cualquier recurso
	get_resource_health	Lectura	Obtener puntuación de la insignia de estado (0–100)
	get_top_consumers	Lectura	Clasificar recursos por uso de CPU, memoria, disco o red
Alertas	list_alerts	Lectura	Listar alertas activas con criticalidad e ID de recurso (resolver nombres con get_resource)
	get_alert	Lectura	Obtener detalles de la alerta con síntomas contribuyentes (las recomendaciones viven en la definición de alerta)
	acknowledge_alert	Escritura	Marcar una alerta como confirmada (no la cierra)
	cancel_alert	Escritura	Cancelar (descartar) una alerta activa
	list_alert_definitions	Lectura	Listar plantillas de alertas configuradas en Aria Ops
Def. Alertas	list_symptom_definitions	Lectura	Listar definiciones de síntomas — use IDs al crear definiciones de alertas
	create_alert_definition	Escritura	Crear nueva definición de alerta a partir de IDs de definición de síntomas
	set_alert_definition_state	Escritura	Habilitar o deshabilitar una definición de alerta
	delete_alert_definition	Escritura	Eliminar una definición de alerta permanentemente
Capacidad	get_capacity_overview	Lectura	% restante a nivel de grupo + margen por dimensión y días hasta llenarse
	get_remaining_capacity	Lectura	CPU, memoria, disco restantes antes de alcanzar los límites
	get_time_remaining	Lectura	Días hasta que la capacidad del clúster se agote
	list_rightsizing_recommendations	Lectura	VMs a redimensionar: sobre/infra aprovisionadas
Informes	list_report_definitions	Lectura	Listar plantillas de definiciones de informes disponibles
	generate_report	Escritura	Desencadenar la generación de informe (asíncrono; devuelve report_id)
	list_reports	Lectura	Listar informes generados, opcionalmente por definición
	get_report	Lectura	Consultar estado del informe + obtener URLs de descarga PDF/CSV
	delete_report	Escritura	Eliminar un informe generado
Anomalía	list_anomalies	Lectura	Recuentos de anomalías por recurso (métrica System Attributes
	get_resource_riskbadge	Lectura	Puntuación de riesgo (0–100): probabilidad de problemas futuros
Estado	get_aria_health	Lectura	Estado del nodo de la plataforma Aria (ONLINE/OFFLINE)
	list_collector_groups	Lectura	Estado de los agentes recolectores y conectividad

División lectura/escritura: 20 de solo lectura, 7 de escritura. Todas las operaciones de escritura se registran en el registro de auditoría ~/.vmware/audit.db (a través de vmware-policy).

Referencia Rápida de CLI

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

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

# Definiciones de Alertas: la creación/habilitación/deshabilitación/eliminación y la
# búsqueda de definiciones de síntomas son herramientas solo MCP (list_symptom_definitions, create_alert_definition,
# set_alert_definition_state, delete_alert_definition) — no hay subcomandos CLI.

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

# Informes (asíncrono: generar → consultar obtener → descargar → eliminar)
vmware-aria report definitions [--name <filter>]
vmware-aria report generate <definition-id> --resources <id1,id2>   # se requiere al menos un UUID de recurso
vmware-aria report list [--definition-id <id>]
vmware-aria report get <report-id>        # consultar hasta que status == COMPLETED; muestra download_url
vmware-aria report delete <report-id>

# Anomalía
vmware-aria anomaly list [--resource-id <id>]
vmware-aria anomaly risk <resource-id>

# Estado
vmware-aria health status
vmware-aria health collectors

# Diagnóstico
vmware-aria doctor [--skip-auth]

Nombres de Métricas Clave (para el comando resource metrics)

Métrica	Clave de API	Qué Significa
CPU Ready %	cpu.ready.summation	vCPU esperando por núcleo físico; >5% = advertencia
CPU Usada	cpu.used.summation	Tiempo real de ejecución de CPU
Demanda de CPU	cpu.demand.average	Total de MHz solicitados por la VM
Memoria Activa	mem.active.average	Utilizada activamente por el SO invitado (dimensionamiento)
Memoria Consumida	mem.consumed.average	Huella en el host (capacidad)
Memory Balloon	mem.balloon.average	>0 = ESXi está recuperando memoria
Memory Swap	mem.swapped.average	>0 = presión severa
Latencia de Lectura de Disco	disk.read.average	Latencia de E/S de lectura en ms
Latencia de Escritura de Disco	disk.write.average	Latencia de E/S de escritura en ms
Red Recibida	net.received.average	Tráfico de red entrante en KB/s
Red Transmitida	net.transmitted.average	Tráfico de red saliente en KB/s

Referencia CLI completa con todas las opciones y formatos de salida: consulte references/cli-reference.md

Solución de Problemas

Error "Token no encontrado" después de configurar

…

[truncado para traducción]