Documentazione InfraWatts
Comprendi dati, raccomandazioni e limiti prima di decidere cosa ridurre, preparare o mantenere.
Funzionamento del prodotto
InfraWatts raccoglie metriche dell’infrastruttura per rilevare sprechi e dare priorità alle raccomandazioni. La sonda identifica prima l’host Linux o Windows, poi rileva Docker e Kubernetes in modo indipendente. Un host Linux rimane Linux anche con questi ambienti.
Dashboard, assistente, avvisi, raccomandazioni ed esportazioni leggono lo stesso stato del server. Le raccomandazioni dipendono da metriche osservate e contesto; il solo inventario non dimostra risparmi. La sonda selezionata rimane l’ambito predefinito.
Ambito dell’assistente
L’assistente usa la sonda selezionata per impostazione predefinita. Una domanda globale può estendere l’analisi a più sonde; citare un’altra sonda può cambiare l’ambito se appartiene al tuo account.
/infra, /alerts e /agent <name> permettono di precisare la richiesta. Il contesto visibile può includere sonda, ambienti e stato Kubernetes. Una raccomandazione non dimostra l’esecuzione dell’azione.
Rilevamento degli ambienti
La piattaforma host viene identificata prima degli ambienti. Rilevamento e disponibilità sono distinti: Docker o Kubernetes possono essere rilevati ma non disponibili.
k8s_not_configured indica l’assenza di un contesto Kubernetes utilizzabile; k8s_unreachable indica un cluster configurato ma irraggiungibile; docker_unavailable indica un daemon Docker irraggiungibile. Questi avvisi restano visibili anche senza un allarme critico.
Avvisi e gravità
Gli avvisi critical includono sonde offline, ambienti configurati irraggiungibili e rischi gravi. Gli avvisi warning riguardano degrado, pressione su CPU o memoria e problemi di configurazione. Gli avvisi info forniscono indicazioni a basso rischio.
Il centro avvisi riunisce incidenti e avvisi degli ambienti con sonda, causa e dettagli disponibili. L’assenza di avvisi critici non implica l’assenza di altri avvisi. Nascondere un avviso non corregge l’infrastruttura.
Punteggio di efficienza
Il punteggio da 0 a 100 combina utilizzo CPU osservato e potenza stimata o disponibile per evidenziare sottoutilizzo, zone efficienti e sovraccarico. Un utilizzo molto basso o un consumo sproporzionato può ridurlo.
Il punteggio aiuta a dare priorità alle opportunità di ottimizzazione. Non sostituisce la verifica di picchi, memoria, dipendenze e capacità richiesta dal carico.
Raccomandazioni di dimensionamento
Le raccomandazioni collegano CPU, RAM, contesto di hosting e catalogo del fornitore quando disponibile. Rimangono possibili raccomandazioni generiche per server fisici o fornitori incerti.
La raccomandazione mostra confidenza, profilo obiettivo, limiti e impatto stimato disponibile. L’istanza è un esempio di catalogo. Verifica dipendenze, picchi, rischio e ripristino prima di modificare l’infrastruttura; un risparmio stimato non è un risparmio realizzato.
Report ed esportazioni
Le esportazioni JSON, CSV e PDF condividono dati normalizzati: host, energia cumulata, CO₂ cumulata e serie temporali per sonda. Supportano le decisioni con i dati disponibili.
Seleziona tutte le sonde o un sottoinsieme e scegli la lingua del report. Il PDF mostra ipotesi e limiti di misurazione. Le finestre di osservazione, decisione e strategia sono distinte.
API e OpenAPI
La documentazione interattiva è su /api/docs/ e lo schema su /api/schema/. L’accesso autenticato rimane soggetto ai permessi dell’account.
L’ambito /api/v1/ documentato include GET /api/v1/agents (sonde e riepilogo avvisi), GET /api/v1/metrics (metriche), GET /api/v1/alerts (avvisi), GET /api/v1/recommendations (raccomandazioni) e GET /api/v1/audit (dati del report).