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

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