# UptimeScout: jak sprawdzić, czy w regionie użytkownika wystąpiła awaria usługi

https://jsonscraper.com/cs/blog/uptimescout-sprawdzanie-awarii-uslugi-region

Author: Michael Johnson

Published: 2026-11-20T11:35:57+00:00

Updated: 2026-11-20T11:35:57+00:00

Praktyczny przykład: zbierz historię obserwacji z regionu i odróżnij świeży sygnał od nieznanego przedziału

Gdy użytkownicy w jednym kraju zgłaszają problemy, a zespół widzi, że usługa działa normalnie, najlepiej sprawdzić obserwacje z ich regionu. API UptimeScout pozwala pobrać historię wybranej usługi według kodu regionu i otrzymać przedziały wraz z liczbą pomiarów. Wynikiem jest weryfikowalna tabela przydatna przy analizie zgłoszenia: czas przedziału, rozdzielczość, rozkład sygnałów i liczba próbek.



![Artykuł: UptimeScout: jak sprawdzić, czy w regionie użytkownika wystąpiła awaria usługi
Podsumowanie: Regionalne sprawdzenie dostępności może pomóc ustalić, czy problem zgłoszony przez użytkownika pokrywał się z obserwacjami UptimeScout. Pokazujemy powtarzalny proces: wybierz usługę i region, pobierz historię, sprawdź aktualność i rozdzielczość danych, a następnie zachowaj wynik wraz z pierwotną odpowiedzią.
Rola obrazu: okładka — główna idea
Sekcja: 
Temat wizualny: Redakcyjne zdjęcie złożonej regionalnej mapy awarii](https://jsonscraper.com/assets/uploads/journal/2026/11/1cd4023e50fafa3c2411a7c5fc1a0f4b.png.hero.webp)

Region i przedział czasu wyznaczają granice sprawdzania dostępności.© jsonscraper · wygenerowano przy użyciu AI

 

Praktyczny scenariusz to diagnozowanie domniemanej awarii regionalnej. Dane wejściowe: identyfikator usługi z katalogu UptimeScout, kod regionu, na przykład US lub GB, oraz przedział historii. Wynik pomaga porównać czas zgłoszenia użytkownika z obserwacjami usługi. Samo API opisuje dane jako sygnały obserwowanej dostępności; sprawdzenie usługi pomaga zawęzić problem, ale nie zastępuje własnych testów aplikacji.

 

## Najpierw potwierdź usługę i region

 

Zacznij od katalogu: znajdź właściwą usługę po nazwie lub za pomocą wyszukiwarki, a następnie zapisz jej dokładny identyfikator. Specyfikacja [UptimeScout OpenAPI](https://uptimescout.com/openapi.json) opisuje wyszukiwanie przez GET /v1/services oraz parametry q, service, region, limit i offset. W raporcie diagnostycznym najlepiej przechowywać identyfikator, a nie tylko wyświetlaną nazwę, aby kolejne zapytanie dotyczyło tego samego elementu katalogu.

 

Region określa się osobnym, dwuliterowym kodem. Należy zapisać go razem z wynikiem: odpowiedź dla US i odpowiedź bez filtra regionalnego dotyczą różnych kwestii. Jeśli opis ma być wyświetlany po polsku, parametr lang=pl steruje lokalizacją opisu, a parametr region wybiera obserwacje. Dokumentacja wyraźnie rozdziela te dwa zastosowania.

 

## Pobierz historię, a nie tylko pojedynczy status

 

Do analizy incydentu użyj /v1/history z wymaganym parametrem service i wybranym region. Parametr hours określa przedział historii; specyfikacja dopuszcza wartości od 1 do 2160 godzin. Zapytanie obsługuje także parametr lang. Zgodnie z OpenAPI autoryzacja odbywa się za pomocą licencji w schemacie Bearer. W praktyce przechowuj klucz w zmiennej środowiskowej i nie zapisuj go w dzienniku zapytań.

 

```
import os
import requests

response = requests.get(
    "https://api.uptimescout.com/v1/history",
    headers={"Authorization": f"Bearer {os.environ['UPTIMESCOUT_LICENSE_KEY']}"},
    params={"service": "github", "region": "GB", "hours": 24, "lang": "ru"},
    timeout=30,
)
response.raise_for_status()
data = response.json()
print(data)
```

 

To minimalny przykład zapytania, a nie opublikowany wynik rzeczywistego dochodzenia. Identyfikator github i region GB podano jako przykładowe parametry: przed użyciem wybierz usługę i region odpowiednie do danego zadania. Warto zachować całą odpowiedź w formacie JSON, dodając czas pobrania i opis zapytania w osobnych polach systemu audytowego. Dzięki temu można powtórzyć analizę i sprawdzić, jaki konkretnie zrzut danych został wykorzystany.

 

## Rozdzielczość i braki są częścią wyniku

 

W tablicy history istotne są pola observed_at, resolution_seconds, aggregated, samples i counts. Rozdzielczość informuje o długości przedziału, samples pokazuje liczbę obserwacji uwzględnionych w agregacie, a counts zawiera rozkład sygnałów. Analizuj je łącznie: pojedynczy wiersz z małą liczbą próbek ma inną wagę niż agregat obejmujący wiele obserwacji.



![Artykuł: UptimeScout: jak sprawdzić, czy w regionie użytkownika wystąpiła awaria usługi
Podsumowanie: Regionalne sprawdzenie dostępności może pomóc ustalić, czy problem zgłoszony przez użytkownika pokrywał się z obserwacjami UptimeScout. Pokazujemy powtarzalny proces: wybierz usługę i region, pobierz historię, sprawdź aktualność i rozdzielczość danych, a następnie zachowaj wynik wraz z pierwotną odpowiedzią.
Rola obrazu: ilustracja uzupełniająca 2 — inny konkretny aspekt
Sekcja: Rozdzielczość i braki są częścią wyniku](https://jsonscraper.com/assets/uploads/journal/2026/11/a171063a93107bb525c54a0ee477e61a.png.hero.webp)

Jak czytać historię: region, przedziały czasowe, rozdzielczość i braki.© jsonscraper · ilustracja wygenerowana przez AI

 

UptimeScout opisuje historię jako przedziały czasowe o różnym kroku, zależnym od wybranego okresu: minutowe i pięciominutowe dla krótkich okresów, godzinowe dla jednej doby oraz dobowe dla dłuższych okresów. Zachowane starsze agregaty mogą mieć mniejszą rozdzielczość. Dlatego nie wyciągaj wniosku „awaria zaczęła się dokładnie w tej minucie”, jeśli wiersz przedstawia agregat godzinowy lub dobowy. Sprawdź rzeczywistą wartość resolution_seconds oraz pola effective_start i history_resolution w odpowiedzi, aby określić granice tego, co można stwierdzić.

 

Brakujący przedział należy traktować jako nieznany. Specyfikacja wyraźnie zaleca traktowanie luk jako nieznanych przedziałów: pusta przestrzeń w historii sama w sobie nie oznacza ani prawidłowego działania, ani awarii. Ta prosta zasada zapobiega błędnemu uzupełnianiu luk zielonym statusem lub zerami w raporcie.

 

## Porównaj historię z bieżącym sygnałem

 

Jeśli chcesz sprawdzić stan w chwili zgłoszenia, pobierz /v1/status dla tej samej wartości service i region. W obiekcie usługi sprawdź łącznie status, observed_at i stale; dokumentacja przedstawia te pola jako sposób oceny stanu i aktualności sygnału. Status najwyższego poziomu odnosi się do wyniku zapytania API, podczas gdy service.status opisuje sygnał dostępności konkretnej usługi. To rozróżnienie jest szczególnie przydatne w raportach automatycznych: poprawna odpowiedź HTTP i stan usługi zewnętrznej to dwie różne rzeczy.

 

W przypadku wielu zależności możesz przejść do /v1/statuses, a następnie pobrać historię tylko dla usług i regionów, w których wystąpiła anomalia. Specyfikacja udostępnia również /v1/summary i /v1/incidents. Przy diagnozowaniu tego ostatniego endpointu pamiętaj o jego dokładnym przeznaczeniu: zwraca świeże sygnały o podwyższonym poziomie zakłóceń, a nie potwierdzone incydenty samego dostawcy. Wynik jest więc podstawą do weryfikacji, a nie gotowym rozstrzygnięciem przyczyny.

 

## Jak sformułować wniosek bez zgadywania

 

Zapisz w wierszu raportu identyfikator service, region, okres zapytania, observed_at, resolution_seconds, samples, counts oraz informację o brakach. Link do zgłoszenia lub wewnętrznego incydentu dodaj osobno, poza polami API. Następnie porównaj zakres czasu z logami aplikacji, śladami regionalnymi i relacją użytkownika. Jeśli przedział agregatu jest szerszy niż czas trwania incydentu, odpowiednio sformułuj wniosek: obserwacje dla wybranego regionu i zadanego okresu zawierają określone sygnały, z podaną rozdzielczością i liczbą próbek.

 

Taka analiza pomaga osobie pełniącej dyżur zdecydować, czy sprawdzić regionalną stronę usługi zewnętrznej, czy kontynuować diagnozowanie własnej aplikacji i sieci użytkownika. Możliwość odtworzenia analizy zależy od zachowania parametrów zapytania i pierwotnego JSON-a, a jakość wniosków dotyczących czasu — od jawnego uwzględnienia rozdzielczości, liczby próbek i nieznanych przedziałów. W przypadku dostępności to właśnie jest praktyczny rezultat: nie tylko bieżąca etykieta statusu, lecz zapis ograniczony do regionu i czasu, który współpracownik może zweryfikować.
