Chcete-li ověřit, zda se podezření na výpadek shoduje s pozorováním v konkrétním regionu, vyžádejte si stav služby a historii za zvolené období. Porovnejte region a časové značky s protokoly aplikace. Výsledek odpovídá na konkrétní otázku: zda je regionální signál zaznamenán v uložených datech a jak aktuální je příslušný záznam.
Specifikace UptimeScout popisuje samostatné metody pro stav a historii. V odpovědi o stavu uvádí nejvyšší pole `status` výsledek požadavku API; signál služby se nachází v `service.status`. Historie obsahuje agregované časové intervaly, rozlišení a počet vzorků. Jde o užitečná data pro prvotní diagnostiku a jako přílohu k hlášení o incidentu.
1. Připravte službu, region a licenci
Následující příklad používá ID služby `github` a region `US`. Pro vlastní kontrolu použijte platné ID z katalogu UptimeScout a kód regionu, v němž se problém projevil. Dostupné regiony se mohou u jednotlivých služeb lišit; před interpretací zkontrolujte v odpovědi `available_regions`.

Nainstalujte Python 3.10+ a SDK podle pokynů projektu. Nastavte klíč v proměnné prostředí `UPTIMESCOUT_LICENSE_KEY` a nevkládejte jej do kódu ani protokolů. Příklad provede dva požadavky prostřednictvím dokumentovaného klienta, uloží původní odpovědi JSON do paměti a vypíše je ke kontrole. Jde o ukázku integrace, nikoli o zprávu o zde provedeném testu.
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,
))
Oficiální Python SDK UptimeScout dokumentuje klienta, metody `status` a `history` i autentizaci Bearer na pozadí. Při instalaci a výběru verzí postupujte podle aktuálních pokynů v repozitáři; ukázka předpokládá, že SDK již máte nainstalované.
2. Ověřte, že čtete signál, nikoli stav požadavku
V odpovědi zkontrolujte pole `service.status`, `service.observed_at`, `service.stale` a region odpovědi. Nejvyšší pole `status` se vztahuje k úspěšnosti požadavku API, nikoli k dostupnosti samotné služby. Uložte také čas požadavku, ID služby a parametry regionu, aby bylo jasné, k jakému záznamu se závěr vztahuje.
Pokud je pozorování označeno jako aktuální a `service.status` ukazuje na zhoršený stav nebo výpadek, zaznamenejte jej jako regionální signál a porovnejte jej s vlastními protokoly, chybami připojení a kontrolami aplikace. Pole `stale` ukazuje, zda uložené pozorování překročilo stanovené období aktuálnosti. Pokud má hodnotu `true` nebo požadované pole chybí, označte dostupnost v danou chvíli podle této odpovědi jako neznámou; ze zastaralého či neúplného záznamu nevyvozujte závěr o současném stavu.
UptimeScout popisuje data jako uložené regionální signály: jsou vodítkem pro diagnostiku, nikoli přímým měřením dostupnosti nebo potvrzením globálního výpadku. Výsledek proto formulujte přesně: „Pro region byl nalezen signál tohoto typu zaznamenaný v uvedeném čase.“ Porovnání s vlastními kontrolami ukáže, zda tento externí signál odpovídá zkušenostem uživatelů vaší aplikace.
3. Porovnejte historii a rozlišení intervalů
Metoda historie vrací časové agregace. V odpovědi zkontrolujte `resolution_seconds`, `samples`, `counts` a `effective_start`; uložte také skutečné časové hranice intervalů. Dokumentace popisuje zarovnání podle UTC: tříminutové intervaly pro období do jedné hodiny, pětiminutové do tří hodin, hodinové do 24 hodin a denní pro delší období. U starších uložených agregací může zůstat uvedeno hrubší rozlišení.

Proto zvolte období podle toho, co chcete zjistit. U krátkého incidentu použijte vhodný krátký rozsah a vedle výsledku uveďte rozlišení. U dlouhého období zmiňte, že historie může být agregována po dnech: z denního bodu nelze obnovit průběh po minutách.
Chybějící intervaly znamenají neznámá data, nikoli důkaz normálního provozu. Vedle agregovaných hodnot uchovávejte počet vzorků a hranice intervalů. Pomůže to posoudit, jak úplně historie pokrývá zkoumané období a na jakých datech je závěr založen.
4. Připravte ověřitelný záznam o incidentu
Pro hlášení stačí uchovat původní odpovědi a normalizovaná pole: službu, region, čas požadavku, `service.status`, `observed_at`, `stale`, zvolené období historie, `resolution_seconds`, počet vzorků a `effective_start`. Chybějící hodnotu ponechte jako chybějící: nula a absence dat mají odlišný význam.
Poté tyto údaje porovnejte s interními kontrolami za stejné období: stavovými kódy, chybami připojení, regionem nasazení a časovými značkami. Pokud se data rozcházejí, uchovejte obě strany. Regionální pozorování UptimeScout a kontrola konkrétního endpointu popisují různá místa pozorování, takže rozpor sám o sobě vyžaduje prověření, nikoli výběr výhodnějšího výsledku.
V případě chyby API se řiďte kódem HTTP: specifikace uvádí nesprávné parametry, chybějící licenci, neplatnou licenci, překročení kvóty a dočasnou nedostupnost. Opravte příslušnou příčinu. Chyba požadavku není stavem kontrolované služby.
Co předat pohotovostnímu týmu
Ve stručném závěru uveďte službu, region, čas pozorování, aktuálnost záznamu a rozlišení historie. Intervaly bez dat výslovně označte jako neznámé a přiložte interní protokoly za odpovídající období. Tým tak získá ověřitelný regionální signál, aniž by zaměnil stav požadavku API, pozorování UptimeScout a vlastní měření aplikace.