jsonscraper
Markten
Terug naar het journaal

Een regionaal signaal controleren: servicestatus vergelijken met de UptimeScout-geschiedenis

Vraag regionale waarnemingen en geschiedenis op, controleer de tijd en actualiteit en vergelijk de gegevens daarna met applicatielogboeken.

Redactioneel beleid Een fout melden

Controleer of een vermoeden van een storing overeenkomt met waarnemingen in een specifieke regio door de servicestatus en de geschiedenis over een gekozen periode op te vragen. Vergelijk de regio en tijdstempels met de applicatielogboeken. Het resultaat geeft antwoord op een concrete vraag: staat er een regionaal signaal in de opgeslagen gegevens en hoe actueel is de bijbehorende registratie?

De UptimeScout-specificatie beschrijft afzonderlijke status- en geschiedenisroutes. In het statusantwoord geeft het veld `status` op het hoogste niveau het resultaat van de API-aanvraag weer; het servicesignaal staat in `service.status`. De geschiedenis bevat geaggregeerde tijdsintervallen, de resolutie en het aantal metingen. Dit zijn nuttige gegevens voor een eerste diagnose en als bijlage bij een incidentrapport.

1. Bereid de service, regio en licentie voor

In het onderstaande voorbeeld worden de service-ID `github` en de regio `US` gebruikt. Gebruik voor je eigen controle een geldige ID uit de UptimeScout-catalogus en de regiocode waar het probleem is waargenomen. Welke regio's beschikbaar zijn, kan per service verschillen; controleer daarom vóór de interpretatie `available_regions` in het antwoord.

Artikel: Een regionaal signaal controleren: servicestatus vergelijken met de UptimeScout-geschiedenis
Samenvatting: Stapsgewijze diagnose van een regionaal UptimeScout-signaal: een verzoek via de Python-SDK, controle van de velden `service.status`, `observed_at` en `stale`, en vergelijking met de geschiedenis en de resolutie ervan.
Afbeeldingsrol: omslag — het centrale idee
Sectie: 1. Bereid de service, regio en licentie voor
Visueel onderwerp: Redactionele foto-illustratie, close-up van een incidentresponswerkblad op een tafel: een Amerikaanse regiokaart naast twee n
De regio op de kaart wordt vergeleken met tijdstempels en hiaten in de waarnemingsgeschiedenis.© jsonscraper · gemaakt met AI

Installeer Python 3.10 of hoger en de SDK volgens de projectinstructies. Stel de sleutel in via de omgevingsvariabele `UPTIMESCOUT_LICENSE_KEY` en neem deze niet op in code of logboeken. Het voorbeeld voert twee verzoeken uit met de gedocumenteerde client, bewaart de oorspronkelijke JSON-antwoorden in het geheugen en drukt ze af ter controle. Dit is een integratievoorbeeld, geen verslag van een hier uitgevoerde test.

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

De officiële Python-SDK van UptimeScout documenteert de client, de methoden `status` en `history`, en de Bearer-authenticatie die onder water wordt afgehandeld. Volg voor installatie en versies de actuele instructies in de repository; het getoonde fragment gaat ervan uit dat de SDK is geïnstalleerd.

2. Controleer of je het signaal leest, en niet de status van het verzoek

Controleer in het antwoord de velden `service.status`, `service.observed_at`, `service.stale` en de regio van het antwoord. Het veld `status` op het hoogste niveau gaat over het al dan niet slagen van het API-verzoek, niet over de beschikbaarheid van de service zelf. Bewaar ook het tijdstip van het verzoek, de service-ID en de regioparameters, zodat duidelijk is op welke registratie de conclusie betrekking heeft.

Als de waarneming als actueel is gemarkeerd en `service.status` op degradatie of uitval wijst, leg dit dan vast als regionaal signaal en vergelijk het met je eigen logboeken, verbindingsfouten en applicatiecontroles. Het veld `stale` geeft aan of de opgeslagen waarneming buiten het ingestelde actualiteitsvenster valt. Is de waarde `true` of ontbreekt het vereiste veld, noteer de actuele beschikbaarheid dan als onbekend op basis van dit antwoord; leid uit een verouderde of onvolledige registratie geen conclusie af over de huidige toestand.

UptimeScout beschrijft de gegevens als opgeslagen regionale signalen: ze zijn een hulpmiddel bij de diagnose, geen rechtstreekse meting van uptime en geen bevestiging van een wereldwijde storing. Formuleer de uitkomst daarom precies: ‘voor deze regio is een signaal van dit type gevonden, geregistreerd op het genoemde tijdstip’. Vergelijking met je eigen controles laat zien of dit externe signaal overeenkomt met de ervaring van gebruikers van je applicatie.

3. Vergelijk de geschiedenis en de intervalresolutie

De geschiedenismethode retourneert tijdsaggregaten. Controleer in het antwoord `resolution_seconds`, `samples`, `counts` en `effective_start`; bewaar ook de feitelijke tijdsgrenzen van de intervallen. De documentatie beschrijft uitlijning op UTC: intervallen van drie minuten voor vensters tot een uur, intervallen van vijf minuten tot drie uur, intervallen van een uur tot een dag en intervallen van een dag voor langere vensters. Bij oudere opgeslagen aggregaten kan een grovere opgegeven resolutie blijven staan.

Artikel: Een regionaal signaal controleren: servicestatus vergelijken met de UptimeScout-geschiedenis
Samenvatting: Stapsgewijze diagnose van een regionaal UptimeScout-signaal: een verzoek via de Python-SDK, controle van de velden `service.status`, `observed_at` en `stale`, en vergelijking met de geschiedenis en de resolutie ervan.
Afbeeldingsrol: ondersteunende illustratie 2 — een ander specifiek aspect
Sectie: 3. Vergelijk de geschiedenis en de intervalresolutie
Visueel onderwerp: Een heldere redactionele infographic op een lichte achtergrond, vier opeenvolgende panelen tonen
Antwoordvelden en de volgorde waarin een regionaal signaal en de geschiedenis worden gecontroleerd.© jsonscraper · AI-gegenereerde illustratie

Kies je periode daarom op basis van de vraag. Gebruik voor een kort incident een passende korte periode en vermeld de resolutie naast het resultaat. Geef voor een lange periode aan dat de geschiedenis per dag kan zijn geaggregeerd: uit een dagpunt is de dynamiek per minuut niet te reconstrueren.

Ontbrekende intervallen zijn onbekende gegevens, geen bewijs van normale werking. Bewaar het aantal metingen en de intervalgrenzen naast de geaggregeerde waarden. Zo is te zien hoe volledig de geschiedenis de onderzochte periode bestrijkt en op welke gegevens de conclusie berust.

4. Leg een controleerbare incidentregistratie vast

Voor een rapport volstaat het om de oorspronkelijke antwoorden en genormaliseerde velden te bewaren: service, regio, tijdstip van het verzoek, `service.status`, `observed_at`, `stale`, de gekozen geschiedenisperiode, `resolution_seconds`, het aantal metingen en `effective_start`. Laat ontbrekende waarden ontbreken: nul en geen gegevens betekenen niet hetzelfde.

Vergelijk deze gegevens vervolgens met interne controles over dezelfde periode: antwoordcodes, verbindingsfouten, de hostingregio en tijdstempels. Als de gegevens uiteenlopen, bewaar dan beide kanten. Een regionale waarneming van UptimeScout en een controle van een specifieke endpoint beschrijven verschillende waarnemingspunten. Een verschil vraagt daarom op zichzelf om nader onderzoek, niet om een keuze voor het antwoord dat het beste uitkomt.

Leid bij een API-fout af wat er aan de hand is aan de hand van de HTTP-code: de specificatie vermeldt ongeldige parameters, een ontbrekende licentie, een ongeldige licentie, overschrijding van het quotum en tijdelijke onbeschikbaarheid. Verhelp de bijbehorende oorzaak. Een fout in het verzoek is geen status van de gecontroleerde service.

Wat geef je door aan de dienstdoende collega?

Vermeld in een korte conclusie de service, regio, waarnemingstijd, actualiteit van de registratie en resolutie van de geschiedenis. Markeer intervallen zonder gegevens afzonderlijk als onbekend en voeg interne logboeken over dezelfde periode toe. Zo krijgt het team een controleerbaar regionaal signaal, zonder de status van de API-aanvraag, UptimeScout-waarnemingen en eigen applicatiemetingen met elkaar te verwarren.

Mensen

Er zijn nog geen mensen vermeld voor dit artikel.

Blijf lezenUptimeScout incidents lezen: een storingssignaal is nog geen bevestigd incident
Lees het volgende artikel

Maak van wat je leest een werkende integratie

Ontdek de socialdata-API's van jsonscraper, test aanvragen en bouw je volgende workflow.

API's verkennen