jsonscraper
Marchés
Retour au journal

Vérifier un signal régional : comparer le statut d’un service à l’historique UptimeScout

Demandez les observations et l’historique d’une région, vérifiez l’heure et la fraîcheur, puis comparez-les aux journaux de l’application.

Politique éditoriale Signaler une erreur

Pour vérifier si un soupçon de panne correspond aux observations d’une région donnée, demandez le statut du service et son historique sur la période choisie. Comparez la région et les horodatages aux journaux de l’application. Le résultat répond à une question précise : un signal régional figure-t-il dans les données conservées, et à quel point l’enregistrement correspondant est-il récent ?

La spécification d’UptimeScout décrit des méthodes distinctes pour le statut et l’historique. Dans la réponse de statut, le champ de premier niveau `status` indique le résultat de la requête API ; le signal du service se trouve dans `service.status`. L’historique contient des intervalles temporels agrégés, une résolution et un nombre d’échantillons. Ces données sont utiles pour un premier diagnostic et pour compléter un rapport d’incident.

1. Préparez le service, la région et la licence

L’exemple ci-dessous utilise l’identifiant de service `github` et la région `US`. Pour votre vérification, choisissez un ID valide dans le catalogue UptimeScout et le code de la région où le problème a été observé. Les régions disponibles peuvent varier selon les services ; avant d’interpréter les résultats, vérifiez `available_regions` dans la réponse.

Article : Vérifier un signal régional : comparer le statut d’un service à l’historique UptimeScout
Résumé : Diagnostic pas à pas d’un signal régional UptimeScout : requête avec le SDK Python, vérification des champs `service.status`, `observed_at` et `stale`, puis examen de l’historique et de sa résolution.
Rôle de l’image : couverture — idée centrale
Section : 1. Préparez le service, la région et la licence
Sujet visuel : Illustration photographique éditoriale, vue rapprochée d’une fiche de réponse à incident posée sur une table : une carte régionale des États-Unis à côté de deux n
La région sur la carte est comparée aux horodatages et aux lacunes dans l’historique des observations.© jsonscraper · créé avec l’IA

Installez Python 3.10 ou une version ultérieure, ainsi que le SDK, en suivant les instructions du projet. Définissez la clé dans la variable d’environnement `UPTIMESCOUT_LICENSE_KEY` et ne l’insérez ni dans le code ni dans les journaux. L’exemple effectue deux requêtes avec le client documenté, conserve les réponses JSON brutes en mémoire et les affiche pour vérification. Il s’agit d’un exemple d’intégration, pas du compte rendu d’un test effectué ici.

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,
))

Le SDK Python officiel d’UptimeScout documente le client, les méthodes `status` et `history`, ainsi que l’authentification Bearer gérée en interne. Pour l’installation et les versions, suivez les instructions actuelles du dépôt ; l’extrait présenté suppose que le SDK est déjà installé.

2. Vérifiez que vous lisez le signal, et non le statut de la requête

Dans la réponse, vérifiez les champs `service.status`, `service.observed_at`, `service.stale` et la région indiquée. Le champ de premier niveau `status` concerne la réussite de la requête API, pas la disponibilité du service lui-même. Conservez aussi l’heure de la requête, l’ID du service et les paramètres de région afin de savoir à quel enregistrement se rapporte votre conclusion.

Si l’observation est marquée comme récente et que `service.status` indique une dégradation ou une panne, consignez-le comme un signal régional et comparez-le à vos journaux, aux erreurs de connexion et aux contrôles de l’application. Le champ `stale` indique si l’observation conservée dépasse la fenêtre de fraîcheur définie. S’il vaut `true` ou si le champ nécessaire est absent, considérez la disponibilité actuelle comme inconnue au vu de cette réponse ; ne concluez pas sur l’état présent à partir d’un enregistrement obsolète ou incomplet.

UptimeScout décrit ces données comme des signaux régionaux conservés : elles servent de repère pour le diagnostic, mais ne constituent ni une mesure directe de la disponibilité ni une confirmation d’une panne globale. Formulez donc le résultat avec précision : « un signal de ce type a été trouvé pour cette région, enregistré à l’heure indiquée ». La comparaison avec vos propres contrôles permettra de déterminer si ce signal externe concorde avec l’expérience des utilisateurs de votre application.

3. Comparez l’historique et la résolution des intervalles

La méthode d’historique renvoie des agrégats temporels. Dans la réponse, vérifiez `resolution_seconds`, `samples`, `counts` et `effective_start` ; conservez également les limites temporelles réelles des intervalles. La documentation décrit un alignement sur UTC : des intervalles de trois minutes pour les fenêtres allant jusqu’à une heure, de cinq minutes jusqu’à trois heures, d’une heure jusqu’à un jour, puis d’un jour pour les fenêtres plus longues. Les anciens agrégats conservés peuvent garder une résolution déclarée plus grossière.

Article : Vérifier un signal régional : comparer le statut d’un service à l’historique UptimeScout
Résumé : Diagnostic pas à pas d’un signal régional UptimeScout : requête avec le SDK Python, vérification des champs `service.status`, `observed_at` et `stale`, puis examen de l’historique et de sa résolution.
Rôle de l’image : illustration complémentaire 2 — un aspect spécifique différent
Section : 3. Comparez l’historique et la résolution des intervalles
Sujet visuel : Infographie éditoriale épurée sur fond clair, quatre panneaux successifs illustrant
Les champs de la réponse et l’ordre des vérifications du signal régional et de l’historique.© jsonscraper · illustration générée par l’IA

Choisissez donc une fenêtre adaptée à votre question. Pour un incident bref, utilisez une plage courte appropriée et indiquez la résolution à côté du résultat. Pour une période longue, précisez que l’historique peut être agrégé par jour : un point quotidien ne permet pas de reconstituer l’évolution minute par minute.

Les intervalles manquants correspondent à des données inconnues, et non à la preuve d’un fonctionnement normal. Conservez le nombre d’échantillons et les limites des intervalles avec les valeurs agrégées. Cela permet d’évaluer dans quelle mesure l’historique couvre la période étudiée et sur quelles données repose la conclusion.

4. Préparez un relevé d’incident vérifiable

Pour le rapport, conservez les réponses brutes et les champs normalisés : service, région, heure de la requête, `service.status`, `observed_at`, `stale`, fenêtre d’historique choisie, `resolution_seconds`, nombre d’échantillons et `effective_start`. Laissez toute valeur absente telle quelle : zéro et absence de données n’ont pas le même sens.

Comparez ensuite ces éléments aux contrôles internes effectués sur la même période : codes de réponse, erreurs de connexion, région d’hébergement et horodatages. Si les données divergent, conservez les deux versions. Une observation régionale d’UptimeScout et un contrôle d’un point de terminaison précis correspondent à des points d’observation différents ; leur divergence appelle donc une vérification, plutôt que le choix de la réponse la plus commode.

En cas d’erreur API, référez-vous au code HTTP : la spécification répertorie les paramètres incorrects, l’absence de licence, une licence invalide, le dépassement de quota et une indisponibilité temporaire. Corrigez la cause correspondante. Une erreur de requête n’est pas le statut du service contrôlé.

Que transmettre à la personne d’astreinte

Dans votre synthèse, indiquez le service, la région, l’heure de l’observation, la fraîcheur de l’enregistrement et la résolution de l’historique. Signalez séparément les intervalles sans données comme inconnus et joignez les journaux internes de la même période. L’équipe disposera ainsi d’un signal régional vérifiable, sans confondre l’état de la requête API, les observations d’UptimeScout et les mesures propres à l’application.

Personnes

Aucune personne répertoriée pour cet article pour le moment.

Continuez à lireComment lire les incidents UptimeScout : un signal de panne n’est pas un incident confirmé
Lire le prochain article

Transformez vos lectures en intégration fonctionnelle

Explorez les API de données sociales de jsonscraper, testez des requêtes et créez votre prochain workflow.

Explorer les API