jsonscraper
Mercati
Torna al diario

UptimeScout: come verificare se un servizio ha avuto un’interruzione nella regione dell’utente

Un caso pratico: raccogliere la cronologia delle osservazioni per una regione e distinguere un segnale recente da un intervallo sconosciuto

Politica editoriale Segnala un errore

Quando gli utenti di un Paese segnalano problemi, ma il team vede il servizio funzionare normalmente, è più utile verificare le osservazioni proprio per la loro regione. L’API di UptimeScout consente di richiedere la cronologia di un servizio selezionato usando un codice regionale e restituisce gli intervalli insieme al numero di misurazioni. Il risultato è una tabella verificabile per analizzare la segnalazione: orario dell’intervallo, risoluzione, distribuzione dei segnali e numero di campioni.

Articolo: UptimeScout: come verificare se un servizio ha avuto un’interruzione nella regione dell’utente
Sintesi: La verifica regionale della disponibilità può chiarire se un problema segnalato da un utente coincide con le osservazioni di UptimeScout. Ecco una procedura riproducibile: scegliere servizio e regione, richiedere la cronologia, verificarne attualità e risoluzione, quindi salvare il risultato insieme alla risposta originale.
Ruolo dell’immagine: copertina — l’idea centrale
Sezione: 
Soggetto visivo: fotografia editoriale di una mappa regionale piegata
La regione e l’intervallo temporale definiscono i confini della verifica della disponibilità.© jsonscraper · creato con IA

Lo scenario pratico è la diagnosi di una presunta interruzione regionale. Dati in ingresso: identificativo del servizio nel catalogo UptimeScout, codice della regione come US o GB e intervallo di cronologia. Il risultato aiuta a confrontare l’orario della segnalazione dell’utente con le osservazioni del servizio. L’API descrive i dati come segnali di disponibilità osservata; la verifica del servizio aiuta a circoscrivere il problema, ma non sostituisce i controlli sulla propria applicazione.

Prima, confermare servizio e regione

Iniziate dal catalogo: cercate il servizio desiderato per nome o tramite la barra di ricerca, quindi annotatene l’ID esatto. La specifica OpenAPI di UptimeScout descrive la ricerca tramite GET /v1/services e i parametri q, service, region, limit e offset. Per un rapporto diagnostico è preferibile conservare l’ID, non soltanto il nome visualizzato: in questo modo una richiesta successiva si riferisce allo stesso elemento del catalogo.

La regione si specifica separatamente con un codice di due lettere. È importante salvarla insieme al risultato: una risposta filtrata per US e una risposta senza filtro regionale rispondono a domande diverse. Se occorre mostrare la descrizione in italiano, il parametro lang=it controlla la localizzazione della descrizione, mentre region seleziona le osservazioni. La documentazione distingue esplicitamente queste due funzioni.

Richiedere la cronologia anziché un singolo stato

Per analizzare un incidente, usate /v1/history con i parametri obbligatori service e la regione scelta. Il parametro hours definisce l’intervallo di cronologia; la specifica ammette valori da 1 a 2160 ore. La richiesta prevede anche lang. Secondo OpenAPI, l’autorizzazione avviene tramite una licenza con schema Bearer. Nell’esecuzione pratica, tenete la chiave in una variabile d’ambiente e non registratela nei log delle richieste.

import os
import requests

response = requests.get(
    "https://api.uptimescout.com/v1/history",
    headers={"Authorization": f"Bearer {os.environ['UPTIMESCOUT_LICENSE_KEY']}"},
    params={"service": "github", "region": "GB", "hours": 24, "lang": "ru"},
    timeout=30,
)
response.raise_for_status()
data = response.json()
print(data)

Questo è un esempio minimo di richiesta, non il risultato pubblicato di un’indagine reale. L’identificativo github e la regione GB sono parametri d’esempio: prima di usarli, scegliete il servizio e la regione pertinenti alla vostra attività. È utile salvare l’intera risposta in JSON e aggiungere l’orario di acquisizione e la descrizione della richiesta in campi separati del sistema di audit. Così è possibile ripetere l’analisi e verificare quale snapshot dei dati è stato utilizzato.

Risoluzione e dati mancanti fanno parte del risultato

Nell’array history sono importanti i campi observed_at, resolution_seconds, aggregated, samples e counts. La risoluzione indica la durata dell’intervallo temporale; samples mostra quante osservazioni sono state incluse nell’aggregato, mentre counts contiene la distribuzione dei segnali. Considerateli insieme: una riga con pochi campioni ha un peso analitico diverso da un aggregato basato su molte osservazioni.

Articolo: UptimeScout: come verificare se un servizio ha avuto un’interruzione nella regione dell’utente
Sintesi: La verifica regionale della disponibilità può chiarire se un problema segnalato da un utente coincide con le osservazioni di UptimeScout. Ecco una procedura riproducibile: scegliere servizio e regione, richiedere la cronologia, verificarne attualità e risoluzione, quindi salvare il risultato insieme alla risposta originale.
Ruolo dell’immagine: illustrazione di supporto 2 — un aspetto specifico diverso
Sezione: Risoluzione e dati mancanti fanno parte del risultato
Come leggere la cronologia: regione, intervalli temporali, risoluzione e lacune.© jsonscraper · illustrazione generata con IA

UptimeScout descrive la cronologia come intervalli temporali con granularità diversa a seconda dell’intervallo selezionato: intervalli di un minuto e cinque minuti per i periodi brevi, orari per le giornate e giornalieri per i periodi lunghi. Gli aggregati meno recenti salvati possono avere una risoluzione più grossolana. Perciò non concludete che «l’interruzione è iniziata esattamente in questo minuto» se la riga rappresenta un aggregato orario o giornaliero. Usate il valore effettivo di resolution_seconds e i campi effective_start e history_resolution della risposta per indicare i limiti delle conclusioni possibili.

Considerate sconosciuto ogni intervallo assente. La specifica chiede espressamente di trattare le lacune come intervalli sconosciuti: un vuoto nella cronologia non indica di per sé né un funzionamento normale né un’interruzione. Nei rapporti, questa semplice regola evita di riempire erroneamente le lacune con uno stato «verde» o con degli zeri.

Confrontare la cronologia con il segnale corrente

Se occorre verificare lo stato al momento della segnalazione, richiedete /v1/status per lo stesso service e la stessa regione. Nell’oggetto del servizio, considerate insieme status, observed_at e stale: la documentazione presenta questi campi come strumenti per comprendere lo stato e l’attualità del segnale. Lo stato di livello superiore riguarda il risultato della richiesta API, mentre service.status descrive il segnale di disponibilità del servizio specifico. Questa distinzione è particolarmente utile nei rapporti automatici: una risposta HTTP riuscita e lo stato di un servizio esterno sono entità diverse.

Per più dipendenze, potete passare a /v1/statuses e poi consultare la cronologia solo per i servizi e le regioni in cui è comparsa un’anomalia. La specifica mette a disposizione anche /v1/summary e /v1/incidents. Per diagnosticare quest’ultimo endpoint, tenete conto della sua funzione precisa: restituisce segnali recenti e intensificati di disservizi, non incidenti confermati dal fornitore stesso. Il risultato è quindi uno spunto per una verifica, non una conclusione definitiva sulla causa.

Come formulare le conclusioni senza congetture

Salvate nella riga del rapporto l’ID del service, la region, l’intervallo della richiesta, observed_at, resolution_seconds, samples, counts e l’indicazione delle lacune. Aggiungete separatamente il collegamento alla segnalazione o all’incidente interno, senza mescolarlo ai campi dell’API. Poi confrontate l’intervallo temporale con i log dell’applicazione, le tracce regionali e la segnalazione dell’utente. Se i confini temporali dell’aggregato superano quelli dell’incidente, formulate la conclusione di conseguenza: le osservazioni nella regione selezionata, nell’intervallo specificato, contengono determinati segnali, con una certa risoluzione e un determinato numero di campioni.

Questa analisi offre al reperibile un percorso utile: verificare la componente regionale del servizio esterno oppure proseguire la diagnosi dell’applicazione e della rete dell’utente. La riproducibilità dipende dalla conservazione dei parametri della richiesta e del JSON originale; l’affidabilità delle conclusioni temporali dipende invece dalla considerazione esplicita della risoluzione, dei campioni e degli intervalli sconosciuti. In un caso di disponibilità, questo è il risultato pratico: non una semplice etichetta di stato corrente, ma una registrazione circoscritta per regione e tempo che un collega può ricontrollare.

Persone

Nessuna persona elencata ancora per questo articolo.

Continua a leggereCome leggere gli incidenti di UptimeScout: un segnale di disservizio non è ancora un incidente confermato
Leggi il prossimo articolo

Trasforma ciò che leggi in un'integrazione funzionante

Esplora le API per dati social di jsonscraper, prova le richieste e crea il tuo prossimo flusso di lavoro.

Esplora API