zw008/VMware-Aria

VMware Aria Operations

Aviso: Este é um projeto open-source mantido pela comunidade e não é afiliado, endossado ou patrocinado pela VMware, Inc. ou Broadcom Inc. "VMware" e "Aria" são marcas registradas da Broadcom. O código-fonte é publicamente auditável em github.com/zw008/VMware-Aria sob a licença MIT.

Monitoramento assistido por IA do VMware Aria Operations (vRealize Operations) — 27 ferramentas MCP para recursos, alertas, definições de alerta, planejamento de capacidade, detecção de anomalias, automação de relatórios e saúde da plataforma.

Skill de monitoramento focada em domínio para Aria Operations 8.x / vRealize Operations 8.x. Skills complementares: vmware-nsx (redes), vmware-aiops (ciclo de vida de VMs), vmware-monitor (vSphere somente leitura), vmware-avi (AVI/ALB/AKO), vmware-harden (baselines de conformidade). | vmware-pilot (orquestração de fluxos de trabalho) | vmware-policy (auditoria/política)

O Que Esta Skill Faz

Categoria	Ferramentas	Contagem
Recursos	listar, obter detalhes, métricas, selo de saúde, maiores consumidores	5
Alertas	listar, obter detalhes, reconhecer, cancelar, listar definições	5
Definições de Alerta	listar sintomas, criar definição, ativar/desativar, excluir	4
Capacidade	visão geral do cluster, capacidade restante, tempo restante, redimensionamento	4
Relatórios	listar modelos, gerar, listar, obter status+URL de download, excluir	5
Anomalias	listar anomalias, selo de risco	2
Saúde	saúde da plataforma Aria, status do grupo de coletores	2

Total: 27 ferramentas (20 somente leitura + 7 escrita)

Instalação Rápida

uv tool install vmware-aria
vmware-aria doctor

Quando Usar Esta Skill

Monitoramento de desempenho (verificações proativas diárias):

• Verificar contenção de VM: CPU Ready %, Balloon de Memória, uso de Swap
• Buscar métricas de série temporal para qualquer recurso (CPU, memória, disco, rede)
• Encontrar maiores consumidores por CPU/memória/disco/rede
• Verificar contagens de anomalias por recurso e pontuações do selo de risco

Gerenciamento de alertas:

• Listar, investigar, reconhecer ou cancelar alertas ativos
• Listar ou filtrar definições de alerta (modelos)
• Criar novas definições de alerta a partir de definições de sintoma (pós-RCA)
• Ativar ou desativar definições de alerta; excluir as obsoletas

Planejamento de capacidade:

• Capacidade restante do cluster (espaço livre de CPU, memória, disco)
• Previsão de tempo até o esgotamento por cluster
• Redimensionamento: encontrar VMs superprovisionadas ou subutilizadas
• Visão geral da capacidade com recomendações integradas do Aria

Automação de relatórios:

• Gerar relatórios agendados ou sob demanda (capacidade, desempenho, SLA)
• Verificar status do relatório até COMPLETED; obter URL de download PDF/CSV
• Excluir relatórios gerados após o download

Use skills complementares para:

• Ciclo de vida de VM: criar, clonar, snapshot, ligar/desligar → vmware-aiops
• Redes NSX: segmentos, gateways, NAT, roteamento → vmware-nsx
• Inventário vSphere, alarmes em tempo real, eventos → vmware-monitor
• Armazenamento: iSCSI, vSAN, datastores → vmware-storage
• Balanceamento de carga, AVI/ALB, AKO, Ingress → vmware-avi

Skills Relacionadas — Roteamento de Skills

Intenção do Usuário	Skill Recomendada
Monitoramento Aria Operations, alertas, capacidade	vmware-aria ← esta skill
Ciclo de vida de VM, implantação, operações convidadas	vmware-aiops
Redes NSX: segmentos, gateways, NAT, roteamento	vmware-nsx
Inventário vSphere somente leitura, eventos, alarmes	vmware-monitor
Armazenamento: iSCSI, vSAN, datastores	vmware-storage
Fluxos de trabalho de múltiplas etapas com aprovação	vmware-pilot
Baselines de conformidade (CIS/等保/PCI-DSS), detecção de desvios, consultor de remediação LLM	vmware-harden (uv tool install vmware-harden)
Balanceador de carga, AVI, ALB, AKO, Ingress	vmware-avi (uv tool install vmware-avi)
Consulta de logs de auditoria	vmware-policy (vmware-audit CLI)

Fluxos de Trabalho Comuns

Investigações diagnósticas: Antes de executar qualquer fluxo de trabalho do tipo "por que X está lento/ falhando/ inativo", siga o references/investigation-protocol.md. Ele impõe os quatro critérios de completude de causa raiz (falseabilidade/suficiência/necessidade/mecanismo) e o loop de aprofundamento de até três rodadas. Parar em uma conclusão parcial é um antipadrão — sempre verifique automaticamente os critérios antes de gerar um relatório.

Verificação Diária de Saúde de VM (Operações Proativas)

Julgamento: não persiga o maior consumidor de CPU — persiga o maior consumidor de contenção. Uma VM com 90% de CPU em um host silencioso está saudável; uma VM com 30% de CPU mas 15% de Ready está passando fome. Métricas-chave: CPU Ready, Balloon de Memória, Latência de Disco.

1. Encontrar maiores consumidores de CPU → vmware-aria resource top --metric cpu|usage_average --top 20 (este é o conjunto inicial, não a resposta)
2. Verificar CPU Ready em VMs quentes → vmware-aria resource metrics <vm-id> --metrics cpu.ready.summation --hours 24

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

3. Verificar pressão de memória → vmware-aria resource metrics <vm-id> --metrics mem.balloon.average,mem.swapped.average --hours 24
   • Balloon >0 = ESXi recuperando memória; Swap >0 = grave — agir imediatamente
4. Listar alertas CRÍTICOS/IMEDIATOS ativos → vmware-aria alert list --criticality CRITICAL
5. Verificar contagens de anomalias → vmware-aria anomaly list
6. Validar cruzadamente com o protocolo de investigação antes de relatar qualquer "causa raiz" — alto consumo raramente é a raiz, geralmente é um sintoma downstream

Investigar Alerta de Alta CPU

1. Listar alertas CRÍTICOS ativos → vmware-aria alert list --criticality CRITICAL
2. Obter detalhes do alerta + sintomas → vmware-aria alert get <alert-id>
3. Encontrar maiores consumidores de CPU → vmware-aria resource top --metric cpu|usage_average
4. Buscar métricas de CPU de 24h para a VM quente → vmware-aria resource metrics <vm-id> --metrics cpu|usage_average --hours 24
5. Verificar selo de risco → vmware-aria anomaly risk <vm-id>
6. Reconhecer o alerta → vmware-aria alert acknowledge <alert-id>

Planejamento de Capacidade

1. Listar clusters → vmware-aria resource list --kind ClusterComputeResource
2. Obter capacidade restante → vmware-aria capacity remaining <cluster-id>
3. Prever tempo até o esgotamento → vmware-aria capacity time-remaining <cluster-id>
4. Obter visão geral da capacidade com recomendações → vmware-aria capacity overview <cluster-id>
5. Encontrar candidatos a redimensionamento → vmware-aria capacity rightsizing

Pós-Incidente: Criar Alerta de Detecção (Acompanhamento de RCA)

Após resolver um incidente, crie um alerta de aviso prévio para evitar recorrência. O gerenciamento de definições de alerta é exclusivo do MCP (sem subcomandos CLI):

1. Encontrar definições de sintoma correspondentes → MCP list_symptom_definitions (filtrar por name_filter/resource_kind)
2. Criar definição de alerta referenciando sintomas → MCP create_alert_definition com nome, resource_kind, symptom_definition_ids, criticality (qualquer sintoma disparado aciona o alerta)
3. Verificar se aparece nas definições → vmware-aria alert definitions --name "Gold VM CPU" (criticality mostrada é a severidade máxima entre os estados da definição)
4. Ativar ou desativar depois → MCP set_alert_definition_state

Gerar Relatório de Capacidade

1. Encontrar modelo de relatório → vmware-aria report definitions --name "Capacity"
2. Acionar geração do relatório → vmware-aria report generate <definition-id> --resources <resource-id> (a API de relatório requer pelo menos um UUID de recurso)
3. Verificar até concluído → vmware-aria report get <report-id> (repetir até status == COMPLETED)
4. Baixar via download_url retornado (PDF) ou csv_url
5. Limpar → vmware-aria report delete <report-id>

Operações em Múltiplos Destinos

Todos os comandos aceitam --target <nome> para operar contra uma instância específica do Aria Ops:

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

Modo de Uso

Cenário	Recomendado	Porquê
Modelos locais/pequenos (Ollama, Qwen)	CLI	~2K tokens vs ~8K para MCP
Modelos em nuvem (Claude, GPT-4o)	Qualquer um	MCP fornece E/S JSON estruturada
Pipelines automatizados	MCP	Parâmetros type-safe, saída estruturada

Ferramentas MCP (27 — 20 leitura, 7 escrita)

Todas as ferramentas MCP aceitam um parâmetro opcional target para selecionar qual instância do Aria Operations conectar.

Categoria	Ferramenta	Tipo	Descrição
Recurso	list_resources	Leitura	Listar VMs, hosts, clusters por tipo de recurso
	get_resource	Leitura	Obter detalhes do recurso com selos de saúde, risco, eficiência
	get_resource_metrics	Leitura	Buscar estatísticas de métricas de série temporal para qualquer recurso
	get_resource_health	Leitura	Obter pontuação do selo de saúde (0–100)
	get_top_consumers	Leitura	Classificar recursos por uso de CPU, memória, disco ou rede
Alertas	list_alerts	Leitura	Listar alertas ativos com criticality e ID do recurso (resolver nomes via get_resource)
	get_alert	Leitura	Obter detalhes do alerta com sintomas contribuintes (recomendações vivem na definição do alerta)
	acknowledge_alert	Escrita	Marcar um alerta como reconhecido (não o fecha)
	cancel_alert	Escrita	Cancelar (descartar) um alerta ativo
	list_alert_definitions	Leitura	Listar modelos de alerta configurados no Aria Ops
Defs Alerta	list_symptom_definitions	Leitura	Listar definições de sintoma — use os IDs ao criar definições de alerta
	create_alert_definition	Escrita	Criar nova definição de alerta a partir de IDs de definição de sintoma
	set_alert_definition_state	Escrita	Ativar ou desativar uma definição de alerta
	delete_alert_definition	Escrita	Excluir permanentemente uma definição de alerta
Capacidade	get_capacity_overview	Leitura	% restante no grupo + espaço livre por dimensão e dias até o esgotamento
	get_remaining_capacity	Leitura	CPU, memória, disco restantes antes de atingir limites
	get_time_remaining	Leitura	Dias até a capacidade do cluster ser esgotada
	list_rightsizing_recommendations	Leitura	VMs para redimensionar: super/sub provisionadas
Relatórios	list_report_definitions	Leitura	Listar modelos de definição de relatório disponíveis
	generate_report	Escrita	Acionar geração de relatório (assíncrono; retorna report_id)
	list_reports	Leitura	Listar relatórios gerados, opcionalmente por definição
	get_report	Leitura	Verificar status do relatório + URLs de download PDF/CSV
	delete_report	Escrita	Excluir um relatório gerado
Anomalia	list_anomalies	Leitura	Contagens de anomalias por recurso (System Attributes|total_alarms metric)
	get_resource_riskbadge	Leitura	Pontuação de risco (0–100): probabilidade de problemas futuros
Saúde	get_aria_health	Leitura	Status do nó da plataforma Aria (ONLINE/OFFLINE)
	list_collector_groups	Leitura	Status dos agentes coletores e conectividade

Divisão leitura/escrita: 20 somente leitura, 7 escrita. Todas as operações de escrita são registradas em log de auditoria em ~/.vmware/audit.db (via vmware-policy).

Referência Rápida da 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>]

# Definições de Alerta: criação/ativação/desativação/exclusão e consulta de
# definições de sintoma são ferramentas exclusivas do MCP (list_symptom_definitions, create_alert_definition,
# set_alert_definition_state, delete_alert_definition) — sem subcomandos CLI.

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

# Relatórios (assíncrono: gerar → verificar get → baixar → excluir)
vmware-aria report definitions [--name <filter>]
vmware-aria report generate <definition-id> --resources <id1,id2>   # pelo menos um UUID de recurso obrigatório
vmware-aria report list [--definition-id <id>]
vmware-aria report get <report-id>        # verificar até status == COMPLETED; mostra download_url
vmware-aria report delete <report-id>

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

# Saúde
vmware-aria health status
vmware-aria health collectors

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

Nomes de Métricas-Chave (para o comando resource metrics)

Métrica	Chave da API	O Que Significa
CPU Ready %	cpu.ready.summation	vCPU esperando por núcleo físico; >5% = aviso
CPU Usada	cpu.used.summation	Tempo real de execução da CPU
Demanda de CPU	cpu.demand.average	Total de MHz solicitado pela VM
Memória Ativa	mem.active.average	Usada ativamente pelo SO convidado (dimensionamento)
Memória Consumida	mem.consumed.average	Pegada no host (capacidade)
Balloon de Memória	mem.balloon.average	>0 = ESXi recuperando memória
Swap de Memória	mem.swapped.average	>0 = pressão severa
Latência de Leitura de Disco	disk.read.average	Latência de E/S de leitura em ms
Latência de Escrita de Disco	disk.write.average	Latência de E/S de escrita em ms
Rede Recebida	net.received.average	KB/s de rede de entrada
Rede Transmitida	net.transmitted.average	KB/s de rede de saída

Referência completa da CLI com todas as opções e formatos de saída: veja references/cli-reference.md

Solução de Problemas

Erro "Token não encontrado" após configuração

...

[truncado para tradução]