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

https://jsonscraper.com/it/blog/verificare-disponibilita-servizio-per-regione

Author: Michael Johnson

Published: 2026-11-20T11:38:39+00:00

Updated: 2026-11-20T11:38:39+00:00

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

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](https://jsonscraper.com/assets/uploads/journal/2026/11/1cd4023e50fafa3c2411a7c5fc1a0f4b.png.hero.webp)

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](https://uptimescout.com/openapi.json) 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](https://jsonscraper.com/assets/uploads/journal/2026/11/a171063a93107bb525c54a0ee477e61a.png.hero.webp)

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.
