jsonscraper
Mercados
Volver al diario

UptimeScout: cómo comprobar si hubo una interrupción del servicio en la región del usuario

Un caso práctico: recopilar el historial de observaciones de una región y distinguir una señal reciente de un intervalo desconocido

Política editorial Informar de un error

Cuando usuarios de un país informan de problemas, pero el equipo ve que el servicio funciona con normalidad, lo más útil es comprobar las observaciones de su región. La API de UptimeScout permite solicitar el historial de un servicio seleccionado mediante un código regional y obtener intervalos junto con el número de mediciones. El resultado es una tabla verificable para analizar la incidencia: hora del intervalo, resolución, distribución de señales y número de muestras.

Artículo: UptimeScout: cómo comprobar si hubo una interrupción del servicio en la región del usuario
Resumen: Una comprobación regional de disponibilidad puede responder si el incidente del usuario coincidió con las observaciones de UptimeScout. Mostramos un proceso reproducible: elegir un servicio y una región, solicitar el historial, comprobar la actualidad y la resolución de los datos y, después, guardar el resultado junto con la respuesta original.
Función de la imagen: portada: la idea central
Sección: 
Tema visual: fotografía editorial de una interrupción regional plegada
La región y el intervalo temporal delimitan la comprobación de disponibilidad.© jsonscraper · creado con IA

El caso práctico es el diagnóstico de una posible interrupción regional. Datos de entrada: el identificador del servicio en el catálogo de UptimeScout, un código de región como US o GB y un intervalo del historial. El resultado ayuda a comparar la hora del aviso del usuario con las observaciones del servicio. La API describe los datos como señales de disponibilidad observada; la comprobación del servicio ayuda a localizar el problema, pero no sustituye las comprobaciones propias de la aplicación.

Primero, confirme el servicio y la región

Empiece por el catálogo: busque el servicio por nombre o mediante la búsqueda y, a continuación, anote su ID exacto. La especificación OpenAPI de UptimeScout describe la búsqueda mediante GET /v1/services y los parámetros q, service, region, limit y offset. Para un informe de diagnóstico, conviene guardar el ID y no solo el nombre visible: así, una nueva solicitud se dirigirá al mismo elemento del catálogo.

La región se especifica con un código independiente de dos letras. Es importante guardarla junto con el resultado: una respuesta para US y otra sin filtro regional responden a preguntas diferentes. Si quiere mostrar la descripción en español, el parámetro lang=es controla la localización de la descripción, mientras que el parámetro region selecciona las observaciones. La documentación distingue explícitamente ambas funciones.

Solicite el historial en vez de un único estado

Para analizar una incidencia, utilice /v1/history con el parámetro obligatorio service y la region elegida. El parámetro hours define el intervalo del historial; la especificación admite valores de 1 a 2160 horas. La solicitud también incluye lang. Según OpenAPI, la autorización se proporciona con una licencia mediante el esquema Bearer. En una ejecución práctica, guarde la clave en una variable de entorno y no la escriba en el registro de solicitudes.

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)

Este es un ejemplo mínimo de solicitud, no el resultado publicado de una investigación real. El identificador github y la región GB se incluyen como parámetros de ejemplo: antes de aplicarlo, elija el servicio y la región pertinentes para su caso. Conviene guardar la respuesta completa en formato JSON y añadir la hora de recepción y la descripción de la solicitud en campos separados de su sistema de auditoría. Así podrá repetir el análisis y saber qué instantánea de datos se utilizó.

La resolución y los intervalos ausentes también forman parte del resultado

En el arreglo history, son importantes los campos observed_at, resolution_seconds, aggregated, samples y counts. La resolución indica la duración del intervalo temporal; samples muestra cuántas observaciones se incluyeron en el agregado, y counts contiene la distribución de señales. Analícelos en conjunto: una fila con pocas muestras tiene un peso distinto en el análisis que un agregado con muchas observaciones.

Artículo: UptimeScout: cómo comprobar si hubo una interrupción del servicio en la región del usuario
Resumen: Una comprobación regional de disponibilidad puede responder si el incidente del usuario coincidió con las observaciones de UptimeScout. Mostramos un proceso reproducible: elegir un servicio y una región, solicitar el historial, comprobar la actualidad y la resolución de los datos y, después, guardar el resultado junto con la respuesta original.
Función de la imagen: ilustración complementaria 2: un aspecto específico diferente
Sección: La resolución y los intervalos ausentes también forman parte del resultado
Cómo leer el historial: región, intervalos temporales, resolución y datos ausentes.© jsonscraper · ilustración generada por IA

UptimeScout describe el historial como intervalos temporales con una granularidad que varía según el periodo seleccionado: intervalos de un minuto y cinco minutos para periodos cortos, horarios para un día y diarios para periodos largos. Los agregados antiguos conservados pueden tener una resolución más gruesa. Por eso, no concluya que «la interrupción empezó exactamente en este minuto» si la fila representa un agregado horario o diario. Use el valor efectivo de resolution_seconds y los campos effective_start y history_resolution de la respuesta para delimitar lo que permiten concluir los datos.

Interprete un intervalo ausente como desconocido. La especificación indica expresamente que los intervalos ausentes deben tratarse como desconocidos: un hueco en el historial no representa por sí solo ni funcionamiento normal ni una interrupción. En un informe, esta sencilla regla evita rellenar falsamente los huecos con un estado «verde» o con ceros.

Compare el historial con la señal actual

Si necesita comprobar el estado en el momento del aviso, solicite /v1/status para el mismo service y region. En el objeto del servicio, revise conjuntamente status, observed_at y stale; la documentación presenta estos campos como una forma de conocer el estado y la actualidad de la señal. El estado de nivel superior corresponde al resultado de la solicitud a la API, mientras que service.status describe la señal de disponibilidad de un servicio concreto. Esta distinción es especialmente útil en informes automatizados: una respuesta HTTP satisfactoria y el estado de un servicio externo son cosas distintas.

Para varias dependencias, puede pasar a /v1/statuses y usar después el historial solo para los servicios y regiones en los que se detecte una anomalía. La especificación también ofrece /v1/summary y /v1/incidents. Para diagnosticar esta última ruta, tenga en cuenta su función exacta: el endpoint devuelve señales recientes y elevadas de interrupciones, no incidencias confirmadas por el propio proveedor. Por tanto, el resultado sirve como motivo para contrastar la información, no como conclusión definitiva sobre la causa.

Cómo redactar las conclusiones sin especular

Guarde en cada fila del informe el ID del servicio, la región, el periodo de la solicitud, observed_at, resolution_seconds, samples, counts y una marca que indique si hay intervalos ausentes. Añada el enlace al aviso o a la incidencia interna en un campo aparte de los datos de la API. Después, compare el intervalo temporal con los registros de la aplicación, las trazas regionales y el mensaje del usuario. Si los límites temporales del agregado abarcan un periodo mayor que el de la incidencia, formule la conclusión en consecuencia: las observaciones de la región elegida durante el intervalo indicado contienen estas señales, con esta resolución y este número de muestras.

Este análisis ofrece al equipo de guardia una vía práctica: comprobar el lado regional del servicio externo o continuar diagnosticando la aplicación propia y la red del usuario. Su reproducibilidad depende de conservar los parámetros de la solicitud y el JSON original; la calidad de las conclusiones temporales, de tener en cuenta explícitamente la resolución, samples y los intervalos desconocidos. En un caso de disponibilidad, ese es el resultado práctico: no solo una etiqueta de estado actual, sino un registro delimitado por región y tiempo que otra persona del equipo pueda verificar.

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