jsonscraper
Mercados
Volver al diario

Comprobar una señal regional: cómo contrastar el estado del servicio con el historial de UptimeScout

Solicite una observación regional y un historial, compruebe la hora y la vigencia, y luego contraste los datos con los registros de la aplicación.

Política editorial Informar de un error

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.

Artículo: Comprobar una señal regional: cómo contrastar el estado del servicio con el historial de UptimeScout
Resumen: Diagnóstico paso a paso de una señal regional de UptimeScout: consulta mediante el SDK de Python, revisión de los campos `service.status`, `observed_at` y `stale`, y contraste posterior del historial y su resolución.
Función de la imagen: portada: la idea central
Sección: 1. Prepare el servicio, la región y la licencia
Tema visual: Ilustración fotográfica editorial, vista cercana de una hoja de respuesta a incidentes sobre una mesa: un mapa regional de EE. UU. junto a dos n
La región del mapa se contrasta con las marcas de tiempo y los vacíos en el historial de observaciones.© jsonscraper · generado con IA

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.

Artículo: Comprobar una señal regional: cómo contrastar el estado del servicio con el historial de UptimeScout
Resumen: Diagnóstico paso a paso de una señal regional de UptimeScout: consulta mediante el SDK de Python, revisión de los campos `service.status`, `observed_at` y `stale`, y contraste posterior del historial y su resolución.
Función de la imagen: ilustración complementaria 2: un aspecto específico distinto
Sección: 3. Contraste el historial y la resolución de los intervalos
Tema visual: Infografía editorial limpia sobre fondo claro, cuatro paneles secuenciales que muestran
Campos de la respuesta y pasos para comprobar la señal regional y el historial.© jsonscraper · ilustración generada con IA

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.

Gente

Aún no hay personas en la lista para este artículo.

Sigue leyendoCómo leer UptimeScout incidents: una señal de fallo aún no es un incidente confirmado
Lee el siguiente artículo

Convierte lo que lees en una integración funcional

Explora las API de datos sociales de jsonscraper, prueba solicitudes y crea tu próximo flujo de trabajo.

Explorar APIs