Statistics API

Overzicht

De Statistics API retourneert een lijst met uw Service Level Agreement (SLA)-kengetallen en algemene monitoringinformatie voor elke controleregelcheck. Deze API geeft enige informatie weer die wordt weergegeven in uw Eenvoudige lijst of grafiek.

Gebruiksvoorbeeld

Gebruik de Statistics API om toegang te krijgen tot details zoals SLA-doel, downtime, uptimepercentage en het aantal controleregelalerts, fouten en checks.

Vereisten

Voordat u de Statistics API gebruikt, moet u ervoor zorgen dat u beschikt over:

Uptrends API-inloggegevens
Inzicht in uw SLA-vereisten en controleregelconfiguratie.

Statistics API-eindpunten

De Statistics API biedt de volgende eindpunten:

Methode	Eindpunt	Beschrijving
`GET`	`/Statistics/Monitor/{monitorGuid}`	Haal een lijst op met alle SLA-kengetallen en algemene informatie van uw controleregel.
`GET`	`/Statistics/MonitorGroup/{monitorGroupGuid}`	Haal een lijst op met alle SLA-kengetallen en algemene informatie van uw controleregelgroep.

Voor gedetailleerde request- en responsformaten en interactieve API-tests, raadpleegt u de Uptrends Statistics API-documentatie.

Statistics API-respons

{
  "Data": [
    {
      "Id": "10/13/2025 8:00:00 PM",
      "Type": "Statistics",
      "Attributes": {
        "StartDateTime": "2025-10-13T20:00:00",
        "EndDateTime": "2025-10-13T21:00:00",
        "Alerts": 0,
        "OperatorResponseTarget": 15,
        "OperatorResponseTime": 0,
        "DowntimePercentage": 0,
        "UptimePercentage": 100,
        "Checks": 62,
        "ConfirmedErrors": 0,
        "UnconfirmedErrors": 0,
        "Uptime": 3590,
        "Downtime": 0,
        "TotalTime": 0.727,
        "ResolveTime": 0.106,
        "ConnectionTime": 0.092,
        "DownloadTime": 0.527,
        "TotalBytes": 5699
      },
      "Relationships": [
        {
          "Id": "6f426452-5d2b-4fdf-84e2-c2b3d7ebf918",
          "Type": "Monitor",
          "Links": {
            "Self": "/Monitor/6f426452-5d2b-4fdf-84e2-c2b3d7ebf918"
          }
        }
      ]
    },
    {
      "Id": "10/13/2025 9:00:00 PM",
      "Type": "Statistics",
      "Attributes": {
        "StartDateTime": "2025-10-13T21:00:00",
        "EndDateTime": "2025-10-13T22:00:00",
        "Alerts": 10,
        "OperatorResponseTarget": 15,
        "OperatorResponseTime": 0,
        "DowntimePercentage": 0,
        "UptimePercentage": 100,
        "Checks": 62,
        "ConfirmedErrors": 0,
        "UnconfirmedErrors": 0,
        "Uptime": 3601,
        "Downtime": 0,
        "TotalTime": 0.7,
        "ResolveTime": 0.089,
        "ConnectionTime": 0.097,
        "DownloadTime": 0.513,
        "TotalBytes": 5699
      },
      "Relationships": [
        {
          "Id": "6f426452-5d2b-4fdf-84e2-c2b3d7ebf918",
          "Type": "Monitor",
          "Links": {
            "Self": "/Monitor/6f426452-5d2b-4fdf-84e2-c2b3d7ebf918"
          }
        }
      ]
    }
    ...
  ]
  
}

API-parameters

Gebruik de volgende parameters om informatie uit uw API-respons te filteren:

Veldnaam	Beschrijving
`monitorGuid`	De unieke identifier van de controleregel.
`monitorGroupGuid`	De unieke identifier van de controleregelgroep.
`Filter`	Een tekenreeks waarmee u kunt zoeken naar specifieke informatie uit de API-respons. U kunt een of meer Statistics API-velden als filterwaarden gebruiken. Bijvoorbeeld: `Alerts` of `Alerts, UptimePercentage`.
`Start`	Een aangepaste datumparameter in het formaat `YYYY-MM-DDTHH:MM:SS` (bijvoorbeeld `2025-01-20T08:00:00`) die samen met de parameter `End` wordt gebruikt om de startdatum voor de API-respons op te geven. Deze parameter kan niet samen met `PresetPeriod` worden gebruikt.
`End`	Een aangepaste datumparameter in het formaat `YYYY-MM-DDTHH:MM:SS` (bijvoorbeeld `2025-01-20T16:00:00`) die samen met de parameter `Start` wordt gebruikt om de einddatum voor de geretourneerde statistische records op te geven. Deze parameter kan niet samen met `PresetPeriod` worden gebruikt.
`PresetPeriod`	Een lijst met tijdsduur om informatie binnen een specifieke periode te filteren. Deze kan niet samen met de parameters `Start` en `End` worden gebruikt. De standaardwaarde is `Last24Hours`. Raadpleeg PresetPeriod voor een meer gedetailleerde uitleg.

Statistics API-velden

De Statistics API bevat verschillende API-velden:

Veldnaam	Beschrijving
`Id`	Het tijdstempel dat het begin van elk datainterval in de respons markeert. Bij gebruik van de standaard `PresetPeriod` van `Last24Hours` worden data gegroepeerd in intervallen van één uur.
`Type`	Het type data dat in de respons wordt weergegeven. De standaardwaarde is `Statistics`.
`Attributes`	Bevat SLA-kengetallen en algemene monitoringgegevens, zoals uptime, downtime, alerts en responstijden. Raadpleeg de Attributes-veldsectie voor meer informatie.
`Relationships`	Definieert hoe de huidige data worden gekoppeld aan of geassocieerd met andere data, zodat u verwijzingen naar gerelateerde resources kunt identificeren. Raadpleeg Relationships voor meer informatie.

Attributes API-velden

Het Attributes API-veld bevat:

Veldnaam	Beschrijving
`StartDateTime`	Verwijst naar de datum en tijd waarop het controle-interval van de controleregel begint.
`EndDateTime`	Verwijst naar de datum en tijd waarop het controle-interval van de controleregel eindigt.
`Alerts`	Het aantal alerts dat is geactiveerd door bevestigde fouten tijdens het controle-interval van de controleregel.
`OperatorResponseTarget`	De doeltijd van de SLA-operatorrespons in minuten. Dit is de maximale tijd die een operator in Uptrends heeft om een fout te bevestigen.
`OperatorResponseTime`	De SLA-operatorresponstijd in minuten. Dit is de daadwerkelijke tijd die een operator nodig had om een fout in Uptrends te bevestigen.
`DowntimePercentage`	Het SLA-downtimepercentage. Dit is de totale tijd dat de website of webservice niet beschikbaar was.
`UptimePercentage`	Het SLA-uptimepercentage. Dit is de totale tijd dat de website of webservice operationeel was.
`Checks`	Het aantal controleregelchecks binnen het controle-interval, van `StartDateTime` tot `EndDateTime`.
`ConfirmedErrors`	Het aantal bevestigde fouten.
`UnconfirmedErrors`	Het aantal fouten dat is gemeld maar nog niet is geverifieerd.
`Uptime`	De totale tijd dat uw website operationeel was, gemeten in minuten.
`Downtime`	De totale tijd dat uw website down en niet beschikbaar was, gemeten in minuten.
`TotalTime`	De totale tijd om een controleregelcheck te voltooien, gemeten in seconden.
`ResolveTime`	De tijd die nodig is om een domeinnaam of URL te vertalen naar een bijbehorend IP-adres, gemeten in seconden.
`ConnectionTime`	De tijd die nodig is om verbinding te maken met het IP-adres van uw webpagina of server, gemeten in seconden.
`DownloadTime`	De tijd die nodig is om inhoud te downloaden nadat er verbinding is gemaakt met uw webpagina of server, gemeten in seconden.
`TotalBytes`	De totale hoeveelheid data, in bytes, die van uw pagina is opgehaald tijdens het controleregelcheck-interval.

Problemen oplossen

In deze sectie worden veelvoorkomende HTTP-fouten en stappen voor probleemoplossing voor de Statistics API behandeld.

Veelvoorkomende fouten

Veelvoorkomende HTTP-statuscodes en hun beschrijvingen:

Statuscode	Beschrijving
200	OK — request succesvol
400	Bad request — ongeldige requestparameters of ontbrekende vereiste velden.
401	Unauthorized — ongeldige of ontbrekende authenticatiegegevens.
403	Forbidden — toestemming geweigerd.
404	Not Found — de opgegeven GUID bestaat niet.
500	Internal Server Error — er is een serverfout opgetreden.

Algemene handleiding voor probleemoplossing

Zorg ervoor dat u:

Altijd uw request data valideert voordat u API-calls verzendt.
Voor elke operation de juiste HTTP-methode gebruikt.

Neem voor verdere ondersteuning contact op met ons Support-team.

Digital Experience Monitoring

API Monitoring

Real User Monitoring

Ingebouwde functies

Meer mogelijkheden

Voordelen voor teams

Op maat gemaakt voor uw sector

Wat is nieuw in Uptrends

Ontwikkelaars (Uptrends API)

Integraties

Over ITRS Uptrends

Wiki

Gratis tools