Restituisce un controllo di monitoraggio con lo storico delle verifiche eseguite.
È la chiamata da usare per calcolare l'uptime nel proprio sistema, seguire l'andamento della latenza o inoltrare i disservizi a uno strumento di allerta esterno.
- Metodo:
GET
- Indirizzo:
https://console.icbs.it/api/v1/monitoring/{id}
- Permesso: Monitoraggio — lettura
Parametri
| Parametro | Posizione | Obbligatorio | Descrizione |
|---|
id | indirizzo | sì | Identificativo del controllo, da l'elenco dei controlli. |
Esempio di richiesta
curl -H "Authorization: Bearer $ICBS_API_KEY" \
https://console.icbs.it/api/v1/monitoring/51
Esempio di risposta
{
"monitor": {
"id": 51,
"name": "Sito principale",
"type": "web",
"target": "www.esempio.it",
"domain": "esempio.it",
"region": "eu-it",
"intervalMinutes": 5,
"enabled": true,
"up": true,
"lastCheckAt": "2026-08-06T05:15:00.000Z",
"statusSince": "2026-07-28T08:02:00.000Z",
"consecutiveFailures": 0
},
"retentionDays": 30,
"checks": [
{
"checkedAt": "2026-08-06T05:15:00.000Z",
"up": true,
"latencyMs": 128,
"region": "eu-it",
"error": null
},
{
"checkedAt": "2026-08-06T05:10:00.000Z",
"up": false,
"latencyMs": null,
"region": "eu-it",
"error": "Connection timed out"
}
]
}
Campi della risposta
| Campo | Descrizione |
|---|
monitor | Gli stessi campi dell'elenco dei controlli. |
retentionDays | Su quanti giorni si estende lo storico: vedi sotto. |
checks | Le verifiche eseguite, dalla più recente alla più vecchia. |
checks[].up |
La finestra dipende dal piano di monitoraggio: più è ampio il piano, più indietro arriva lo storico. Se calcoli una percentuale di disponibilità, dichiara sempre su quale periodo la stai calcolando — retentionDays te lo dice senza doverlo dedurre dalle date.