Чтобы проверить, совпадает ли подозрение на сбой с наблюдениями в конкретном регионе, запросите статус сервиса и историю за выбранное окно. Сопоставьте регион и временные отметки с логами приложения. Результат отвечает на конкретный вопрос: зарегистрирован ли региональный сигнал в сохранённых данных и насколько свежа соответствующая запись.
Спецификация UptimeScout описывает отдельные методы статуса и истории. В ответе статуса верхнеуровневое поле `status` сообщает результат API-запроса; сигнал сервиса находится в `service.status`. История содержит агрегированные временные интервалы, разрешение и число выборок. Это полезные данные для первичной диагностики и приложения к отчёту об инциденте.
1. Подготовьте сервис, регион и лицензию
В примере ниже используются идентификатор сервиса `github` и регион `US`. Для своей проверки возьмите действительный ID из каталога UptimeScout и код региона, где наблюдалась проблема. Набор доступных регионов может различаться по сервисам; перед интерпретацией проверьте `available_regions` в ответе.

Установите Python 3.10+ и SDK по инструкции проекта. Укажите ключ в переменной окружения `UPTIMESCOUT_LICENSE_KEY` и не помещайте его в код или журналы. Пример выполняет два запроса через документированный клиент, сохраняет исходные JSON-ответы в памяти и печатает их для проверки. Это пример интеграции, а не отчёт о выполненном здесь тесте.
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,
))
Официальный Python SDK UptimeScout документирует клиент, методы `status` и `history`, а также Bearer-аутентификацию под капотом. Для установки и версий следуйте текущим инструкциям репозитория; показанный фрагмент предполагает установленный SDK.
2. Убедитесь, что читаете сигнал, а не статус запроса
В ответе проверьте поля `service.status`, `service.observed_at`, `service.stale` и регион ответа. Верхнеуровневый `status` относится к успешности запроса API, а не к доступности самого сервиса. Сохраните также время запроса, ID сервиса и параметры региона: так будет понятно, к какой записи относится вывод.
Если наблюдение помечено как свежее и `service.status` указывает на деградацию или отказ, зафиксируйте это как региональный сигнал и сравните с собственными журналами, ошибками соединения и проверками приложения. Поле `stale` показывает, вышло ли сохранённое наблюдение за установленное окно свежести. Если оно равно `true` или необходимого поля нет, обозначьте текущую доступность как неизвестную по этому ответу; не превращайте устаревшую или неполную запись в вывод о состоянии сейчас.
UptimeScout описывает данные как сохранённые региональные сигналы: это ориентир для диагностики, а не прямое измерение аптайма и не подтверждение глобального сбоя. Поэтому формулируйте результат точно: «для региона найден сигнал такого-то типа, записанный в указанное время». Сверка с собственными проверками покажет, согласуется ли этот внешний сигнал с опытом пользователей вашего приложения.
3. Сверьте историю и разрешение интервалов
Метод истории возвращает временные агрегаты. В ответе проверьте `resolution_seconds`, `samples`, `counts` и `effective_start`; также сохраните фактические временные границы интервалов. Документация описывает выравнивание по UTC: трёхминутные интервалы для окон до часа, пятиминутные — до трёх часов, часовые — до суток и дневные — для более длинных окон. У сохранённых старых агрегатов может оставаться более грубое заявленное разрешение.

Поэтому выбирайте окно в соответствии с вопросом. Для короткого инцидента используйте подходящий короткий диапазон и показывайте разрешение рядом с результатом. Для длинного периода укажите, что история может быть агрегирована по дням: дневная точка не позволяет восстановить поминутную динамику.
Пропущенные интервалы — неизвестные данные, а не свидетельство нормальной работы. Сохраняйте число выборок и границы интервалов рядом с агрегированными значениями. Это помогает понять, насколько полно история покрывает исследуемый период и на каких данных основан вывод.
4. Подготовьте проверяемую запись об инциденте
Для отчёта достаточно сохранить исходные ответы и нормализованные поля: сервис, регион, время запроса, `service.status`, `observed_at`, `stale`, выбранное окно истории, `resolution_seconds`, число выборок и `effective_start`. Отсутствующее значение оставляйте отсутствующим: ноль и отсутствие данных имеют разный смысл.
Затем сопоставьте эти сведения с внутренними проверками за тот же период: кодами ответов, ошибками соединения, регионом размещения и временными метками. Если данные расходятся, сохраните обе стороны. Региональное наблюдение UptimeScout и проверка конкретного endpoint описывают разные точки наблюдения, поэтому расхождение само по себе требует проверки, а не выбора удобного ответа.
При ошибке API ориентируйтесь на HTTP-код: спецификация перечисляет неверные параметры, отсутствие лицензии, недействительную лицензию, превышение квоты и временную недоступность. Исправьте соответствующую причину. Ошибка запроса не является статусом проверяемого сервиса.
Что передать дежурному
В кратком выводе укажите сервис, регион, время наблюдения, свежесть записи и разрешение истории. Отдельно пометьте интервалы без данных как неизвестные и приложите внутренние журналы за совпадающий период. Так команда получит проверяемый региональный сигнал, не смешивая состояние API-запроса, наблюдения UptimeScout и собственные измерения приложения.