Documentação InfraWatts
Compreenda os dados, as recomendações e os limites antes de decidir o que reduzir, preparar ou manter.
Funcionamento do produto
O InfraWatts reúne métricas da infraestrutura para detetar desperdício e priorizar recomendações. A sonda identifica primeiro o anfitrião Linux ou Windows e depois deteta Docker e Kubernetes de forma independente. Um anfitrião Linux continua a ser Linux quando estes ambientes estão presentes.
O painel, o assistente, os alertas, as recomendações e as exportações leem o mesmo estado do servidor. As recomendações dependem das métricas observadas e do contexto; o inventário, por si só, não comprova poupanças. A sonda selecionada continua a ser o âmbito predefinido.
Âmbito do assistente
O assistente utiliza a sonda selecionada por predefinição. Uma pergunta global pode alargar a análise a várias sondas; mencionar outra sonda pode alterar o âmbito se esta pertencer à sua conta.
/infra, /alerts e /agent <name> permitem precisar o pedido. O contexto visível pode incluir a sonda, os ambientes e o estado do Kubernetes. Uma recomendação de ação não comprova a sua execução.
Deteção dos ambientes
A plataforma do anfitrião é identificada antes dos ambientes. Deteção e disponibilidade são distintas: Docker ou Kubernetes podem ser detetados e estar indisponíveis.
k8s_not_configured indica ausência de contexto Kubernetes utilizável; k8s_unreachable indica um cluster configurado mas inacessível; docker_unavailable indica um daemon Docker inacessível. Estes avisos continuam visíveis mesmo sem alertas críticos.
Alertas e gravidade
Os alertas critical incluem sondas desligadas, ambientes configurados inacessíveis e riscos graves. Os alertas warning abrangem degradações, pressão de CPU ou memória e problemas de configuração. Os alertas info apresentam indicações de baixo risco.
O centro de alertas reúne incidentes e avisos dos ambientes com a sonda, a causa e os detalhes disponíveis. A ausência de alertas críticos não significa ausência de avisos. Ocultar um alerta não corrige a infraestrutura.
Pontuação de eficiência
A pontuação de 0 a 100 combina utilização de CPU observada e potência estimada ou disponível para identificar subutilização, zonas eficientes e sobrecarga. Uma utilização muito baixa ou consumo desproporcionado pode reduzir a pontuação.
A pontuação ajuda a priorizar oportunidades de otimização. Não substitui a validação de picos, memória, dependências e capacidade exigida pela carga.
Recomendações de dimensionamento
As recomendações relacionam CPU, RAM, contexto de alojamento e catálogo do fornecedor quando disponível. São possíveis recomendações genéricas para servidores físicos ou fornecedores incertos.
A recomendação apresenta confiança, perfil-alvo, limites e impacto estimado disponível. A instância é um exemplo de catálogo. Valide dependências, picos, riscos e reversão antes de alterar a infraestrutura; poupanças estimadas não são poupanças realizadas.
Relatórios e exportações
As exportações JSON, CSV e PDF partilham dados normalizados: anfitriões, energia acumulada, CO₂ acumulado e séries temporais por sonda. Apoiam decisões com os dados disponíveis.
Selecione todas as sondas ou um subconjunto e escolha o idioma do relatório. O PDF apresenta pressupostos e limites de medição. As janelas de observação, decisão e estratégia são distintas.
API e OpenAPI
A documentação interativa está em /api/docs/ e o esquema em /api/schema/. O acesso autenticado continua sujeito às permissões da conta.
O âmbito /api/v1/ documentado inclui GET /api/v1/agents (sondas e resumo de alertas), GET /api/v1/metrics (métricas), GET /api/v1/alerts (alertas), GET /api/v1/recommendations (recomendações) e GET /api/v1/audit (dados do relatório).