CaryvaneHilfe
/
DE

Benachrichtigungen und Webhooks

Caryvane verschickt die Meldungen selbst; es gibt keinen Mailserver einzurichten. Sie wählen, worüber Sie informiert werden, wohin, und welche Jobs und Rechner still bleiben dürfen.

Einrichten #

  1. Benachrichtigungen in der Konsole (pro Kunde). Fügen Sie eine oder mehrere E-Mail-Adressen hinzu.
  2. Ereignisse wählen (unter Benachrichtigungsauslöser): Job erfolgreich abgeschlossen (meist aus – das erzeugt viele Meldungen), Job fehlgeschlagen, Job mit Warnungen abgeschlossen (die Ausführung endete, aber etwas blieb zurück, etwa eine nicht lesbare Datei; wiederholt sich jede Nacht, solange die Ursache besteht), Agent geht offline und Starttest fehlgeschlagen. Auch ein Speicherziel, dessen Zugangsdaten nicht mehr funktionieren, löst eine Meldung aus.
  3. Test senden prüft den Weg, bevor Sie sich darauf verlassen.

Webhooks #

Geben Sie eine URL und einen HMAC-Signaturschlüssel ein. Jedes Ereignis wird per POST als JSON gesendet – Ereignistyp, Kunde, Job oder Agent, Status, Meldung und Zeitpunkt –, mit einem HMAC-SHA256 des Inhalts im Header X-Aurawolf-Signature, berechnet mit dem Schlüssel, sodass der Empfänger prüfen kann, dass der Aufruf von Caryvane stammt. PSA- und Ticketsysteme, die eingehende Webhooks annehmen (oder ein kleines Relay), können so bei Fehlern Tickets eröffnen. Test senden sendet ein Beispielereignis.

Stummschalten #

Ein Job, der erwartungsgemäß jede Nacht warnt (ein Ordner mit EFS-Dateien, die niemand entschlüsseln wird), und ein Laptop, der jedes Wochenende aus ist, würden sonst die echten Meldungen übertönen. Benachrichtigungen für diesen Job stummschalten im letzten Schritt (Fertig), wenn Sie den Job bearbeiten, und Benachrichtigungen… im Menü des Agenten setzen die kundenweiten Einstellungen für genau dieses eine Element außer Kraft. Die Ausnahmen werden auf der Seite Benachrichtigungen aufgelistet (Ausnahmen pro Job / pro Agent), damit sie nicht in Vergessenheit geraten.

Was „offline“ bedeutet #

Ein Agent ist online, solange er sich innerhalb von 90 Sekunden gemeldet hat. Die Offline-Meldung kommt, wenn ein Rechner, der online war, sich nicht mehr meldet und wegbleibt – nicht bei jedem Zuklappen eines Laptops. Rechner, die berechtigterweise nur zeitweise laufen, sollten stummgeschaltet und nicht einfach hingenommen werden.

Für MSPs #

Benachrichtigungen gelten pro Kunde: Ein MSP erhält Meldungen für jeden Kunden, auf dessen Seite Benachrichtigungen die Adresse des MSP steht. Für einen einzigen Strom über alle Kunden richten Sie den Webhook jedes Kunden auf denselben Endpunkt und verteilen anhand des Kundenfelds in der Nutzlast.