Push Services/de

From meteobridge
Revision as of 21:08, 2 October 2014 by Admin (Talk | contribs)

Jump to: navigation, search

<languages />
Meteobridge stellt eine Reihe von individualisierbaren Sendedienste zur Verfügung, die auf verschiedene Arten Wetterdaten an andere Systeme per E-Mail, Twitter, HTTP-Anfragen, FTP-Uploads, MYSQL-Befehle oder durch die lokale Ausführung von Skripten weiterleiten können. All diese Dienste können zu festen Zeitpunkten, in regelmäßigen Intervallen, die von wenigen Sekunden über Minuten bis hin zu Stunden definiert sind, oder durch das Eintreten von Alarmbedingungen ausgelöst werden.

Die Konfiguration der Sendedienste erfolgt in zwei Schritten.

  1. Wenn an E-Mail, Twitter, MYSQL oder FTP verwenden möchte, müssen zunächst entsprechende Athetifizierungen durchgeführt werden, damit diese Dienste genutzt werden können.
  2. Anschliessend können spezifische Sendeereignisse definiert werden, die sich dieser vorkonfigurieten Sendedienste bedienen.

Wenn man erstmalig auf diesen Reiter geht, sind noch keine Ereignisse definiert und die Sendedienste erwarten die notwendigen Konfigurationseingaben.

Page6de.png


Konfiguration der Sendedienste

Die Sendedienste Twitter, E-Mail, MYSQL und FTP erfordern eine initiale Konfiguration bevor Eregisse definiert werden können.

Konfiguration von Twitter

Meteobridge ermöglicht Wetterdaten an Twitter zu senden. Dazu muss die Meteobridge sich zunächst gegenüber Twitter authentifizieren. Dies erfolgt in 5 Schritten:

1. Die Taste "PIN anfordern" drücken

Twitter0de.png

2. In dem neu erscheinenden Fenster muss dem man sich mit seinem Twitter-Account anmelden

Twitter2de.png

3. Dort anmelden und die von Twitter bereitgestellte PIN kopieren

Twitter2b.png

4. PIN in das Feld neben "PIN Aktivieren" eingeben und den Knopf drücken

Twitter4de.png

5. Wenn die PIN akzeptiert wurde, erscheint der Hinweis "Authentifizierung: erfolgt"

Twitter3de.png

Meteobridge ist nun bereit, ereignisgesteuert Nachrichten an Twitter zu senden.

Konfiguration von E-Mailing

Meteobridge kann individuelle E-Mails in definierten Zeitintervallen oder beim Eintritt eines Ererignisses senden. Um diesen Dienst zu aktivieren, müssen die folgenden Einstellungen vorgenommen werden:

  • Authentifizierung: Dieses drop-down Menu erlaubt die Auswahl der Authentifizierungsmethode. Es kann zwischen folgenden Einstellungen gewählt werden:
    • keine: Der SMTP-Server wird ohne weiter Authentifizierung kontaktet. Diese Zugriffsart gestatten SMTP-Server nur sehr selten und dann auch nur in geschlossenen LANs, da sie sonst als offene Spam-Relays missbraucht werden können.
    • basis: Ist die klassische Benutzername/Passwort-Authentifikation, die ohne Verschlüsselung dieser Daten auskommt. Zunehmend weniger SMTP-Server erlauben diese gering geschütze Zugriffsart.
    • tls: Ist eine Authentifizierung mit SSL-Verschlüsselung. Diese Variante der SSL-Verschlüsselung wird allerdings selten von SMTP-Servern verwendet.
    • starttls: Ist inzwischen die am Häufigsten genutze Zugangsart, die sowohl Zugangs- wie Nutzdaten per SSL verschlüsselt.
  • SMTP-Server: gibt die IP des oder den Namen des SMTP-Servers an, an den die ausgehenden Mails gesendet werden.
  • Port: Spezifiziert die Port-Nummer auf der der SMTP-Server auf zur Weiterleitung bestimmte E-Mail lauscht. Standard-Ports sind 25 für non-SSL-Verbindungen und 587 für SSL-verschlüsselte Kommunikation.
  • Name: Benutzername zur Authentifizierung
  • Passwort: Passwort zu Authentifizierung
  • Empfänger: E-mail-Adresse, die als Empfänger der Mail fungieren soll.
  • Absender: E-mail-Adresse, die als Absender der Mail fungieren soll. Viele SMTP-Server verlangen, dass die Absenderadresse in der dem Server zugeordneten Domain liegt und verweigern sonst den Versand, um Spamming zu verhindern.

Email0de.png

Mit dem "Test"-Knopf wird eine E-Mail mit dem Betreff "Meteobridge Test" an die angegebenen Empfänger-Adresse gesendet. Man kann admit prüfen, ob die AMTP-Konfiguration funktioniert. Wenn ein Fehler auftritt, wird eine entsprechende Systemmeldung eingeblendet.

MYSQL Konfiguration

Wenn man Wetterdaten gerne in eine MYSQL-Datenbank speichern möchte,bietet sich dieser Sendedienst an. Die folgenden Angaben sind erforderlich:

  • Server: Servername oder IP des Servers (wenn DNS den Namen nicht auflösen kann)
  • Port: Portnummer, unter der die MYSQL-Datenbank Verbindungen annimmt.
  • Datenbank: Name der Datenbank, in die Werte gespeichert werden sollen.
  • Benutzer: Name des Benutzers, unter dem sich Meteobridge an der Datenbank anmelden soll.
  • Passwort: Passwort des benutzers für die Datenbank.

Mysqlde.png

Wenn keine MYSQL Dienste konfiguriert und keine Ereignisse für diesen Dienst definiert sind, entfernt Meteobridge die speicherintensiven MYSQL-Bibliotheken während des Boot-Vorgangs, um mehr Raum für andere Dienste zu haben. Dies wird durch den orangenen Hinweis "inaktiv" angezeigt. Man kann trotzdem MYSQL Dienste konfigurieren, doch erfordert es nach dem Speichern einen Neustart damit die notwendigen Bilbliotheken neu geladen werden und der MYSQL Dienst einsatzbereit ist.

FTP Konfiguration

Meteobridge erlaubt die Definition eines FTP-Servers, der zum Hochladen von Daten verwendet werden kann. Es kann nur ein FTP-Server definiert werden, aber jedes Sendeereignis kann individuelle Ordner auf diesem Server ansprechen.

  • FTP-Server: Servername oder IP des Servers
  • Port: Port-Nummer des FTP-Dienstes auf dem Server
  • Benutzer: Benutzername, der für den FTP-Upload verwendet werden soll.
  • Passwort: Mit dem Benutznamen verbundenes Passwort

Ftpde.png

Um zu testen, ob die FTP Login-Daten funktionieren, kann man die Taste "Hochladen Testen" drücken. Meteobridge wird versuchen eine Datei Namens "test-upload" mit dem aktuellen zeitstempel als Inhalt auf den FTP-Server unter dem angegebenen Testpfad abzulegen. Wenn kein testpfad angegeben wird, speichert Meteobridge die Datei im auf dem FTP-Server für diesen Benutzer voreingestellten Verzeichnis. Der angegebene Testpfad wird nur für diesen Hochlade-Test verwendet.

Wenn Daten auf einen anderen FTP-Server geladen werden sollen, kann die voll qualifizierte, URL-ähnliche FTP-Notation im Feld "Pfad" eingegeben werdem. Das Format der FTP URI lautet: ftp://user:password@host:port/path. Man beachte bitte, dass keines dieser Elemente fehlen darf. Beispiel: ftp://johndoe:mysecret@ftp.server.com:21/public_html/index.html

Definition von Sendeereignissen

Meteobridge kann bis zu 20 Sendeereignisse definieren, die die konfigurierten Sendedienste verwenden. Die definierten Sendeereignisse werden oben auf der Seite angezeigt.

Das Hinzufügen eines Sendeereignisses ist sehr einfach. Man wählt zunächst aus dem "Dienst auswählen" Drop-Down Menu.

Event0de.png

Dann bestimmt man den Ereignistyp und fügt das so spezifizierte Sendeereignis durch Drücken der "Sendeereignis hinzufügen" Taste hinzu.

Event1de.png

Danach erscheint das neu definierte Sendeereignis in der Eregnisliste und man kann die Details dieses Eregnisses einstellen. Jede Ereignisdefinition besteht aus einem Bereich, in dem die die Auslösebedingungen für das Ereignis beschrieben werden, und einem Bereich, in dem die eigentliche zu transportierende Information angegeben wird.

Ereignistypen

Meteobridge kennt drei unterschiedliche Ereignistypen, die auf alle Sendedienste angewendet werden können.

Periodisch

Dies erlaubt eine zeitgesteuerte, wiederkehrende Ausführung von Ereignissen. Die dazu verwendeten Zeitintervalle können je nach gewähltem Dienst wenige Sekunden bis hin zu Minuten und Stunden sein. Die Auswahl des Zeitintervalls erfolgt durch das entsprechende Drop-Down Menu.

Event2de.png

Uhrzeit

Hier kann eine Zeit angegeben werden, an der täglich die Aktivierung des Ereignisses erfolgt. Die Auswahl wird per Drop-Down Menu im 15 minütigen Raster getroffen.

Event3de.png

Alarm Bedingungen

Meteobridge ermöglicht die Definition von Alarmbedingungen, die das Auslösen und Rücksetzen von Alarmen erlauben und damit verknüpfte Sendeereignisse steuern.

Event4de.png

Man kann in Meteobridge zwischen "Einmalalarm" und "inkrementelle Alarme" wählen. Beim "Einmalalarm" wird bei Erfüllen einer Auslösebedingung nur einmal das damit verbundene Ereignis ausgeführt. Es bedarf dann des Eintretens der Rücksetzbedingung, um eine erneute Alarmauslösung zu ermöglichen. Bei inkrementellen Alarmen wird ein Ereignis beim erstmaligen Zutreffen der Auslösebedingung aktiviert. Wird danach die Auslösebedingung erneut erfüllt und die Alarmierungsschwelle noch deutlicher überschritten als zuvor, erfolgt eine erneute Ereignisauslösung.

  • Auslösebedingung: definiert die Bedingung die in Form einer Ungleichung oder Gleicung erfüllt sein muss, damit der Alarm ausgelöst wird. Details zur Formulierung von Bedingungen sind im folgenden Abschnit "Bedingungen" beschrieben.
  • Rücksetzbedingung: definiert die Bedingung die zum Zurücksetzen der Alarmierung erfüllt sein muss. Details zur Fomulierung der Bedingungen sind im folgenden Abschnitt "Bedingungen" beschrieben.

Es gibt zwei Arten von Bedingungen im Kontext von Alarmdefinitionen, die unterschiedliche Bedeutung haben aber exakt gleich aufgebaut sind. Wenn eine "Auslösebedingung" erfüllt ist, wird das damit gekoppelte Ereignis ausgelöst. Um eine erenute Auslösung dieses Ereignisses zu ermöglichen, muss zuvor der die "Rücksetzbedingung" erfüllt sein. Die Idee dahinter ist, eine Flut von nachfolgenden Ereignisauslösungen zu einem Ereignis, das bereits gemeldet wurde, zu vermeiden. Wenn zum Beispiel die Auslösebedingung "Außentemperatur mindestens 35°C" und Rücksetzbedingung "Außentemperatur unter 30°C" mit einer Temperaturauflösung von einem Grad angegeben sind, wird eine Nachricht ausgelöst, wenn die Temperatur über 35°C steigt aber es werden keine Nachrichten gesendet, wenn die Temperatur weiter steigt. Wurde aber die Einstellung "inkrementelle Alarme" gewählt und die Temperatur steigt auf bis zu 37.2!C, dann werden Alarme bei 35°C, 36°C und 37°C ausgelöst. Man kann in diesem Fall per Alarmauslösung einen weiteren Anstieg über den Schwellwert verfolgen.

Bedingungen

Bedingungen können mehrere Operatoren und Klammern enthalten. Wetterdaten werden durch Meteobridge-Variable repräsentiert, wie im Abschnitt Templates erläutert. Die Variablen können in rechteckige Klammern eingebettet sein ([th0temp-act=F.0:0]) oder ohne Klammern verwendet werden (th0temp-act=F.0:0). Beim Verzicht auf eckige Klammern sollten diese vor und hinter der Variable durch ein Leerzeichen vom arithmetischen Ausdruck abgetrennt sein. Definierte Operatoren sind:

operators in increasing precedence (from top to bottom)
Operator Description
&&, ||, &, | logical "and", "or" operators working on value range: 1=true, 0=false
==, =, !=, <>, >, >=, <, <= comparison operations working on value range: 1=true, 0=false
+, - arithmetic operators "plus" and "minus"
*, / arithmetic operators "multiply" and "divide"
^ arithmetic operator "power"

Result of the expression is interpreted as a boolean. Values above zero are regarded "true", values below or equal zero are regarded "false". When "incremental alarm" is specified, Meteobridge compares new value with former value and does trigger an alarm, when new value is bigger then the one that has triggered an alarm before.

Examples:

  • [rain0total-sumday=mm:0] - 10
    triggers an alarm when todays rain exceeds 10mm. When alarm mode is set to "incremental alarm", every time rain increases above 10mm, a new alarm will be triggered. This happens because the expression does not return a boolean, but a value that regarded "true" when result is above zero (here, 10mm rain fall). Further increases will keep the condition "true" but will also increment the number and therefore, will fire additional alarms.
  • [wind0wind-act=kmh.1:0] > 20 && ([wind0dir-act:180] >= 315 || [wind0dir-act:180] <= 45)
    triggers an alarm when non-averaged wind speed is more than 20 km/h and wind direction is mainly North (NW-NNW-N-NNE-NE).

Löschen von Ereignisdefinitionen

Um eine Ereignisdefinition zu löschen, muss lediglich "Löschen" aus dem Drop-Down Menu am linken Rand der Ereignisdefinition ausgewählt werden und diese Einstellung mit "Speichern" der Seite bestätigt werden.

Event5de.png

Twitter Ereignis

Wenn ein Twitter Ereignis definiert wird, muss ein Nachrichtentext angegeben werden, der Meteobridge Template-Variable enthalten darf. Das anhängende beispiel sendet täglich mittags eine Twitter-Nachricht, die die Außentenperatur in Grad Celsius enthält.

Event6de.png

Email Event

When you define an email event you have the fill the mandatory email body text field. If the optional "Addr.-To" field is left blank, then the email address from the email service definition at the bottom of the tab is used as default. Body text field is not allowed to make use double quotes (") but single quotes (') can be used. A maximum of 4000 characters can be used in the email body.

Event7de.png

Im vorangegangenen Beispiel wird eine E-Mail mit einem Betreff ähnlich "Wetter um 11:23" und einem Nachrichtentext ähnlich der folgenden Zeilen versendet.

Temp 12.3°C
Boe 6.7kmh

FTP Ereignis

Die zum Hochladen per FTP bestimmten Daten können wegen der zu geringen Speicherkapazität nicht permantent auf der Meteobridge gespeichert werden. Daher müssen sich die mit Wetterdaten zu füllenen Template-Dateien auf einem externen Server befinden, von dem Meteobridge die Templates per Aufruf einer URL laden kann. Sobald die URL angegeben ist, sollte das Template mit der Taste "Template Laden" temporär auf die Meteobridge geladen werden. Dies ist erforderlich, um dann bei der Ereignisauslösung die Wetterdaten in dieses geladene Template einzusetzen. Um das gefüllte Template auf dem FTP-Server speichern zu können sind die Eingaben eines Dateipfades und -namens erforderlich.

FTP Instrumententafel Beispiel

Event8de.png

Das obige Beispiel verwendet eine vordefinierte HTML-Datei und füllt dieses Template alle 10 Minuten ,it aktuellen Wetterdaten und lädt die Datei dann unter dem Dateipfad- und namen "/public_html/dashboard.html" auf den angegebenen FTP-Server. Die Datei "dashboard.html" ist eine einfache HTML-Datei mit einigen enthaltenen Meteobridge Wetter-Variablen. Wenn man sich die mit Daten gefüllte Datei "dashboard.html" mit einem Browser ansieht, wir sie etwa wie folgt aussehen:

Mydash.png

Details über die Verwendung von Variablen in Templates finden sind in der Templates Sektion dieses Wikis. Im anhängenden Quellkode dieses Templates, das die Verwendung von Variablen illustrieren soll, wurden lediglich die CSS-Styles der einfacheren Lesbarkeit halber weggelassen:

<body>
  <table id="table-2">
    <thead><tr><th>Sensor</th>
               <th>Current</th>
               <th>Today (min)</th>
               <th>Today (max)</th></tr></thead>
    <tbody>
      <tr><td>Outdoor Temperature</td>
          <td>[th0temp-act.1:--]° C</td>
          <td>[th0temp-dmin.1:--]° C</td>
          <td>[th0temp-dmax.1:--]° C</td></tr>
      <tr><td>Outdoor Humidity</td>
          <td>[th0hum-act.0:--] %</td>
          <td>[th0hum-dmin.0:--] %</td>
          <td>[th0hum-dmax.0:--] %</td></tr>
      <tr><td>Outdoor Dew Point</td>
          <td>[th0dew-act.1:--]° C</td>
          <td>[th0dew-dmin.1:--]° C</td>
          <td>[th0dew-dmax.1:--]° C</td></tr>
      <tr><td>Wind Chill Temperature</td>
          <td>[wind0chill-act.1:--]° C</td>
          <td>[wind0chill-dmin.1:--]° C</td>
          <td>[wind0chill-dmax.1:--]° C</td></tr>
      <tr><td>Air Pressure</td>
          <td>[thb0seapress-act.1:--] hPa</td>
          <td>[thb0seapress-dmin.1:--] hPa</td>
          <td>[thb0seapress-dmax.1:--] hPa</td></tr>
      <tr><td>Wind Direction</td>
          <td>[wind0dir-act.0:--]°</td>
          <td></td><td></td></tr>
      <tr><td>Wind Speed (averaged)</td>
          <td>[wind0avgwind-act.1:--] m/s</td>
          <td>[wind0avgwind-dmin.1:--] m/s</td>
          <td>[wind0avgwind-dmax.1:--] m/s</td></tr>
      <tr><td>Gust Speed</td>
          <td>[wind0wind-max5.1:--] m/s</td>
          <td>[wind0wind-dmin.1:--] m/s</td>
          <td>[wind0wind-dmax.1:--] m/s</td></tr>
      <tr><td>Rain</td>
          <td>rate: [rain0rate-act.1:--] mm/h</td>
          <td>sum [rain0total-sumday.1:--] mm</td>
          <td></td></tr>
      <tr><td>Solar Radiation</td>
          <td>[sol0rad-act.0:--] W/qm</td>
          <td>[sol0rad-dmin.0:--] W/qm</td>
          <td>[sol0rad-dmax.0:--] W/qm</td></tr>
      <tr><td>UV Index</td>
          <td>[uv0index-act.1:--] uvi</td>
          <td>[uv0index-dmin.1:--] uvi</td>
          <td>[uv0index-dmax.1:--] uvi</td></tr>
    </tbody>
  </table>
</body>


Saratoga Template Beispiel

Event13de.png

Saratoga Template-Upload

Meteobridge kann die bekannten Saratoga-Templates bedienen, die einfach auf einer Homepage zu installieren sind und umfangreich und übersichtlich über die Wettersituation Auskunft geben. Wie die Installation genau vorzunehmen ist und Meteobridge eingerichtet werden muss ist detailliert hier beschrieben.

Wenn die Wetterseite mit den Saratoga-Templates aufgesetzt ist, wird sie in etwa so aussehen:

Saratoga.png

FTP Kamera Ereignis

Wenn Meteobridge Bilder einer Webcam oder einer Ubiquiti AirCam verwendet, können diese ebenfalls per FTP hochgeladen werden. Um Speicherung von Serienbildern zu ermöglichen, können Datums- und Zeitinformationen in den Pfad- und Dateinamen entsprechend der GNU C "strftime"-Syntax eingebaut werden.

Event9de.png

Das vorangegangene Beispiel speichert alle 10 Minuten ein Webcam-Bild und gibt diesem einen Dateinamen, der das aktuelle Datum und die aktuelle Zeit beinhaltet, wie z.B. "2014-06-23_12:34_weatherpic.jpg". Detail zur "strftime"-Syntax finden sich hier.

HTTP Ereignis

Meteobridge kann HTTP GET Anfragen senden, die Wetterdaten als URL-Parameter enthalten. Dieses kann beispielsweise zur Speisung individueller Wetternetzwerke verwendet werden. Neben der notwendigen URL kann optional auch eine Erfolgszeichenkette angegeben werden. Diese zeichenkette vergleicht Meteobridge mit der Antwort, die der Server auf die gesendete HTTP-Anfrage zurückgibt.

  • Wenn die Erfolgszeichenkette leer ist, wird die Antwort des Servers nicth ausgewertet.
  • Wenn die Erfolgszeichenkette nicht leer ist, wird geprüft, ob diese Seichenkette in der Antwort des Servers entahlten ist. Falls ja, wird die Übertragung als erfolgreich betrachtet.
  • Wenn die Erfolgszeichenkette mit einem Ausrufezeichen "!" beginnt, wird die Übertragung als erfolgreich angeshenen, wenn der Rest der Zeichenkette nicht in der Antwort des Servers enthalten ist.

Event10de.png

Im obigen Beispiel sendet Meteobridge die aktuelle Windgeschwindigkeit alle 15 Sekunden an den angebenen Server und betrachtet die Übertragung als erfolgreich, wenn die Antwort des Servers nicht die Zeichkette "Error" enthält.

MYSQL Ereignis

Meteobridge kann Anfragen an MYSQL Datenbanken senden und somit die Speicherung von live Daten in eine reguläre datenbank unterstützen. Das Pflichtfeld "Anfrage" enthält das auszuführende MYSQL-Kommando, welches typischer Weise ein parametriertes "INSERT" zum Einfügen von Datensätzen in eine Tabelle der Datenbank sein wird.

Event11de.png

Das Beispiel fügt die aktuelle Temperatur und die gemittelte Windgeschwindigkeit alle 10 Minuten in die Tabelle "upload" der angeschlossenen MYSQL-Datenbank ein.

Skriptausführungsereignis

Meteoridge kann Shell-Skripte voneiner URL laden und ausführen. Wenn ein neues Ereignis dieses Typs definiert wird, bitte zunächst die URL eingeben, unter der das Skipt gespeichert ist, und die Taste "Skript Laden" drücken. Das Parametereingabefeld ist optional und kann leer gelassen werden, wenn das Skript keine weiteren Aufrufparameter benötigt. Meteobridge betrachtet die erste Zeile des Skriptes, die mit der Zeichenkette "###" beginnt, als Kurzdokumentation des Skriptes und zeigt diese in der Ereignisdefinition als Informationstext an.

Event12de.png

Die obigen Einstellungen führen das unter "http://templates.meteobridge.com/reboot.sh" im Internet abgelegte Skript jeden Tag um 23:45 aus. Es werden keine weiteren Parameter an das Script übergeben. Das Skript enthält eine Dokumentationszeile, die im Skript durch drei vorangestellte "#" gekennzeichnet ist. Das Beispielskript führt einen Reboot der Meteobridge aus.

#!/bin/sh
#
### reboot Meteobridge; no parms
reboot
exit 0