Dryad
Dieses Plugin kann Alarme von Dryad verarbeiten
Konfiguration
Feldname | Erläuterung |
|---|---|
ID | Nur notwendig bei Verwendung der MQTT-Schnittstelle. Geben Sie hier die ID an, welche Sie von Dryad erhalten haben. Außerdem für den Zugriff auf deren MQTT-Broker die Adresse, den Port, Benutzername und Passwort. Diese Daten erhalten Sie von Dryad. Die Verwendung der Webhooks ist der Verwendung von MQTT vorzuziehen. |
Broker | |
Port | |
Benutzername | |
Passwort | |
Einheiten | Wählen Sie hier die Einheiten aus, welche bei eines eingehenden Alarms alarmiert werden sollen. |
Webhook-Zugriffschlüssel | Diesen Zugriffschlüssel benötigen Sie für die Konfiguration der Webhooks |
Sensoren | Hier sehen Sie eine Liste der gespeicherten Sensoren. Ein neuer Sensor wird hinzugefügt, wenn dessen Meldungen zum ersten Mal eingehen. Sie können diese Sensoren hier auch wieder löschen. |
Maximales Alter Sensorwerte vor Störung | In welchem Intervall ein Sensor mindestens einmal Daten liefern muss, bevor er als offline zählt. |
Mehr-Sensoren-AuslösungAktuell nur bei Webhook-Verwendung möglich | |
Radius (in Meter) für Mehr-Sensoren-Auslösung | Wenn mehr als ein Sensor innerhalb kurzer Zeit (einstellbar via Zeitdauer (in Sekunden) für Mehr-Sensoren-Auslösung) auslöst, kann diese Information im Alarm zur Verfügung gestellt werden. Durch die Einstellung der Entfernung kann bestimmt werden, wie nah Sensoren zusammen liegen sollen, sodass diese als gemeinsame Auslösung erkannt werden. Diese Information steht dann im Alarm in verschiedenen Parametern zur Verfügung. |
Zeitdauer (in Sekunden) für Mehr-Sensoren-Auslösung | Wie alt die Alarme sein dürfen, um als Mehr-Sensor-Auslösung zu gelten. Maximal 60 Minuten. |
Webhooks
Wenn Sie Dryad mit Webhooks verwenden möchten, so müssen Sie für jeden der drei unterstützen Datentypen einen eigenen Endpoint unter API Integrations > Endpoints anlegen.
Die zu hinterlegenden Endpunkte lauten wie folgt:
Event Typ | Endpunkt |
|---|---|
|
|
|
|
|
|
FE2_HOST ist hierbei die vollständige, über das Internet erreichbare URL Ihres FE2-Systems.
Für jeden Endpunkt müssen Sie eine Authentifizierung angeben. Hierfür können Sie im Bereich Advanced einen Custom Header angeben. Dieser lautet:
| Als Wert geben Sie hier den Webhook-Zugriffschlüssel aus dem Alarmeingang an. |
Beispiel
Webhooks via Polling
Webhook via Polling erlaubt es, auf die Dryad-API zuzugreifen, ohne dass FE2 im Internet erreichbar sein muss.
Das Polling-Intervall beträgt 5 Sekunden.
Hierfür legen Sie lediglich einen neuen Endpoint vom Typ Polling Endpoint an:
Innherhalb vom Dryad-Alarmeingang können Sie im Bereich Optionales unter Webhook-Polling Endpoint die URL eintragen:
Geben Sie hier die ganze unter Polling Endpoint angezeigte URL an.
Anschließend müssen Sie einen API-Key in Dryad für diesen Endpunkt erstellen und ebenfalls im Alarmeingang unter Webhook-Polling API-Key hinterlegen.
Denken Sie daran, den API-Key im FE2 zu aktualisieren, bevor dieser abläuft!