Para comprobar si una sospecha de interrupción coincide con las observaciones de una región concreta, solicite el estado del servicio y el historial del período elegido. Compare la región y las marcas de tiempo con los registros de la aplicación. El resultado responde a una pregunta concreta: si hay una señal regional registrada en los datos almacenados y qué tan reciente es la entrada correspondiente.
La especificación de UptimeScout describe métodos distintos para el estado y el historial. En la respuesta de estado, el campo de nivel superior `status` indica el resultado de la solicitud a la API; la señal del servicio aparece en `service.status`. El historial contiene intervalos de tiempo agregados, la resolución y el número de muestras. Estos datos son útiles para el diagnóstico inicial y como anexo a un informe de incidente.
1. Prepare el servicio, la región y la licencia
El ejemplo siguiente utiliza el ID de servicio `github` y la región `US`. Para su comprobación, use un ID válido del catálogo de UptimeScout y el código de la región donde se observó el problema. Las regiones disponibles pueden variar según el servicio; antes de interpretar los resultados, compruebe `available_regions` en la respuesta.

Instale Python 3.10 o posterior y el SDK siguiendo las instrucciones del proyecto. Defina la clave en la variable de entorno `UPTIMESCOUT_LICENSE_KEY` y no la incluya en el código ni en los registros. El ejemplo realiza dos solicitudes con el cliente documentado, conserva las respuestas JSON originales en memoria y las imprime para revisarlas. Es un ejemplo de integración, no un informe de una prueba realizada aquí.
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,
))
El SDK de Python de UptimeScout documenta el cliente, los métodos `status` y `history`, y la autenticación Bearer que gestiona internamente. Para la instalación y las versiones, siga las instrucciones actuales del repositorio; el fragmento mostrado presupone que el SDK ya está instalado.
2. Asegúrese de leer la señal, no el estado de la solicitud
En la respuesta, compruebe los campos `service.status`, `service.observed_at`, `service.stale` y la región indicada. El `status` de nivel superior se refiere al éxito de la solicitud a la API, no a la disponibilidad del servicio. Guarde también la hora de la solicitud, el ID del servicio y los parámetros de región: así quedará claro a qué registro corresponde la conclusión.
Si la observación está marcada como reciente y `service.status` indica degradación o interrupción, regístrela como una señal regional y compárela con sus propios registros, errores de conexión y comprobaciones de la aplicación. El campo `stale` indica si la observación almacenada ha superado el período de vigencia establecido. Si su valor es `true` o falta un campo necesario, indique que la disponibilidad actual es desconocida según esta respuesta; no convierta un registro obsoleto o incompleto en una conclusión sobre el estado actual.
UptimeScout describe estos datos como señales regionales almacenadas: sirven de referencia para el diagnóstico, pero no son una medición directa del tiempo de actividad ni una confirmación de una interrupción global. Por eso, formule el resultado con precisión: «se encontró una señal de este tipo para la región, registrada a la hora indicada». La comparación con sus propias comprobaciones permitirá determinar si esta señal externa coincide con la experiencia de los usuarios de su aplicación.
3. Contraste el historial y la resolución de los intervalos
El método de historial devuelve agregados temporales. En la respuesta, compruebe `resolution_seconds`, `samples`, `counts` y `effective_start`; guarde también los límites temporales efectivos de los intervalos. La documentación describe un alineamiento en UTC: intervalos de tres minutos para ventanas de hasta una hora, de cinco minutos para ventanas de hasta tres horas, de una hora para ventanas de hasta un día y diarios para períodos más largos. Los agregados antiguos almacenados pueden conservar una resolución declarada más gruesa.

Por eso, elija la ventana en función de lo que quiera averiguar. Para un incidente breve, utilice un intervalo corto apropiado y muestre la resolución junto con el resultado. Para un período largo, indique que el historial puede estar agregado por días: un punto diario no permite reconstruir la evolución minuto a minuto.
Los intervalos ausentes representan datos desconocidos, no prueban que el servicio funcionara con normalidad. Conserve el número de muestras y los límites de los intervalos junto a los valores agregados. Esto ayuda a entender qué tan completo es el historial para el período analizado y en qué datos se basa la conclusión.
4. Prepare un registro del incidente que pueda verificarse
Para el informe, basta con guardar las respuestas originales y los campos normalizados: servicio, región, hora de la solicitud, `service.status`, `observed_at`, `stale`, ventana del historial seleccionada, `resolution_seconds`, número de muestras y `effective_start`. Si falta un valor, déjelo como ausente: cero y ausencia de datos tienen significados distintos.
A continuación, contraste esta información con las comprobaciones internas del mismo período: códigos de respuesta, errores de conexión, región de alojamiento y marcas de tiempo. Si los datos no coinciden, conserve ambas versiones. Una observación regional de UptimeScout y una comprobación de un endpoint concreto describen puntos de observación distintos; por tanto, una discrepancia requiere investigación, no elegir la respuesta más conveniente.
Si se produce un error de la API, guíese por el código HTTP: la especificación enumera parámetros incorrectos, licencia ausente, licencia no válida, cuota excedida y falta de disponibilidad temporal. Corrija la causa correspondiente. Un error de solicitud no es el estado del servicio que se está comprobando.
Qué comunicar a la persona de guardia
En el resumen, indique el servicio, la región, la hora de observación, la vigencia del registro y la resolución del historial. Marque por separado los intervalos sin datos como desconocidos y adjunte los registros internos del mismo período. Así, el equipo dispondrá de una señal regional verificable sin confundir el estado de la solicitud a la API, las observaciones de UptimeScout y las mediciones propias de la aplicación.