Home » Funktionen » API

Automatisieren Sie jeden Teil Ihrer Überwachung mit der Dotcom-Monitor API

Rating: 5
Author: Gregory S.

Erstellen Sie programmgesteuert Monitore, verwalten Sie Geräte und Aufgaben, orchestrieren Sie Lasttests und streamen Sie Echtzeit-Leistungsdaten in Ihre eigenen Dashboards, SIEMs und CI/CD-Pipelines – mit einer dokumentierten REST Web API und dem XML Reporting Service (XRS).

10.000+

Organisationen weltweit

99,99%

Plattform-Verfügbarkeitsgarantie (SLA)

30+

Globale Überwachungsstandorte

Seit 1998

Marktführer im Website-Monitoring

Programmatische Überwachung

Was ist die Dotcom-Monitor API?

Die Dotcom-Monitor Plattform ist vollständig skriptfähig. Alles, was Sie in der Weboberfläche machen können — vom Erstellen eines neuen HTTP-Monitors bis zum Abrufen eines Leistungsberichts über drei Monate — können Sie programmgesteuert über zwei ergänzende Dienste tun: die REST-basierte Web API für die Konfiguration und den XML Reporting Service (XRS) für die Echtzeit-Datenauswertung.

Die Web API ist eine strukturierte, JSON-basierte HTTP-Schnittstelle, die Überwachungs- und Lasttest-Operationen für Ihre eigenen Systeme bereitstellt. Verwenden Sie sie, um bei jedem Deployment neue Monitore bereitzustellen, Tausende von Geräten unter Konfiguration-als-Code zu verwalten, Monitoring in Ihre bestehenden Ticketing-Tools zu integrieren oder Live-Leistungsdaten in kundenorientierte Statusseiten einzubetten.

Der XML Reporting Service (XRS) ist ein kostenloser On-Demand-Datenfeed, der Überwachungsergebnisse als XML-Dokumente liefert. Richten Sie ihn auf jedes Reporting-Dashboard, BI-Tool, Excel-Arbeitsblatt oder interne Datenbank, um benutzerdefinierte Ansichten zu erstellen, ohne auf Engineering warten zu müssen.

Gemeinsam bieten sie Ihren Plattform-, SRE- und DevOps-Teams volle programmatische Kontrolle — ganz ohne UI-Klicks.

Konfigurieren Sie HTTPS-, REST-, SOAP-, GraphQL-, WebSocket-, ServerView-, BrowserView-, UserView- und MetricsView-Monitore über JSON
Importieren, aktualisieren und entfernen Sie Geräte, Aufgaben, Gruppen und Scheduler in großem Umfang
Rufen Sie rohe oder aggregierte Leistungsdaten ab (stündlich, täglich, wöchentlich, monatlich, jährliche Zusammenfassungen)
Stellen Sie Monitoring aus Jenkins, GitHub Actions, Azure DevOps, GitLab CI oder jeder HTTP-fähigen Pipeline bereit

Web API — Kurzübersicht

https://api.dotcom-monitor.com/config_api_v1/

Format

JSON-Anfrage / JSON-Antwort

Methoden

GET (lesen) · POST / PUT (schreiben / aktualisieren)

Auth

Pro-Anfrage, 60-Sekunden-Session; optionale IP-Whitelist

Transport

HTTP oder HTTPS

XRS — Kurzübersicht

https://xmlreporter.dotcom-monitor.com/reporting/xml/

Format

XML-Antwort über HTTP(S) GET

Auth

Account-UID (PID), generiert unter Verwalten > Integrationen

Daten-Tiefe

Rohdaten Antworten bis zu 6 Monate zurück

Kosten

Kostenlos, in jedem Konto enthalten

Einen Schlüssel generieren

Erstellen Sie eine Web API- oder XML-Feed-Integration in Ihrem Konto.

Konfigurieren

POST JSON, um Geräte, Aufgaben, Gruppen, Zeitpläne und Alarme zu erstellen.

Überwachen

Führ Läufe von über 30 Standorten weltweit zu Ihrem definierten Zeitplan aus.

Extrahieren

Ergebnisse über XRS in Dashboards, BI, Excel oder interne Apps ziehen.

Kernfähigkeiten der API

Alles, was die Benutzeroberfläche kann – als Code

Jedes Überwachungsobjekt in Ihrem Konto ist eine erstklassige API-Ressource. Verwalten Sie diese einzeln oder in großen Mengen über Umgebungen hinweg.

Vollständige Monitor-Konfiguration

Erstellen und bearbeiten Sie HTTPS-, REST-, SOAP-, GraphQL- und mehrstufige API-Monitore
Konfigurieren Sie BrowserView-, UserView-, ServerView- und MetricsView-Geräte
Authentifizierung anhängen: OAuth 2.0, API-Schlüssel, Bearer-Token, Basic, NTLM, mTLS
JSONPath / XPath Assertions und benutzerdefinierte Antwortvalidierung definieren

Geräte-, Aufgaben- & Gruppenverwaltung

Geräte und die ihnen untergeordneten Aufgaben bereitstellen
Monitore in Gruppen mit vererbter Alarmierung und Filtern organisieren
Konfigurationsänderungen umweltübergreifend in großen Mengen anwenden
Geräte zwischen Staging-, QA- und Produktionskonten klonen

Standorte & Zeitpläne

Liste aller verfügbaren globalen Monitoring-Standorte
Checks bestimmten Regionen oder Ihren Private Agents zuweisen
Zeitbasierte Zeitpläne erstellen (Geschäftszeiten, Wartungsfenster)
Filter programmatisch anwenden, um bekanntes Rauschen zu unterdrücken

Alarme & Benachrichtigungsintegrationen

Alarmgruppen über API erstellen, aktualisieren und weiterleiten
Empfängerl Listen, Eskalationsrichtlinien und Bereitschaftsdienste verwalten
Push-Benachrichtigungen an Slack, PagerDuty, Teams, OpsGenie, Webhooks
Automatisierte Eskalationsanpassung ohne UI-Interaktion

XRS Echtzeitbericht-Feed

Uptime, Antwortzeit, TTFB und Fehlerdaten auf Abruf abrufen
Rohe Antworten oder Zusammenfassungen zurückgeben (Stunde / Tag / Woche / Monat / Jahr)
Nach Gerät, Standort, Zeitplan, Erfolg / Fehler, Abteilung filtern
In SQL, Excel, Power BI, Grafana oder benutzerdefinierte Dashboards streamen

Wie es funktioniert

Von Null zur automatisierten Überwachung in vier Schritten

Keine SDK-Installation erforderlich. Wenn Ihr System eine HTTP-Anfrage senden kann, kann es mit Dotcom-Monitor kommunizieren.

Integration erstellen

Gehen Sie in Ihrem Dotcom-Monitor-Konto zu Verwalten > Integrationen und erstellen Sie eine neue Web API-Integration (für Konfiguration) oder XML-Feed-Integration (für Berichte). Optional können Sie den Zugriff nach IP-Adresse einschränken.

Authentifizieren

Jede Anfrage authentifiziert sich über Ihre Integration. Sitzungen laufen nach 60 Sekunden Inaktivität ab, wodurch der Zugriff kurzzeitig und sicher bleibt. XRS-Anfragen verwenden Ihre generierte Account UID (PID).

JSON-Anfragen senden

Verwenden Sie GET zum Lesen oder POST/PUT zum Schreiben. Setzen Sie Content-Type: application/json, wenn Sie einen Body senden. Fehler werden als strukturierte JSON zurückgegeben.

Automatisieren Sie überall

Integrieren Sie die API in Terraform, Jenkins, GitHub Actions, Azure DevOps oder Ihre eigenen Skripte. Lösen Sie die Überwachungsbereitstellung beim Deployment aus, ziehen Sie Leistungsdaten in BI oder senden Sie automatische Benachrichtigungen bei SLA-Verstößen.

Technische Spezifikationen

Zwei APIs. Ein Konto. Vollständige Kontrolle.

Die Web-API verwaltet die Konfiguration; XRS übernimmt die Berichterstellung. Beide teilen ein einheitliches Authentifizierungsmodell und funktionieren mit jeder Dotcom-Monitor-Lösung.

Web API (Konfiguration & Steuerung)

Verwalten Sie Ihre Überwachungsinfrastruktur programmgesteuert.

Basis-URL

api.dotcom-monitor.com/config_api_v1/

Protokolle

HTTP, HTTPS

Anfrageformat

JSON (application/json)

Antwortformat

JSON

Methoden

GET (lesen) · POST, PUT (schreiben / aktualisieren)

Authentifizierung

Web API Integrationsschlüssel, pro Anfrage Sitzung (60s Timeout)

Zugriffskontrolle

IP-Whitelist optional

Deckt ab

Monitoring- + LoadView-Methoden

Verwaltete Objekte

Geräte, Aufgaben, Gruppen, Zeitpläne, Filter, Alarme, Standorte, Lasttests, Benutzer

Fehlerbehandlung

Strukturiertes JSON mit Fehlercodes & Nachrichten

XML Reporting Service (XRS)

Streamen Sie Echtzeit-Monitoring-Daten in jede Anwendung, die XML unterstützt.

Basis-URL

xmlreporter.dotcom-monitor.com/reporting/xml/

Protokolle

HTTP, HTTPS

Anfrageformat

HTTP(S) GET mit URL-Parametern

Antwortformat

XML-Dokument

Authentifizierung

Account UID (PID), generiert als XML-Feed-Integration

Geltungsbereich

Account-weit oder beschränkt auf bestimmte Abteilungen

Berichtstypen

Gerätekonfiguration, Status, Rohantworten, Zusammenfassungen (Stunde / Tag / Woche / Monat / Jahr), 3-Monats-Statistiken

Datenfenster

Bis zu den letzten 6 Monaten für Rohantworten

Filter

Standort, Zeitplan, Gerät, Erfolg / Fehler, Abteilung, Datumsbereich

Ausgabeziele

Dashboards, SQL, Excel, Power BI, eigene Apps

Entwicklerfreundlich

Einfaches HTTP.
Keine SDKs erforderlich.

Jedes Überwachungsobjekt – Geräte, Aufgaben, Alarme, Gruppen, Zeitpläne – wird als JSON-Ressource dargestellt. So sieht es aus, Überwachungsdaten aus XRS abzurufen und ein neues Gerät über die Web-API hinzuzufügen. Fügen Sie diese in ein curl, ein Bash-Skript, einen Python-Job oder einen CI-Schritt ein – was auch immer Ihr Team bereits verwendet.

Zurückgegebene Felder umfassen DnsTime, SSLTime, ConnectionTime, RequestTime, FirstPacketTime (TTFB), DownloadTime und Duration sowie Standort, Status und Überwachungszeitstempel – bereit zum Einfügen in jede Waterfall-Ansicht.

# Echtzeit-XRS-Bericht abrufen – Zusammenfassung nach Standort
GET https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx
     ?PID=4229AF4F0FB545AEA75EAF2013E51BB7
     &Site=12345
     &Type=Overall
     &location=NY, USA

# Antwort (gekürzt)
<Response>
  <ID>3424533543</ID>
  <Name>Checkout API</Name>
  <URL>https://shop.example.com/api/checkout</URL>
  <Duration>114</Duration>
  <DnsTime>0</DnsTime>
  <SSLTime>18</SSLTime>
  <ConnectionTime>15</ConnectionTime>
  <FirstPacketTime>97</FirstPacketTime>
  <DownloadTime>2</DownloadTime>
  <Status>S</Status>
</Response>

# Einen neuen HTTPS-Monitor über die Web-API erstellen
POST https://api.dotcom-monitor.com/config_api_v1/devices
Content-Type: application/json

{
  "name": "Checkout API — Produktion",
  "platform": "HTTPS",
  "tasks": [{
    "url": "https://shop.example.com/api/checkout",
    "method": "POST",
    "keyword": "order_id"
  }],
  "frequency": 60,
  "locations": ["NY-USA", "FR-PARIS", "SG"]
}

Beginnen Sie in 5 Minuten mit der Automatisierung Ihrer Überwachung

Jeder kostenpflichtige Plan beinhaltet vollen Zugriff auf die Web-API und XRS – keine Add-ons, keine Abrechnung pro Aufruf, keine zusätzliche Abrechnungsebene.

Anwendungsfälle

Was Teams mit der API bauen

Plattform-Teams, SREs und DevOps-Ingenieure nutzen die Dotcom-Monitor-API, um Monitoring in die Workflows zu integrieren, in denen sie bereits arbeiten.

Monitoring-as-Code

Versioniere jeden Monitor zusammen mit dem Service, den er schützt. Richte Geräte über deine bestehende Terraform- oder Pulumi-Pipeline ein, aktualisiere sie und stelle sie außer Betrieb – keine Abweichungen zwischen Staging und Produktion.

Post-Deploy Smoke Tests

Führe HTTPS- und mehrstufige Transaktionsprüfungen nach Bedarf aus Jenkins, GitHub Actions oder Azure DevOps nach jedem Deployment aus. Lass den Build fehlschlagen, wenn eine neue Version einen kritischen Endpunkt unterbricht.

Benutzerdefinierte Statusseiten & Dashboards

Speise XRS-Daten in kundenorientierte Uptime-Seiten, interne NOC-Anzeigen oder Executive-SLA-Berichte ein. Ziehe nur die gewünschten Felder, genau formatiert nach deinen Bedürfnissen.

SLA-Nachweise & Compliance-Berichte

Automatisiere monatliche SLA-Exporte (Uptime %, P95 / P99 Antwortzeit, Ausfallzeiten) direkt aus XRS in Excel oder PDF – dokumentiert, mit Zeitstempel und revisionssicher.

Massenbereitstellung von Geräten

Stelle Hunderte von Monitoren in einem Durchgang bereit nach Übernahmen, Migrationen oder CDN-Umstellungen. Klone bestehende Gerätevorlagen und weise die richtigen Gruppen, Zeitpläne und Alarmwege in großem Maßstab zu.

Einbettung von Dashboards Dritter

Leite Monitoring-Daten neben deiner anderen Telemetrie in Grafana, Power BI, Tableau oder Datadog – externe synthetische Checks korreliert mit internen APM-Traces.

Multi-Tenant Konto-Verwaltung

MSPs und Enterprise-Teams können Hunderte von Abteilungen und Tausende von Geräten in einem einzigen programmatischen Vorgang verwalten, mit abteilungsspezifischen XRS-Feeds für jeden Kunden.

Vorfallsanreicherung

Wenn ein Monitor feuert, rufen Sie automatisch den Waterfall-, Cipher- und Timing-Abbau über XRS ab und hängen Sie ihn an den PagerDuty- oder ServiceNow-Vorfall an – was die Triage-Zeit verkürzt.

XRS Deep-Dive

Echtzeit-Berichterstattung, genau so wie Sie es brauchen

Der XML Reporting Service ist ein flexibler, kostenloser Abruf-Feed auf Anforderung. Fordern Sie Zusammenfassungsdaten oder Rohantworten an. Filtern Sie nach Standort, Zeitplan oder Erfolgsstatus. Geben Sie nur die Felder zurück, die Sie interessieren.

Berichtstyp	Was Sie erhalten	Typische Verwendung
Kontonutzung	Verwendete und verfügbare Ressourcen pro Monitoring-Lösung	Lizenz- & Kapazitätsplanung, Abrechnungsausgleich
Gerätestatus	Aktueller Zustand & Status einzelner Geräte oder Sets	Live-Statusseiten, NOC-Wand-Dashboards
Antwortdetails	Hochgradig anpassbare Anforderungs-Timing & Inhalte	Detaillierte Diagnostik, benutzerdefinierte Waterfalls, Vorfallanreicherung
Geräte- & Aufgaben-Konfiguration	Exportierte Snapshots der Überwachungskonfiguration	Backups, Umgebung-übergreifende Klonung, Audit-Trails
Zusammenfassungsdaten	Betriebszeit, Ausfallzeit, Erfolgsanzahl, Fehleranzahl, Leistung, StDev	Management-Zusammenfassungen, SLA-Berichte
Rohantworten	Jedes Prüfergebnis für ein Gerät, bis zu 6 Monate zurück	Forensische Analyse, historische Vergleiche
Stündliche Aggregationen	Antwortdaten in 1-Stunden-Fenster gruppiert	Spitzenlast-Erkennung, stündliche Trendanalyse
Tägliche Aggregationen	Antwortdaten in 24-Stunden-Fenster gruppiert	Tägliche Betriebsüberprüfungen, Werktags- vs. Wochenendvergleiche
Wöchentliche / monatliche / jährliche	Zusammenfassungen über längere Zeiträume	Trends auf Vorstandsebene, Jahresvergleichsberichte
3-Monats-Statistiken	Statistische Daten berechnet über ein rollierendes 3-Monats-Fenster	Basislinien-basierte Warnungen, Anomalieerkennung

Jeder Bericht kann gefiltert werden nach Monitoring-Standort, Zeitplan, Dotcom-Monitor-Filter, Erfolgs- oder Fehlerstatus, Abteilung und benutzerdefiniertem Datumsbereich.

Warum Teams die API nutzen

Entwickelt für DevOps, SRE & Platform Engineering

Die Dotcom-Monitor-API entfernt manuelle UI-Klicks aus Ihrem Überwachungsworkflow, sodass Ihr Team die synthetische Abdeckung skalieren kann, ohne die Mitarbeiterzahl zu erhöhen.

Drift eliminieren

Behalten Sie die Überwachungskonfiguration in der Versionskontrolle. Wenden Sie dieselben Monitore mit Vertrauen in verschiedenen Umgebungen an.

Shift Monitoring Left

Fügen Sie synthetische Prüfungen im selben PR hinzu wie den Service, den sie abdecken. Monitoring wird mit dem Code bereitgestellt, nicht Wochen später.

Skalieren ohne Klicks

Führen Sie mit einem einzigen Skript hundert neue Domains oder tausend neue Endpunkte ein. Keine Klickmüdigkeit.

Granulare Sicherheit

Kurzlebige Sitzungen, optionale IP-Whitelist und abteilungsbezogene Integrationsschlüssel sorgen für eingeschränkten Zugang.

Passt zu jedem Stack

Einfaches HTTP + JSON (oder GET + XML für Berichte). Keine SDK-Bindung. Funktioniert mit jeder Programmiersprache und jedem CI/CD-Tool.

Kontrollieren Sie Ihre Daten

Ziehen Sie Ihre Monitoring-Daten nach Ihrem Zeitplan in Ihr eigenes Data Warehouse, Ihre BI-Plattform oder Ihr Compliance-Archiv.

Einheitliche Oberfläche

Eine API umfasst Monitoring und LoadView-Lasttests – kein separates Tool, keine separaten Zugangsdaten.

Keine Extrakosten

API- und XRS-Zugang sind in jedem kostenpflichtigen Plan enthalten. Keine Abrechnung pro Aufruf, keine Zusatzkosten für Automatisierung.

Was unsere Kunden sagen

"Eine der besten Funktionen von Dotcom sind die Push/Pull-API-Fähigkeiten, die uns Netzwerkleistungsdaten liefern. Wir nutzen dies, um Leistungsprobleme sowie Seitenladezeiten zu überwachen. Dotcom-Monitor ermöglicht es uns, mehrere Services innerhalb einer Benutzeroberfläche und Plattform zu überwachen. Das hat uns eine effizientere Arbeitsweise erlaubt."

Gregory S.

Manager, Broadcast Media · Verifizierte Capterra-Bewertung

Bereit, Ihr Monitoring auf Autopilot zu setzen?

Jeder 30-tägige Testzeitraum beinhaltet vollen Web API- und XRS-Zugang – plus jede Monitoring-Lösung, jeden Standort und jede Integration. Erleben Sie, wie sich automatisiertes Monitoring anfühlt.

Häufig gestellte Fragen

Häufige Fragen zur Dotcom-Monitor API

Was ist der Unterschied zwischen der Web API und XRS?

Die Web API (config_api_v1) ist eine JSON-basierte REST-Schnittstelle zum Erstellen und Verwalten der Überwachungskonfiguration — Geräte, Aufgaben, Gruppen, Zeitpläne, Warnungen und Lasttests. Der XML Reporting Service (XRS) ist ein separater kostenloser Feed, der Überwachungsergebnisse als XML über HTTP GET zurückgibt. Die meisten Teams nutzen beide: Web API zur Konfiguration, XRS zum Abrufen der Ergebnisse.

Wie authentifiziere ich mich bei der API?

Gehen Sie in Ihrem Dotcom-Monitor-Konto zu Verwalten > Integrationen > Neue Integration und erstellen Sie entweder eine Web API-Integration (für die Konfiguration) oder eine XML-Feed-Integration (für XRS). Jede Web API-Anfrage wird gegen diese Integration authentifiziert und Sitzungen laufen nach 60 Sekunden Inaktivität ab. XRS verwendet die generierte Account-UID als PID-URL-Parameter. Sie können den Zugriff auch auf IP-Adressen beschränken.

Welche Datenformate werden unterstützt?

Die Web API ist vollständig JSON-basiert — sowohl Anfrageinhalte als auch Antworten. Setzen Sie Content-Type: application/json, wenn Sie einen JSON-Body senden. XRS gibt XML-Dokumente über HTTP(S) GET zurück, daher ist die Anfrage nur eine URL mit Abfrageparametern.

Welche Überwachungstypen kann ich über die API konfigurieren?

Die Web API deckt jede Dotcom-Monitor-Überwachungsplattform ab: HTTPS, REST, SOAP, GraphQL, WebSocket, ServerView, BrowserView, UserView (EveryStep-Skripte) und MetricsView — sowie alle Protokollmonitore (DNS, SSL, E-Mail, FTP, ICMP Ping, TCP-Port, Traceroute, VoIP und mehr). Außerdem wird die vollständige LoadView-Lasttestoberfläche unterstützt.

Gibt es eine Ratenbegrenzung oder Kosten pro Aufruf?

API- und XRS-Zugriff sind in jedem kostenpflichtigen Plan enthalten — es gibt keine Abrechnung pro Aufruf und keine Zusatzgebühr. Sitzungen laufen nach 60 Sekunden Inaktivität ab, was lang laufende Skripte natürlich begrenzt. Wenn Sie IP-beschränkten Zugriff oder unternehmensweiten Durchsatz benötigen, wenden Sie sich an den Vertrieb bezüglich Enterprise-Optionen.

Wie weit zurück kann ich historische Daten über XRS abrufen?

XRS kann Rohantwortdaten für bis zu die letzten 6 Monate zurückgeben. Zusammenfassende und statistische Berichte (stündliche / tägliche / wöchentliche / monatliche / jährliche Aggregationen und 3-Monats-Statistiken) sind für längere Zeiträume verfügbar. Sie geben Start- und Enddatum/-zeit für jeden Bericht an.

Kann ich die API für CI/CD-Pipelines nutzen?

Ja — jedes Tool, das HTTP-Aufrufe durchführen kann, kann die API ansteuern. Teams integrieren häufig Jenkins, GitHub Actions, GitLab CI, Azure DevOps, CircleCI und Terraform, um Monitore bei Deployment bereitzustellen, nach der Veröffentlichung Smoke-Tests durchzuführen und Produktionsrollouts basierend auf Überwachungsgesundheit zu steuern.

Kann ich den API-Zugriff auf bestimmte IP-Adressen beschränken?

Ja. Wenn Sie eine Web API-Integration erstellen, können Sie den Zugriff für alle authentifizierten Anfragen erlauben oder den Zugriff auf eine Liste vertrauenswürdiger IP-Adressen beschränken. Details finden Sie im Artikel Wie man IPs für den Web API-Zugriff auf die Whitelist setzt in der Knowledge Base.

Unterstützt die API Multi-Department- oder MSP-Konten?

Ja. Benutzer eines Root-Kontos können Abteilungen programmatisch verwalten, und eine XML-Feed-Integration kann auf bestimmte Abteilungen beschränkt werden. Abteilungsbeschränkte Benutzer können XRS-Berichte nur für ihre eigene Abteilung abrufen, was eine saubere Trennung für MSPs und Multi-Tenant-Setups unterstützt.

Wo finde ich vollständige Dokumentation und Codebeispiele?

Die vollständige Dokumentation befindet sich in der Dotcom-Monitor Knowledge Base, einschließlich des Getting Started with the API-Leitfadens, der Überwachungs- und LoadView-Methodenreferenzen mit JSON-Beispielen und der XRS-Anfrageparameterreferenz. Fertige Codevorlagen sind im Abschnitt Code Beispiele verfügbar.

Überwachung automatisieren.Ingenieurszeit zurückgewinnen.

Schließen Sie sich über 10.000 Organisationen an, die Dotcom-Monitor nutzen, um Ausfälle zu erkennen, bevor Kunden es tun — und die API und XRS verwenden, um diese Abdeckung mühelos zu verwalten.