Anleitungen›Monitore erstellen

Monitore erstellen

Monitore sind die Kernressource in DiffHook. Jeder Monitor überwacht eine URL und löst Ereignisse aus, wenn sich der Inhalt ändert.

Erforderliche Felder

Feld	Typ	Beschreibung
`label`	Zeichenfolge	Kurzname für den Monitor
`url`	Zeichenfolge	Die zu überwachende URL

interval_minutes – Wie oft überprüft werden soll (optional; es gelten Standardeinstellungen). Gültige Werte sind 5, 15, 30, 60, 360, 1440 (Minuten).

notification_config – Optionales JSON-Objekt mit Überschreibungen pro Monitor, z. B. { "webhook_url": "https://…", "email": "alerts@…" }. Wenn es weggelassen wird, wird der Standard-Webhook des Arbeitsbereichs von Integrationen für die HTTP-Übermittlung verwendet.

Optionale Felder

label – Ein für Menschen lesbarer Name, der im Dashboard angezeigt wird. Standardmäßig wird die URL verwendet.

css_selector – Filtern Sie den Diff auf ein bestimmtes DOM-Element. Reduziert Rauschen von Navigationsleisten, Cookie-Bannern und anderen Standardelementen.

{
  "css_selector": "#pricing-table"
}

js_rendering – Verwenden Sie einen Headless-Chromium-Browser, um die Seite zu rendern, bevor Sie einen Schnappschuss erstellen. Erforderlich für React/Vue/Angular-Apps, die Inhalte clientseitig rendern. Langsamer und ressourcenintensiver – nur aktivieren, wenn die Seite tatsächlich JavaScript benötigt, um ihren Inhalt anzuzeigen.

JSON-Selektor für die JSON-API

JSON-API-Monitore können die Differenzierung auf ein bestimmtes Feld oder eine bestimmte Liste beschränken, indem sie json_selector festlegen.

Unterstützte Selektorformate:

$ → Root-Objekt
$.field → ein Feld im Stammverzeichnis
$.a.b.c → verschachteltes Feld
$.items[*] → Array-Feld ([*] ist optional und wird als Array selbst behandelt)

Verwenden Sie identity_key, wenn Ihr Selektor in ein Array von Objekten aufgelöst wird. Dadurch werden Elemente vor der Differenzierung nach einem stabilen Schlüssel sortiert, wodurch laute Differenzen vermieden werden, die nur auf die Neuordnung beschränkt sind.

{
  "json_selector": "$.items",
  "identity_key": "id",
  "track_additions_only": true
}

Beispiel: Überwachung einer Preisseite

Interaktives Anforderungsbeispiel (aus der OpenAPI-Spezifikation – Sprache wechseln, kopieren oder Probieren Sie es aus):

Aktualisieren eines Monitors

Sie können jedes veränderbare Feld mit einer PUT-Anfrage aktualisieren. Nur bereitgestellte Felder ändern sich:

Einen Monitor anhalten

Durch das Anhalten eines Monitors wird die Abfrage gestoppt. Pausierte Monitore werden nicht auf das Planlimit angerechnet – weder auf die Monitoranzahl noch auf das monatliche Prüfbudget. Daher ist das Anhalten das richtige Werkzeug, wenn Sie einen Monitor vorübergehend anhalten möchten, ohne seine Konfiguration zu verlieren oder einen permanenten Steckplatz freizugeben.

Nützliche Szenarien: Wartungsfenster, saisonale Arbeitsabläufe oder wenn Sie Ihr Prüfbudget fast erreicht haben und Kapazität freigeben möchten, ohne einen Monitor zu löschen.

Fortsetzen eines Monitors

Durch das Fortsetzen wird ein angehaltener Monitor erneut aktiviert. DiffHook validiert die Plangrenzen zum Zeitpunkt der Wiederaufnahme. Wenn die Wiederaufnahme dazu führen würde, dass Sie die Anzahl Ihrer aktiven Monitore, Ihr monatliches Prüfbudget oder Ihr JS-Rendering-Prüfbudget überschreiten, wird die Anfrage mit einem 403 abgelehnt. Aktualisieren Sie Ihren Plan oder pausieren Sie zuerst einen anderen Monitor.