SSH Monitor Details abrufen
Konsolidierter Endpunkt, der die Daten für die SSH Monitor Detailseite in einem Call zurückgibt.
GET /api/ssh-monitors/:sshMonitorPublicId/details
Authentifizierung
Erfordert eine gültige Session.
- Header:
Authorization: Bearer <token>
Parameter
sshMonitorPublicId(Pfad, erforderlich): Öffentliche UUID des SSH Monitors.
Query Parameter
range(string, optional):day,week,month,year(Default:day)date(string, optional): Referenzdatum (wird vianew Date(date)geparst)startDate(string, optional)endDate(string, optional)granularity(string, optional)- Wenn
raw, wird Aggregation deaktiviert.
- Wenn
cURL
curl "https://YOUR_DOMAIN/api/ssh-monitors/44444444-4444-4444-8444-444444444444/details?range=day" \
-H "Authorization: Bearer $TOKEN"Response
Die Response ist ein einzelnes Objekt mit diesen Top-Level Keys:
sshMonitorIdmonitorlatestCheckuptimeStatsuptimeStatsMetamonitoringDataincidentsalertstestResultLogmaintenance
Beispiel (gekürzt):
{
"sshMonitorId": 300,
"monitor": {
"id": 300,
"customerId": 10,
"name": "Bastion Host",
"hostname": "ssh.deinkunde.com",
"port": 22,
"status": "active",
"checkInterval": 60,
"timeoutSeconds": 30,
"allowedCheckCountryCodes": ["DE"],
"config": {
"username": "root"
}
},
"latestCheck": {
"status": "success",
"checkedAt": "2026-02-26T12:00:00.000Z",
"timingSsh": 123,
"locationCode": "de-nbg",
"locationName": "Nuremberg (DE)"
},
"uptimeStats": {
"day": 99.9,
"month": 99.5,
"year": 99.0,
"dayAvgResponse": 120,
"monthAvgResponse": 140,
"yearAvgResponse": 150
},
"maintenance": {
"inMaintenance": false,
"activeWindows": [],
"allWindows": []
}
}Aufbewahrung
Einzelne Prüfungen bleiben 24 Stunden erhalten, Minutenwerte 30 Tage und Tageswerte 24 Monate; ein Zeitraum, der älter als 30 Tage ist, liefert einen Punkt pro Tag. Hat der Monitor in den letzten 24 Stunden nicht geprüft, beschreibt latestCheck seine letzte Minute aus dem Aggregat: id beginnt mit 1min-, resolution ist 1min, locationId und errorMessage sind null.
Errors
400Ungültige SSH Monitor Public ID (UUID)401Unauthorized403Forbidden404Not found500Failed to fetch SSH monitor details
Häufige Fehler
400 Bad Request(invalidRequestBody) wennrangenichtday/week/month/yearist,date/startDate/endDatekein Datum ist, nur eines vonstartDate/endDatekommt,tzkeine Ganzzahl ist odergranularitywederrawnochaggregated