For å kontrollere om en mistanke om driftsavbrudd stemmer med observasjoner i en bestemt region, henter du tjenestestatus og historikk for det valgte tidsrommet. Sammenhold regionen og tidsstemplene med applikasjonsloggene. Resultatet besvarer et konkret spørsmål: Er det registrert et regionalt signal i de lagrede dataene, og hvor fersk er den aktuelle oppføringen?
UptimeScouts spesifikasjon beskriver separate metoder for status og historikk. I statussvaret angir toppnivåfeltet `status` resultatet av API-kallet; tjenestesignalet finnes i `service.status`. Historikken inneholder aggregerte tidsintervaller, oppløsning og antall målinger. Dette er nyttige data for innledende diagnostikk og som vedlegg til en hendelsesrapport.
1. Klargjør tjeneste, region og lisens
Eksemplet nedenfor bruker tjeneste-ID-en `github` og regionen `US`. For din egen kontroll bruker du en gyldig ID fra UptimeScouts katalog og regionskoden der problemet ble observert. Hvilke regioner som er tilgjengelige, kan variere mellom tjenester; kontroller `available_regions` i svaret før du tolker resultatet.

Installer Python 3.10+ og SDK-et i henhold til prosjektets instruksjoner. Oppgi nøkkelen i miljøvariabelen `UPTIMESCOUT_LICENSE_KEY`, og ikke legg den inn i kode eller logger. Eksemplet gjør to kall via den dokumenterte klienten, lagrer de opprinnelige JSON-svarene i minnet og skriver dem ut for kontroll. Dette er et integrasjonseksempel, ikke en rapport om en test som er utført her.
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,
))
Det offisielle Python SDK-et for UptimeScout dokumenterer klienten, metodene `status` og `history` samt Bearer-autentisering i bakgrunnen. Følg de gjeldende instruksjonene i repositoriet for installasjon og versjoner; kodeutdraget forutsetter at SDK-et er installert.
2. Kontroller at du leser signalet, ikke statusen for forespørselen
Kontroller feltene `service.status`, `service.observed_at`, `service.stale` og regionen i svaret. Toppnivåfeltet `status` gjelder om API-kallet lyktes, ikke om selve tjenesten er tilgjengelig. Ta også vare på tidspunktet for kallet, tjeneste-ID-en og regionparametrene, slik at det er tydelig hvilken oppføring konklusjonen gjelder.
Hvis observasjonen er markert som fersk og `service.status` angir degradert drift eller avbrudd, registrerer du dette som et regionalt signal og sammenholder det med egne logger, tilkoblingsfeil og kontroller av applikasjonen. Feltet `stale` viser om den lagrede observasjonen har overskredet det fastsatte aktualitetsvinduet. Hvis verdien er `true` eller det nødvendige feltet mangler, må du betegne tilgjengeligheten akkurat nå som ukjent ut fra dette svaret; ikke trekk en konklusjon om nåværende tilstand fra en utdatert eller ufullstendig oppføring.
UptimeScout beskriver dataene som lagrede regionale signaler: De er et hjelpemiddel i diagnostikken, ikke en direkte måling av oppetid eller en bekreftelse på et globalt avbrudd. Formuler derfor resultatet presist: «Det ble funnet et signal av denne typen for regionen, registrert på det angitte tidspunktet.» Ved å sammenholde det med egne kontroller ser du om det eksterne signalet stemmer med brukernes erfaringer i applikasjonen din.
3. Sammenhold historikken og intervallenes oppløsning
Historikkmetoden returnerer tidsaggregeringer. Kontroller `resolution_seconds`, `samples`, `counts` og `effective_start` i svaret, og ta også vare på de faktiske tidsgrensene for intervallene. Dokumentasjonen beskriver justering etter UTC: treminuttersintervaller for vinduer på opptil én time, femminuttersintervaller for opptil tre timer, timeintervaller for opptil ett døgn og dagsintervaller for lengre vinduer. Eldre lagrede aggregater kan fortsatt ha en grovere oppgitt oppløsning.

Velg derfor tidsvindu etter hva du vil undersøke. Ved en kortvarig hendelse bruker du et passende kort tidsrom og viser oppløsningen sammen med resultatet. For en lang periode oppgir du at historikken kan være aggregert per dag: Et daglig datapunkt gjør det ikke mulig å rekonstruere utviklingen minutt for minutt.
Manglende intervaller er ukjente data, ikke bevis på normal drift. Ta vare på antall målinger og intervallenes grenser sammen med de aggregerte verdiene. Det gjør det enklere å vurdere hvor fullstendig historikken dekker perioden som undersøkes, og hvilke data konklusjonen bygger på.
4. Lag en etterprøvbar hendelsesoppføring
For rapporten holder det å ta vare på de opprinnelige svarene og normaliserte feltene: tjeneste, region, tidspunkt for kallet, `service.status`, `observed_at`, `stale`, valgt historikkvindu, `resolution_seconds`, antall målinger og `effective_start`. La manglende verdier stå som manglende: null og ingen data betyr ikke det samme.
Sammenhold deretter opplysningene med interne kontroller for samme periode: svarkoder, tilkoblingsfeil, driftsregion og tidsstempler. Hvis dataene ikke stemmer overens, tar du vare på begge versjonene. En regional observasjon fra UptimeScout og en kontroll av et bestemt endepunkt beskriver ulike observasjonspunkter. Et avvik krever derfor undersøkelse, ikke at man velger svaret som passer best.
Ved API-feil tar du utgangspunkt i HTTP-koden: spesifikasjonen oppgir ugyldige parametere, manglende lisens, ugyldig lisens, overskredet kvote og midlertidig utilgjengelighet. Rett opp den aktuelle årsaken. En feil i forespørselen er ikke statusen til tjenesten som kontrolleres.
Hva du skal gi til vakthavende
Oppgi tjeneste, region, observasjonstidspunkt, hvor fersk oppføringen er og historikkens oppløsning i den korte oppsummeringen. Merk intervaller uten data som ukjente, og legg ved interne logger fra samme tidsrom. Da får teamet et etterprøvbart regionalt signal uten å blande sammen statusen for API-kallet, UptimeScouts observasjoner og applikasjonens egne målinger.