# UptimeScout: controleren of een dienst in de regio van de gebruiker uitviel

https://jsonscraper.com/nl/blog/uptimescout-beschikbaarheid-per-regio-controleren

Author: Michael Johnson

Published: 2026-11-20T11:38:40+00:00

Updated: 2026-11-20T11:38:40+00:00

Praktijkvoorbeeld: observatiegeschiedenis voor een regio verzamelen en een recent signaal onderscheiden van een onbekend interval

Wanneer gebruikers in één land problemen melden, terwijl het team ziet dat de dienst normaal werkt, is het vooral nuttig om de observaties voor hun regio te controleren. Met de UptimeScout API kunt u de geschiedenis van een geselecteerde dienst opvragen met een regiocode, inclusief tijdsintervallen en het aantal metingen. Het resultaat is een controleerbare tabel voor het onderzoeken van een melding: intervaltijd, resolutie, verdeling van signalen en aantal samples.



![Artikel: UptimeScout: controleren of een dienst in de regio van de gebruiker uitviel
Samenvatting: Een regionale beschikbaarheidscontrole kan uitwijzen of een gebruikersincident overeenkomt met observaties van UptimeScout. We laten een reproduceerbare aanpak zien: kies een dienst en regio, vraag de geschiedenis op, controleer de actualiteit en resolutie van de gegevens en bewaar het resultaat samen met het oorspronkelijke antwoord.
Beeldrol: omslag — het centrale idee
Sectie: 
Visueel onderwerp: Redactionele foto van een gevouwen regionaal storingsbericht](https://jsonscraper.com/assets/uploads/journal/2026/11/1cd4023e50fafa3c2411a7c5fc1a0f4b.png.hero.webp)

De regio en het tijdvenster bepalen de grenzen van de beschikbaarheidscontrole.© jsonscraper · gemaakt met AI

 

Het praktijkscenario is het onderzoeken van een vermoedelijke regionale storing. De invoer bestaat uit een service-ID uit de UptimeScout-catalogus, een regiocode zoals US of GB en een tijdvenster voor de geschiedenis. Het resultaat helpt om het tijdstip van de gebruikersmelding te vergelijken met observaties van de dienst. De API beschrijft de gegevens als signalen van waargenomen beschikbaarheid; een controle van de dienst helpt de vraag af te bakenen, maar vervangt niet uw eigen controles van de applicatie.

 

## Bevestig eerst de dienst en de regio

 

Begin in de catalogus: zoek de gewenste dienst op naam of met een zoekterm en noteer vervolgens de exacte ID. De specificatie van [UptimeScout OpenAPI](https://uptimescout.com/openapi.json) beschrijft zoeken via GET /v1/services en de parameters q, service, region, limit en offset. Voor een diagnoserapport kunt u beter de ID bewaren dan alleen de weergegeven naam, zodat een herhaalde aanvraag naar hetzelfde catalogusitem verwijst.

 

De regio wordt opgegeven met een aparte code van twee letters. Bewaar die bij het resultaat: een antwoord voor US en een antwoord zonder regionaal filter beantwoorden verschillende vragen. Als de beschrijving in het Russisch moet worden weergegeven, regelt de parameter lang=ru de lokalisatie van de beschrijving, terwijl de parameter region de observaties selecteert. De documentatie maakt expliciet onderscheid tussen deze twee functies.

 

## Vraag de geschiedenis op in plaats van één status

 

Gebruik voor het onderzoeken van een incident /v1/history met de verplichte parameter service en de gekozen region. De parameter hours bepaalt het tijdvenster van de geschiedenis; volgens de specificatie zijn waarden van 1 tot en met 2160 uur toegestaan. De aanvraag ondersteunt ook lang. Volgens OpenAPI wordt de autorisatie met een licentie via het Bearer-schema doorgegeven. Bewaar de sleutel bij praktisch gebruik in een omgevingsvariabele en schrijf deze niet naar het aanvraaglogboek.

 

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

 

Dit is een minimaal voorbeeld van een aanvraag, geen gepubliceerd resultaat van een daadwerkelijk onderzoek. De ID github en de regio GB zijn voorbeeldparameters: kies vóór gebruik de dienst en regio die bij uw situatie passen. Het is handig om het volledige antwoord als JSON op te slaan en in afzonderlijke velden van uw auditsysteem het tijdstip van ontvangst en een beschrijving van de aanvraag toe te voegen. Zo kunt u het onderzoek herhalen en zien welke specifieke momentopname van de gegevens is gebruikt.

 

## Resolutie en ontbrekende gegevens horen bij het resultaat

 

In de array history zijn de velden observed_at, resolution_seconds, aggregated, samples en counts van belang. De resolutie geeft de duur van het tijdsinterval aan; samples laat zien hoeveel observaties in het aggregaat zijn opgenomen, terwijl counts de verdeling van de signalen bevat. Beoordeel deze velden samen: één regel met weinig samples weegt anders in de analyse dan een aggregaat met veel observaties.



![Artikel: UptimeScout: controleren of een dienst in de regio van de gebruiker uitviel
Samenvatting: Een regionale beschikbaarheidscontrole kan uitwijzen of een gebruikersincident overeenkomt met observaties van UptimeScout. We laten een reproduceerbare aanpak zien: kies een dienst en regio, vraag de geschiedenis op, controleer de actualiteit en resolutie van de gegevens en bewaar het resultaat samen met het oorspronkelijke antwoord.
Beeldrol: aanvullende illustratie 2 — een ander specifiek aspect
Sectie: Resolutie en ontbrekende gegevens horen bij het resultaat](https://jsonscraper.com/assets/uploads/journal/2026/11/a171063a93107bb525c54a0ee477e61a.png.hero.webp)

De geschiedenis lezen: regio, tijdsintervallen, resolutie en ontbrekende gegevens.© jsonscraper · AI-gegenereerde illustratie

 

UptimeScout beschrijft de geschiedenis als tijdsintervallen met verschillende stappen, afhankelijk van het gekozen tijdvenster: intervallen van één en vijf minuten voor korte perioden, intervallen van een uur voor een etmaal en intervallen van een dag voor lange perioden. Opgeslagen oudere aggregaten kunnen een grovere resolutie hebben. Trek daarom niet de conclusie dat een storing precies op deze minuut begon als een regel een aggregaat per uur of per dag weergeeft. Gebruik de feitelijke waarde van resolution_seconds en de velden effective_start en history_resolution in het antwoord om de grenzen van de beschikbare conclusie aan te geven.

 

Behandel een ontbrekend interval als onbekend. De specificatie vraagt expliciet om ontbrekende gegevens als onbekende intervallen te controleren: een lege plek in de geschiedenis staat op zichzelf niet voor normale werking en evenmin voor een storing. Deze eenvoudige regel voorkomt dat ontbrekende gegevens in een rapport ten onrechte worden ingevuld met een ‘groene’ status of nullen.

 

## Vergelijk de geschiedenis met het huidige signaal

 

Als u de toestand op het moment van de melding wilt controleren, vraag dan /v1/status op voor dezelfde service en region. Bekijk in het serviceobject status, observed_at en stale samen; de documentatie noemt deze velden als hulpmiddel om de toestand en actualiteit van het signaal te beoordelen. De status op het hoogste niveau heeft betrekking op het resultaat van de API-aanvraag, terwijl service.status het beschikbaarheidssignaal van de specifieke dienst beschrijft. Dit onderscheid is vooral nuttig in automatische rapporten: een geslaagd HTTP-antwoord en de toestand van een externe dienst zijn twee verschillende zaken.

 

Voor meerdere afhankelijkheden kunt u /v1/statuses opvragen en vervolgens alleen voor de diensten en regio’s waar een afwijking is ontstaan de geschiedenis bekijken. De specificatie biedt ook /v1/summary en /v1/incidents. Houd bij het diagnosticeren van die laatste route rekening met de precieze functie ervan: het endpoint retourneert recente verhoogde signalen van storingen, geen door de leverancier bevestigde incidenten. Het resultaat is daarom aanleiding voor een controle, geen definitieve conclusie over de oorzaak.

 

## Zo formuleert u conclusies zonder te speculeren

 

Bewaar in de rapportregel de service-ID, region, de aangevraagde periode, observed_at, resolution_seconds, samples, counts en een aanduiding van ontbrekende gegevens. Voeg een link naar de melding of het interne incident afzonderlijk toe, buiten de API-velden. Vergelijk daarna het tijdsbereik met applicatielogboeken, regionale traceringen en de melding van de gebruiker. Als de tijdsgrenzen van het aggregaat ruimer zijn dan die van het incident, formuleer de uitkomst dan dienovereenkomstig: de observaties voor de geselecteerde regio en periode bevatten deze signalen, met deze resolutie en dit aantal metingen.

 

Een dergelijke analyse biedt de dienstdoende medewerker een nuttige keuze: de regionale kant van de externe dienst controleren of doorgaan met de diagnose van de eigen applicatie en het netwerk van de gebruiker. De reproduceerbaarheid hangt af van het bewaren van de aanvraagparameters en de oorspronkelijke JSON; de kwaliteit van conclusies over tijd hangt af van expliciete aandacht voor de resolutie, samples en onbekende intervallen. Dat is het praktische resultaat voor een beschikbaarheidsgeval: niet slechts een actuele statusmarkering, maar een registratie die is afgebakend naar regio en tijd en die een collega opnieuw kan controleren.
