Dettaglio di un controllo

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	Esito della singola verifica.
checks[].latencyMs	Tempo di risposta in millisecondi, null quando la verifica è fallita.
checks[].error	Il motivo del fallimento, null quando la verifica è riuscita.

Quanto storico ricevi

checks non è paginato: contiene tutte le verifiche entro la finestra di conservazione del tuo piano, dichiarata in retentionDays. Oltre quella finestra i dati non esistono più.

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.

Un controllo che verifica ogni 5 minuti produce circa 288 verifiche al giorno: su una finestra ampia la risposta può diventare grande. Tienine conto se la interroghi spesso.

Possibili errori

Codice	Causa
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Monitoraggio — lettura.
404	Il controllo non esiste, oppure è su un dominio fuori da quelli assegnati alla chiave.
429	Superato il limite di richieste.