Per verificare se il sospetto di un disservizio coincide con le osservazioni in una regione specifica, richiedi lo stato del servizio e la cronologia per l’intervallo scelto. Confronta la regione e i timestamp con i log dell’applicazione. Il risultato risponde a una domanda precisa: il segnale regionale è registrato nei dati conservati e quanto è aggiornata la relativa voce?
La specifica di UptimeScout descrive metodi distinti per lo stato e la cronologia. Nella risposta sullo stato, il campo di primo livello `status` indica l’esito della richiesta API; il segnale del servizio si trova in `service.status`. La cronologia contiene intervalli temporali aggregati, la risoluzione e il numero di campioni. Sono dati utili per una prima diagnosi e da allegare a un rapporto sull’incidente.
1. Prepara il servizio, la regione e la licenza
L’esempio qui sotto usa l’ID del servizio `github` e la regione `US`. Per la tua verifica, scegli un ID valido dal catalogo UptimeScout e il codice della regione in cui è stato osservato il problema. Le regioni disponibili possono variare da un servizio all’altro; prima di interpretare i dati, controlla `available_regions` nella risposta.

Installa Python 3.10 o versione successiva e l’SDK seguendo le istruzioni del progetto. Imposta la chiave nella variabile d’ambiente `UPTIMESCOUT_LICENSE_KEY` e non inserirla nel codice o nei log. L’esempio esegue due richieste tramite il client documentato, conserva in memoria le risposte JSON originali e le stampa per consentirne la verifica. È un esempio di integrazione, non il resoconto di un test eseguito qui.
import json
import os
from uptimescout import Client, UptimeScoutError
client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
try:
status_data = client.status("github", region="US", lang="ru")
history_data = client.history("github", region="US", hours=24, lang="ru")
except UptimeScoutError as error:
raise SystemExit(f"API request failed: HTTP {error.status}")
print(json.dumps(
{"status": status_data, "history": history_data},
ensure_ascii=False,
indent=2,
))
Il Python SDK ufficiale di UptimeScout documenta il client, i metodi `status` e `history` e l’autenticazione Bearer gestita internamente. Per l’installazione e le versioni, segui le istruzioni correnti del repository; il frammento presuppone che l’SDK sia già installato.
2. Assicurati di leggere il segnale, non lo stato della richiesta
Nella risposta, controlla i campi `service.status`, `service.observed_at`, `service.stale` e la regione indicata. Il campo di primo livello `status` riguarda l’esito della richiesta API, non la disponibilità del servizio. Conserva anche l’ora della richiesta, l’ID del servizio e i parametri regionali: così sarà chiaro a quale voce si riferisce il risultato.
Se l’osservazione è indicata come aggiornata e `service.status` segnala un degrado o un’interruzione, annotala come segnale regionale e confrontala con i tuoi log, gli errori di connessione e i controlli dell’applicazione. Il campo `stale` indica se l’osservazione conservata ha superato la finestra di aggiornamento prevista. Se vale `true` o il campo necessario è assente, considera sconosciuta la disponibilità attuale sulla base di quella risposta; non trasformare una voce obsoleta o incompleta in una conclusione sullo stato presente.
UptimeScout descrive i dati come segnali regionali conservati: sono un riferimento per la diagnosi, non una misurazione diretta dell’uptime né una conferma di un’interruzione globale. Formula quindi il risultato con precisione: «per la regione è stato rilevato un segnale di questo tipo, registrato all’ora indicata». Il confronto con i tuoi controlli mostrerà se questo segnale esterno è coerente con l’esperienza degli utenti della tua applicazione.
3. Confronta la cronologia e la risoluzione degli intervalli
Il metodo della cronologia restituisce aggregati temporali. Nella risposta, controlla `resolution_seconds`, `samples`, `counts` ed `effective_start`; conserva anche i limiti temporali effettivi degli intervalli. La documentazione descrive l’allineamento in UTC: intervalli di tre minuti per finestre fino a un’ora, di cinque minuti fino a tre ore, orari fino a un giorno e giornalieri per finestre più lunghe. Gli aggregati storici conservati possono mantenere una risoluzione dichiarata più grossolana.

Scegli quindi l’intervallo in base alla domanda. Per un incidente breve, usa un intervallo altrettanto breve e indica la risoluzione accanto al risultato. Per un periodo lungo, specifica che la cronologia potrebbe essere aggregata per giorno: un dato giornaliero non permette di ricostruire l’andamento minuto per minuto.
Gli intervalli mancanti rappresentano dati sconosciuti, non la prova di un funzionamento normale. Conserva il numero di campioni e i limiti degli intervalli insieme ai valori aggregati. Questo aiuta a capire quanto la cronologia copra il periodo analizzato e su quali dati si basa la conclusione.
4. Prepara una registrazione verificabile dell’incidente
Per il rapporto è sufficiente conservare le risposte originali e i campi normalizzati: servizio, regione, ora della richiesta, `service.status`, `observed_at`, `stale`, intervallo storico selezionato, `resolution_seconds`, numero di campioni ed `effective_start`. Lascia assente un valore mancante: zero e assenza di dati hanno significati diversi.
Confronta poi queste informazioni con i controlli interni relativi allo stesso periodo: codici di risposta, errori di connessione, regione di hosting e timestamp. Se i dati non coincidono, conserva entrambi i riscontri. L’osservazione regionale di UptimeScout e il controllo di un endpoint specifico descrivono punti di osservazione diversi; la discrepanza richiede quindi una verifica, non la scelta del risultato più comodo.
In caso di errore API, fai riferimento al codice HTTP: la specifica elenca parametri non validi, licenza assente o non valida, superamento della quota e indisponibilità temporanea. Correggi la causa corrispondente. Un errore della richiesta non è lo stato del servizio verificato.
Cosa comunicare a chi è di turno
Nella sintesi indica servizio, regione, ora dell’osservazione, aggiornamento della voce e risoluzione della cronologia. Segnala separatamente come sconosciuti gli intervalli senza dati e allega i log interni relativi allo stesso periodo. In questo modo il team riceverà un segnale regionale verificabile, senza confondere l’esito della richiesta API, le osservazioni di UptimeScout e le misurazioni dell’applicazione.