MetriBeacon
Menü
Deutsch

GET Gesamtverfügbarkeitsquelle des Monitors lesen

/api/v1/monitors/{id}/availability

HTTP- sowie TCP-, UDP-, DNS-, TLS-, Ping-, Dienst-, Domain- und Browsermonitore verwenden eine Gesamtverfügbarkeitsreihe je Monitor. Bei mehreren Prüfstandorten folgt diese der eingestellten Bestätigung und Standortregel (ein Standort, alle oder Quorum). Zeiten einzelner Standorte oder Engines werden nicht addiert. Der Katalog enthält aktive Monitore mit aktivierter Verfügbarkeitserfassung; die einzelne Quelle macht auch erhaltene Historie bei deaktivierter Erfassung zugänglich. Unbekannte, pausierte und unbeobachtete Zeit zählen niemals als bestätigte Verfügbarkeit. SLOs und Berichte verwenden dieselbe Quelle und behalten ihre getrennte Wartungsberechnung.

Auf dieser Seite

Zugriff und Rechte

HTTP- sowie TCP-, UDP-, DNS-, TLS-, Ping-, Dienst-, Domain- und Browsermonitore verwenden eine Gesamtverfügbarkeitsreihe je Monitor. Bei mehreren Prüfstandorten folgt diese der eingestellten Bestätigung und Standortregel (ein Standort, alle oder Quorum). Zeiten einzelner Standorte oder Engines werden nicht addiert. Der Katalog enthält aktive Monitore mit aktivierter Verfügbarkeitserfassung; die einzelne Quelle macht auch erhaltene Historie bei deaktivierter Erfassung zugänglich. Unbekannte, pausierte und unbeobachtete Zeit zählen niemals als bestätigte Verfügbarkeit. SLOs und Berichte verwenden dieselbe Quelle und behalten ihre getrennte Wartungsberechnung.

Browsersitzung: Cookie __Host-mb_session.

Maschinen-Verwaltungszugang in Authorization: Bearer. Beachten Sie die von der Operation benötigten Berechtigungen (Scopes).

Parameter und Header

FeldPositionTyp und GrenzenErforderlichBedeutung
idPfadstring; {"format":"uuid"}JaRessourcen-ID in diesem Arbeitsbereich

Anfragekörper

Kein Anfragekörper.

Antworten

application/json

FeldTyp und GrenzenErforderlichBedeutung
$objectJa—
$.monitor_idstring; {"format":"uuid"}Ja—
$.workspace_idstring; {"format":"uuid"}Ja—
$.namestringJa—
$.typestringJa—
$.series_idstring; {"format":"uuid"}Ja—
$.selectedbooleanJa—
$.metric_idsobjectNein—
$.config_revisionintegerNein—
$.retention_revisionstringNein—
$.retained_fromstring; {"format":"date-time"}Nein—
json
{
  "monitor_id": "00000000-0000-4000-8000-000000000001",
  "workspace_id": "00000000-0000-4000-8000-000000000002",
  "name": "API availability",
  "type": "tcp",
  "series_id": "00000000-0000-4000-8000-000000000003",
  "selected": true
}
Stabile Fehlercodes
invalid_session

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
forbidden
insufficient_scope

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
not_found

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
invalid_monitor

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—
Stabile Fehlercodes
unavailable

application/problem+json

FeldTyp und GrenzenErforderlichBedeutung
$ProblemJa—
$.codestringJaStabiler maschinenlesbarer Fehlercode
$.detailstringJaKurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instancestringJaEinmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.messagestringJaVorübergehend für bestehende Clients gleich detail
$.message_keystringJaStabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_paramsobject; {"additionalProperties":true}JaBenannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_idstring; {"pattern":"^[0-9a-f]{32}$"}JaVom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.statusinteger; {"maximum":599,"minimum":400}Ja—
$.titlestringJaLokalisierte HTTP-Statusbezeichnung
$.typestring; {"const":"about:blank"}Ja—

Wiederholungen und asynchrone Aufträge

Diese Operation liest oder prüft, ohne eine Ressourcenänderung anzuwenden. Beachten Sie Ratenlimits und Zugangslaufzeiten.

Anfragebeispiele

Ersetzen Sie Demokennungen, Zeitstempel und Platzhalter durch eigene Werte. Behalten Sie bei Wiederholungen Kennungen, Zeit und Inhalt bei. Diese Beispiele führen auf der Seite keine Anfragen aus.

Halten Sie Anmeldelinks, Codes, Cookies und Schlüssel privat. Schreiben Sie sie nicht in Logs und teilen Sie sie nicht in Hilfeanfragen.

shell
curl --silent --show-error --output /dev/null --write-out "%{http_code}\n" --request GET --header @"$HOME/.config/metribeacon/headers.txt" "https://metribeacon.com/api/v1/monitors/00000000-0000-4000-8000-000000000001/availability"
python
import json
from pathlib import Path
from urllib.request import Request, HTTPRedirectHandler, build_opener
from urllib.error import HTTPError
headers=json.loads((Path.home()/".config/metribeacon/headers.json").read_text())
class NoRedirect(HTTPRedirectHandler):
    def redirect_request(self, request, fp, code, message, headers, target): return None
request=Request('https://metribeacon.com/api/v1/monitors/00000000-0000-4000-8000-000000000001/availability',data=None,headers=headers,method='GET')
try:
    with build_opener(NoRedirect()).open(request,timeout=10) as response: print(response.status)
except HTTPError as error:
    print(error.code)
    error.close()
javascript
import {readFile} from "node:fs/promises";
import {homedir} from "node:os";
import {join} from "node:path";
const headers=JSON.parse(await readFile(join(homedir(),".config/metribeacon/headers.json"),"utf8"));
const response=await fetch("https://metribeacon.com/api/v1/monitors/00000000-0000-4000-8000-000000000001/availability",{method:"GET",headers,redirect:"manual",signal:AbortSignal.timeout(10000)});
console.log(response.status);await response.body?.cancel();
go
package main
import("encoding/json";"fmt";"net/http";"os";"path/filepath";"time")
func main(){home,e:=os.UserHomeDir();if e!=nil{return};raw,e:=os.ReadFile(filepath.Join(home,".config/metribeacon/headers.json"));if e!=nil{return};var headers map[string]string;if json.Unmarshal(raw,&headers)!=nil{return};req,e:=http.NewRequest("GET","https://metribeacon.com/api/v1/monitors/00000000-0000-4000-8000-000000000001/availability",nil);if e!=nil{return};for k,v:=range headers{req.Header.Set(k,v)};client:=&http.Client{Timeout:10*time.Second,CheckRedirect:func(*http.Request,[]*http.Request)error{return http.ErrUseLastResponse}};res,e:=client.Do(req);if e!=nil{return};defer res.Body.Close();fmt.Println(res.StatusCode)}
  • HTTP-API, OAuth und MCP

    Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.

  • POST Monitorverfügbarkeit auswerten

    Wertet die letzten 90 Tage und Zeiträume von 24 Stunden, 7, 30 und 90 Tagen mit der Gesamtverfügbarkeitsreihe des Monitors aus. Kalendertage verwenden die Zeitzone des anfragenden Kontos. Unbekannte, pausierte und fehlende Zeit ist keine bestätigte Verfügbarkeit. Bestehende Historienkapazität und Aufbewahrung gelten. Passende laufende Jobs oder höchstens fünf Minuten alte Ergebnisse werden wiederverwendet; den zurückgegebenen Archivjob bis zum Abschluss abfragen.

  • POST HTTP-Antwortzeiten nach Standort und Region auswerten

    Vergleichen Sie alle aufbewahrten regulären HTTP-Prüfdauern nach Standort oder Weltregion in einem gemeinsamen Datenstand. Mittelwerte sind nach Messungsanzahl gewichtet; der Gesamtdurchschnitt berücksichtigt ausgeblendete Standorte. Fehlende Messungen bleiben Lücken. Die automatische Darstellung teilt ein Ergebnisbudget von 16.000 Anzeigepunkten und 4 MiB zwischen beiden Ansichten. Original- und Livegrenzen werden ausdrücklich angezeigt; Echtzeit-Alarmreihen bleiben unverändert.

  • GET SSL-Zertifikatsdetails lesen

    Lesen Sie begrenzte, standortgebundene Zertifikatsnachweise. Automatische Zertifikatsdiagnosen und Resttagemessungen erfolgen stündlich, Domaindiagnosen täglich. Nachprüfungen erfordern Bearbeitungsrechte, ein gespeichertes Ziel, die aktuelle Konfigurationsrevision und eine Vorgangskennung. Sie nutzen Prüfkontingente, ohne reguläre HTTP-Messungen oder Alarmbestätigungen zu ändern. Unbekannte oder veraltete Nachweise bestätigen keine Gültigkeit.