jsonscraper
Trhy
Zpět do magazínu

Jak číst UptimeScout incidents: signál výpadku ještě není potvrzený incident

Endpoint pomáhá vybrat čerstvé regionální signály; příčinu a potvrzení je třeba ověřit samostatně

Redakční zásady Nahlásit chybu

Lze z odpovědi UptimeScout incidents rovnou vyhlásit, že služba má výpadek? Ne: tento endpoint uvádí služby s nedávnými zvýšenými signály narušení a specifikace výslovně upozorňuje, že nejde o poskytovatelem potvrzené incidenty. Praktickým výsledkem je krátký seznam signálů k prověření, nikoli hotový závěr o příčině výpadku.

Článek: Jak číst UptimeScout incidents: signál výpadku ještě není potvrzený incident
Shrnutí: API UptimeScout může vrátit seznam služeb se zvýšenými signály narušení. Ukazujeme, jak o něj požádat a ověřit aktuálnost dat, aniž by se signál z pozorování vydával za zprávu o oficiálním výpadku.
Role obrázku: titulní — ústřední myšlenka
Sekce: 
Vizuální motiv: Redakční fotografická ilustrace: vytištěná mapa Spojených států s malou skupinou červených a jantarových značek pozorování nad jedním reg
Regionální signály je třeba ověřit© jsonscraper · vytvořeno pomocí AI

Pro pohotovostního inženýra a analytika je tento rozdíl důležitý: automatické upozornění může sdělit „prověřte službu X v regionu Y“, zatímco potvrzení skutečnosti a vysvětlení příčiny ponechá oficiálnímu stavu poskytovatele nebo vlastní diagnostice. Specifikace UptimeScout dokumentuje samostatné trasy pro signály, aktuální stav a historii pozorování.

Co přesně seznam signálů vrací

/v1/incidents je GET endpoint katalogu služeb se zvýšenými signály narušení. Mezi jeho parametry patří filtry podle služby, regionu, kategorie, vyhledávacího dotazu a časového okna. Odpověď vyžaduje licenci; API popisuje autorizaci pomocí tokenu Bearer. Pole regionu přijímá dvoupísmenný kód a hours určuje časové okno od 1 do 2160 hodin.

Slovo „incident“ v cestě lze snadno chápat jako „potvrzenou havárii“, dokumentace mu však přisuzuje užší význam: čerstvý signál z pozorování. Upozornění proto formulujte podle údajů v odpovědi, například „obdržen signál o narušení dostupnosti“, a nepřipisujte poskytovateli služby potvrzení incidentu.

Minimální kontrola před upozorněním

Nejprve uložte původní odpověď spolu s časem přijetí a parametry dotazu. Poté ověřte, která služba a region se vrátily, a posuďte aktuálnost podle polí služby observed_at a stale. Pokud je pozorování označeno jako zastaralé, oddělte ho od aktuálního signálu a nezobrazujte ho jako stav „právě teď“.

curl -sS 'https://api.uptimescout.com/v1/incidents?region=US&hours=24' \
  -H "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY"

Jde o příklad dotazu pro USA s časovým oknem 24 hodin; klíč se načítá z proměnné prostředí a nezobrazuje se v příkazovém řádku. Po obdržení odpovědi zkontrolujte chyby HTTP a strukturu JSON, poté zpracujte každou vrácenou službu zvlášť. Hodnoty stavu ve schématu zahrnují operational, degraded, outage a unknown; pokud pole nebo hodnota chybí, nedoplňujte vlastní interpretaci.

U signálu, který vyžaduje zásah, si vyžádejte aktuální stav příslušné služby přes /v1/status a historii přes /v1/history. V historii je užitečné ukládat spolu s časovými řadami také resolution_seconds, samples, counts a effective_start: analytik tak vidí časové rozlišení použitých dat i skutečný interval, za který jsou dostupná. Specifikace upozorňuje, že chybějící intervaly nejsou známy; prázdnou mezeru nelze automaticky považovat ani za dostupnost, ani za výpadek.

Jak z odpovědi vytvořit ověřitelnou zprávu

Pro každý záznam uložte tato pole: identifikátor a název služby, region dotazu, stav, čas pozorování, příznak zastarání, čas přijetí odpovědi a odkaz na zdroj oficiálního stavu, pokud jej tým ověřil. Poslední pole doplňuje vaše integrace nebo operátor: specifikace UptimeScout neslibuje, že signál obsahuje potvrzenou příčinu nebo vyjádření poskytovatele.

Článek: Jak číst UptimeScout incidents: signál výpadku ještě není potvrzený incident
Shrnutí: API UptimeScout může vrátit seznam služeb se zvýšenými signály narušení. Ukazujeme, jak o něj požádat a ověřit aktuálnost dat, aniž by se signál z pozorování vydával za zprávu o oficiálním výpadku.
Role obrázku: doprovodná ilustrace 2 — jiný konkrétní aspekt
Sekce: Jak z odpovědi vytvořit ověřitelnou zprávu
Vizuální motiv: Redakční infografika v ruštině znázorňující jednoduchý třístupňový proces
Od signálu k ověřenému závěru© jsonscraper · ilustrace vytvořená AI

Pracovní postup rozdělte do tří stavů. „Signál přijat“ znamená, že se záznam objevil ve výsledku /v1/incidents. „Probíhá ověření stavu“ znamená, že jste si vyžádali aktuální stav a historii. Stav „potvrzeno“ ponechte pro závěr podložený oficiálním externím sdělením nebo interním ověřením. Toto jednoduché rozdělení zabrání tomu, aby dashboard vydával agregovaný signál za prokázanou skutečnost.

Pokud tým vytváří zprávu pro několik regionů, provádějte samostatné dotazy s příslušnými kódy regionů a ukládejte parametr spolu s výsledkem. Pole lang se týká jazyka popisů služeb; region pozorování nemění. Toto rozlišení je důležité například při porovnávání lokalizovaného katalogu a regionálního stavu.

Kde končí závěr

Ověřitelným výsledkem tohoto postupu je protokol signálů s výslovně uvedenými časovými údaji, regionem a aktuálností, doplněný samostatným ověřením stavu a historie. Pomáhá zjistit, čemu je třeba věnovat pozornost a co se podařilo ověřit z vybraných zdrojů. Samotná odpověď /v1/incidents informuje o zvýšeném signálu z pozorování; k vyhlášení potvrzeného výpadku jsou zapotřebí podpůrné údaje.

Lidé

Pro tento článek zatím nejsou uvedeni žádní lidé.

Pokračujte ve čteníПроверка регионального сигнала: как сопоставить статус сервиса с историей UptimeScout
Přečtěte si další článek

Proměňte přečtené ve funkční integraci

Prozkoumejte API sociálních dat jsonscraper, testujte požadavky a sestavte další workflow.

Prozkoumat API