jsonscraper
Mercati
Torna al diario

Verifica del segnale regionale: come confrontare lo stato del servizio con la cronologia di UptimeScout

Richiedi osservazioni regionali e cronologia, controlla l’orario e l’aggiornamento, quindi confronta i dati con i log dell’applicazione.

Politica editoriale Segnala un errore

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.

Articolo: Verifica del segnale regionale: come confrontare lo stato del servizio con la cronologia di UptimeScout
Riepilogo: Diagnostica passo passo di un segnale regionale UptimeScout: richiesta tramite Python SDK, verifica dei campi `service.status`, `observed_at` e `stale`, quindi confronto con la cronologia e la relativa risoluzione.
Ruolo dell’immagine: copertina — idea centrale
Sezione: 1. Prepara il servizio, la regione e la licenza
Soggetto visivo: Illustrazione fotografica editoriale, ripresa ravvicinata di una scheda per la risposta agli incidenti su un tavolo: una mappa regionale degli Stati Uniti accanto a due n
La regione sulla mappa viene confrontata con i timestamp e le lacune nella cronologia delle osservazioni.© jsonscraper · creato con IA

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.

Articolo: Verifica del segnale regionale: come confrontare lo stato del servizio con la cronologia di UptimeScout
Riepilogo: Diagnostica passo passo di un segnale regionale UptimeScout: richiesta tramite Python SDK, verifica dei campi `service.status`, `observed_at` e `stale`, quindi confronto con la cronologia e la relativa risoluzione.
Ruolo dell’immagine: illustrazione di supporto 2 — un aspetto specifico diverso
Sezione: 3. Confronta la cronologia e la risoluzione degli intervalli
Soggetto visivo: Infografica editoriale pulita su sfondo chiaro, quattro pannelli in sequenza mostran
Campi della risposta e procedura per controllare il segnale regionale e la cronologia.© jsonscraper · illustrazione generata dall’IA

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.

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