Grafana · Le tue metriche nelle tue dashboard
Nimbox SRE espone le tue metriche come origine dati compatibile con Prometheus. Colleghi il tuo Grafana, scrivi le query che vuoi e costruisci le dashboard che ti servono, senza chiederci nulla.
Vedrai soltanto i tuoi dati. Ogni query viene ristretta alla tua azienda prima di essere eseguita, qualunque cosa tu scriva.
La via rapida: i pannelli inclusi
Nella console apri Agente e premi Abrir mis paneles. Si apre con la tua sessione — senza una seconda password — e trovi tre dashboard già pronte sui tuoi dati:
- Infrastruttura: host attivi, giù, silenziosi e in manutenzione; CPU, memoria e disco; e lo stato dei tuoi agenti.
- Servizi e incidenti: cosa è giù adesso, quanti servizi sono caduti insieme, incidenti per gravità.
- Servizio e impegni: se si sta rispettando quanto promesso — prima risposta e risoluzione nei tempi.
È incluso e non c'è nulla da installare. Puoi modificarle e crearne di tue.
Il resto di questa pagina è per chi preferisce collegare il proprio Grafana.
1. Ottenere la credenziale
Nella console apri Agente e scorri fino a Le tue metriche nel tuo Grafana. Premi Emitir credencial e dalle un nome che ti ricordi a cosa serve — per esempio «Grafana operativo».
Si mostra una sola volta
La credenziale compare una sola volta, al momento di crearla. Non la conserviamo in forma recuperabile: se la perdi, emettine un'altra e revoca la precedente. Inizia con mx_.
Puoi averne diverse contemporaneamente, una per strumento, e revocarle singolarmente. Una credenziale revocata smette di funzionare all'istante.
2. Aggiungere l'origine dati in Grafana
In Grafana vai su Connections → Data sources → Add new data source e scegli Prometheus.
| Campo | Valore |
|---|---|
| Prometheus server URL | https://app.nimboxsre.com/api/prom |
| Authentication | (nessuna: si usa un header) |
| Custom HTTP Headers | Authorization = Bearer LA_TUA_CREDENZIALE |
Premi Save & test. Se è tutto corretto, Grafana conferma che l'origine risponde.
Se non funziona
Un 401 significa che la credenziale non arriva o non è valida — controlla che l'header dica Bearer seguito da uno spazio e dal valore. Un errore di rete di solito è un https:// dimenticato nell'URL.
3. Interrogare
Sono normali metriche Prometheus. Supportano rate(), sum by (host), avg_over_time() e tutto il resto.
| Cosa vuoi vedere | Query |
|---|---|
| Host attivi | monit_host_up |
| CPU per host | monit_cpu_percent |
| Memoria usata, in percentuale | monit_mem_percent |
| Disco per punto di mount | monit_disk_percent |
| Servizi non attivi | monit_service_up == 0 |
| Incidenti attivi per gravità | monit_incident_count |
| Incidenti risolti dall'agente | monit_sre_resolved_total |
| Prima risposta entro l'obiettivo | monit_sre_response_sla_percent |
Qualche esempio più elaborato:
# I cinque host con più CPU in questo momento
topk(5, monit_cpu_percent)
# Media di memoria nell'ultima ora, per host
avg_over_time(monit_mem_percent[1h])
# Dischi sopra l'85%
monit_disk_percent > 85
# Quanti host sono giù
count(monit_host_up == 0)
Non serve filtrare per azienda
Non aggiungere tenant="..." alle tue query: viene già fatto per te. Se nomini un'altra azienda la query viene rifiutata con un errore di conflitto invece di restituire un risultato vuoto, così è chiaro cosa è successo.
Cosa può fare la credenziale
Solo leggere, e solo le tue serie. Non consente di scrivere metriche, cancellare nulla o leggere la configurazione del tuo account. Se viene esposta, chi la possiede può vedere i tuoi grafici: revocala dalla stessa schermata ed emettine una nuova.
Conservazione
Quanto storico è disponibile dipende dal tuo contratto. Il livello incluso conserva 30 giorni; esistono livelli da 12 e 24 mesi.
A partire dall'attivazione
Quando estendi la conservazione, l'archivio inizia ad accumularsi da quel momento. Lo storico già fuori dalla finestra precedente non viene recuperato retroattivamente.