Om du vill kontrollera om en misstänkt störning stämmer överens med observationer i en viss region hämtar du tjänstens status och historiken för det valda tidsintervallet. Jämför regionen och tidsstämplarna med applikationens loggar. Resultatet besvarar en konkret fråga: finns det en regional signal i de sparade uppgifterna, och hur aktuell är den tillhörande posten?
UptimeScouts specifikation beskriver separata metoder för status och historik. I statussvaret anger toppnivåfältet `status` resultatet av API-begäran; tjänstens signal finns i `service.status`. Historiken innehåller aggregerade tidsintervall, upplösning och antal mätningar. Det är användbara uppgifter vid en första felsökning och som underlag till en incidentrapport.
1. Förbered tjänst, region och licens
Exemplet nedan använder tjänst-ID:t `github` och regionen `US`. För din egen kontroll använder du ett giltigt ID från UptimeScouts katalog och koden för den region där problemet observerades. Vilka regioner som är tillgängliga kan variera mellan tjänster; kontrollera därför `available_regions` i svaret innan du tolkar resultatet.

Installera Python 3.10+ och SDK:t enligt projektets instruktioner. Ange nyckeln i miljövariabeln `UPTIMESCOUT_LICENSE_KEY` och lägg den inte i koden eller loggarna. Exemplet gör två begäranden med den dokumenterade klienten, sparar de ursprungliga JSON-svaren i minnet och skriver ut dem för kontroll. Det här är ett integrations exempel, inte en rapport om ett test som utförts här.
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 officiella Python-SDK:t för UptimeScout dokumenterar klienten, metoderna `status` och `history` samt den underliggande Bearer-autentiseringen. Följ de aktuella anvisningarna i repot för installation och versioner; kodsnutten förutsätter att SDK:t är installerat.
2. Kontrollera att du läser signalen, inte begärans status
Kontrollera fälten `service.status`, `service.observed_at`, `service.stale` och regionen i svaret. Toppnivåfältet `status` gäller om API-begäran lyckades, inte om själva tjänsten är tillgänglig. Spara även tidpunkten för begäran, tjänst-ID:t och regionparametrarna, så att det framgår vilken post slutsatsen gäller.
Om observationen markeras som aktuell och `service.status` anger försämrad drift eller avbrott ska du dokumentera det som en regional signal och jämföra den med dina egna loggar, anslutningsfel och kontroller av applikationen. Fältet `stale` visar om den sparade observationen har passerat den fastställda aktualitetsperioden. Om värdet är `true` eller om det nödvändiga fältet saknas ska du ange att den aktuella tillgängligheten är okänd utifrån det här svaret. Dra inte slutsatser om nuläget från en inaktuell eller ofullständig post.
UptimeScout beskriver uppgifterna som sparade regionala signaler: de är ett riktmärke för felsökning, inte en direkt mätning av drifttid och inte en bekräftelse på ett globalt avbrott. Formulera därför resultatet precist: ”För regionen hittades en signal av den här typen, registrerad vid den angivna tidpunkten.” En jämförelse med dina egna kontroller visar om den externa signalen stämmer överens med användarnas upplevelse av din applikation.
3. Jämför historiken och intervallens upplösning
Historikmetoden returnerar tidsaggregeringar. Kontrollera `resolution_seconds`, `samples`, `counts` och `effective_start` i svaret och spara även intervallens faktiska tidsgränser. Dokumentationen beskriver justering efter UTC: intervall på tre minuter för tidsfönster på upp till en timme, fem minuter för upp till tre timmar, en timme för upp till ett dygn och en dag för längre tidsfönster. Äldre sparade aggregat kan ha en grövre angiven upplösning.

Välj därför ett tidsfönster som passar frågan. För en kort incident använder du ett lämpligt kort intervall och anger upplösningen tillsammans med resultatet. För en längre period bör du upplysa om att historiken kan vara aggregerad per dag: en datapunkt per dag räcker inte för att återskapa utvecklingen minut för minut.
Saknade intervall är okända uppgifter, inte ett tecken på normal drift. Spara antalet mätningar och intervallens gränser tillsammans med de aggregerade värdena. Då går det att bedöma hur fullständigt historiken täcker den undersökta perioden och vilka uppgifter slutsatsen bygger på.
4. Skapa en verifierbar incidentpost
För rapporten räcker det att spara de ursprungliga svaren och normaliserade fält: tjänst, region, tidpunkt för begäran, `service.status`, `observed_at`, `stale`, valt historikfönster, `resolution_seconds`, antal mätningar och `effective_start`. Låt värden som saknas förbli tomma: noll och avsaknad av uppgifter betyder olika saker.
Jämför sedan uppgifterna med interna kontroller från samma period: svarskoder, anslutningsfel, driftregion och tidsstämplar. Om uppgifterna skiljer sig åt ska du spara båda sidorna. UptimeScouts regionala observation och en kontroll av en specifik endpoint avser olika observationspunkter, så en avvikelse behöver utredas i stället för att du väljer det svar som passar bäst.
Vid API-fel ska du utgå från HTTP-koden: specifikationen listar felaktiga parametrar, saknad licens, ogiltig licens, överskriden kvot och tillfällig otillgänglighet. Åtgärda den aktuella orsaken. Ett begärandefel är inte statusen för tjänsten du kontrollerar.
Vad du ska lämna över till jouren
Ange tjänst, region, observationstid, postens aktualitet och historikens upplösning i den korta sammanfattningen. Markera intervall utan uppgifter som okända och bifoga interna loggar från samma period. Då får teamet en verifierbar regional signal utan att blanda ihop API-begärans status, UptimeScouts observationer och applikationens egna mätningar.