Documentación de InfraWatts
Comprende los datos, las recomendaciones y los límites antes de decidir qué reducir, preparar o conservar.
Funcionamiento del producto
InfraWatts reúne métricas de infraestructura para detectar desperdicio y priorizar recomendaciones. La sonda identifica primero el host Linux o Windows y luego detecta Docker y Kubernetes de forma independiente. Un host Linux sigue siendo Linux cuando estos entornos están presentes.
El panel, el asistente, las alertas, las recomendaciones y las exportaciones leen el mismo estado del servidor. Las recomendaciones dependen de métricas observadas y contexto; un inventario por sí solo no demuestra ahorros. La sonda seleccionada sigue siendo el ámbito predeterminado.
Ámbito del asistente
El asistente utiliza por defecto la sonda seleccionada. Una pregunta global puede ampliar el análisis a varias sondas; mencionar otra sonda puede cambiar el ámbito si pertenece a tu cuenta.
/infra, /alerts y /agent <name> permiten precisar la solicitud. El contexto visible puede incluir la sonda, los entornos y el estado de Kubernetes. Una recomendación de acción no demuestra su ejecución.
Detección de entornos
La plataforma del host se identifica antes que los entornos. Detección y disponibilidad son distintas: Docker o Kubernetes pueden detectarse y estar indisponibles.
k8s_not_configured indica que no hay un contexto Kubernetes utilizable; k8s_unreachable indica un clúster configurado pero inaccesible; docker_unavailable indica un daemon Docker inaccesible. Estos avisos siguen visibles sin una alerta crítica.
Alertas y gravedad
Las alertas critical incluyen sondas desconectadas, entornos configurados inaccesibles y riesgos graves. Las alertas warning cubren degradación, presión de CPU o memoria y problemas de configuración. Las alertas info ofrecen indicaciones de bajo riesgo.
El centro de alertas reúne incidentes y avisos de entornos con la sonda, la causa y los detalles disponibles. La ausencia de alertas críticas no implica ausencia de avisos. Ocultar una alerta no corrige la infraestructura.
Puntuación de eficiencia
La puntuación de 0 a 100 combina utilización de CPU observada y potencia estimada o disponible para detectar infrautilización, zonas eficientes y sobrecarga. Una utilización muy baja o un consumo desproporcionado puede reducirla.
La puntuación ayuda a priorizar oportunidades de optimización. No sustituye la validación de picos, memoria, dependencias y capacidad requerida por la carga.
Recomendaciones de dimensionamiento
Las recomendaciones relacionan CPU, RAM, contexto de alojamiento y catálogo del proveedor cuando está disponible. Son posibles recomendaciones genéricas para servidores físicos o proveedores inciertos.
La recomendación muestra confianza, perfil objetivo, límites e impacto estimado disponible. La instancia es un ejemplo del catálogo. Valida dependencias, picos, riesgo y reversión antes de modificar la infraestructura; un ahorro estimado no es un ahorro realizado.
Informes y exportaciones
Las exportaciones JSON, CSV y PDF comparten datos normalizados: hosts, energía acumulada, CO₂ acumulado y series temporales por sonda. Ayudan a decidir con los datos disponibles.
Selecciona todas las sondas o un subconjunto y elige el idioma del informe. El PDF muestra supuestos y límites de medición. Las ventanas de observación, decisión y estrategia son distintas.
API y OpenAPI
La documentación interactiva está en /api/docs/ y el esquema en /api/schema/. El acceso autenticado sigue sujeto a los permisos de la cuenta.
El ámbito /api/v1/ documentado incluye GET /api/v1/agents (sondas y resumen de alertas), GET /api/v1/metrics (métricas), GET /api/v1/alerts (alertas), GET /api/v1/recommendations (recomendaciones) y GET /api/v1/audit (datos del informe).