jsonscraper
Marknader
Tillbaka till journalen

Kontrollera en regional signal: jämför tjänstens status med UptimeScouts historik

Hämta regionala observationer och historik, kontrollera tid och aktualitet och jämför sedan med applikationens loggar.

Redaktionella riktlinjer Rapportera ett fel

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.

Artikel: Kontrollera en regional signal: jämför tjänstens status med UptimeScouts historik
Sammanfattning: Stegvis felsökning av en regional UptimeScout-signal: gör en begäran via Python-SDK:t, kontrollera fälten `service.status`, `observed_at` och `stale` och granska sedan historiken och dess upplösning.
Bildens roll: omslagsbild – huvudidén
Avsnitt: 1. Förbered tjänst, region och licens
Visuellt motiv: Redaktionell fotoillustration, närbild av en incidenthanteringsarbetsyta: en karta över USA bredvid två n
Regionen på kartan jämförs med tidsstämplar och luckor i observationshistoriken.© jsonscraper · skapad med AI

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.

Artikel: Kontrollera en regional signal: jämför tjänstens status med UptimeScouts historik
Sammanfattning: Stegvis felsökning av en regional UptimeScout-signal: gör en begäran via Python-SDK:t, kontrollera fälten `service.status`, `observed_at` och `stale` och granska sedan historiken och dess upplösning.
Bildens roll: kompletterande illustration 2 – en annan specifik aspekt
Avsnitt: 3. Jämför historiken och intervallens upplösning
Visuellt motiv: En renodlad redaktionell infografik med ljus bakgrund, fyra sekventiella paneler visar
Svarsfälten och stegen för att kontrollera regionala signaler och historik.© jsonscraper · AI-genererad illustration

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.

Personer

Inga personer listade för denna artikel ännu.

Fortsätt läsaSå läser du UptimeScout incidents: en felsignal är ännu ingen bekräftad incident
Läs nästa artikel

Gör det du läser till en fungerande integration

Utforska jsonscrapers API:er för social data, testa anrop och bygg nästa arbetsflöde.

Utforska API:er