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.

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.

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.