Monitoring Integration

Verbinden Sie Ihr Monitoring-System (Nagios, Zabbix, Icinga, etc.) mit TeamMessage. Erhalten Sie kritische Alarme per SMS oder Sprachanruf – auch wenn E-Mail ausfällt.

Warum SMS für Monitoring?

Wenn Ihre Server oder Ihr Netzwerk ausfallen, erreichen E-Mail-Benachrichtigungen Sie oft nicht. SMS bietet einen unabhängigen Kanal, der auch bei Ausfällen funktioniert:

• Unabhängig von Ihrer Infrastruktur – SMS funktioniert, wenn Ihr Mailserver ausfällt
• Sofortige Zustellung – keine Verzögerung durch E-Mail-Warteschlangen oder Spam-Filter
• Immer erreichbar – Alarme kommen auch ohne Internetzugang an
• Sprachanrufe für kritische Alarme – das Telefon klingelt, bis jemand abnimmt

Integrationsmethoden

TeamMessage unterstützt mehrere Integrationsoptionen für Monitoring-Systeme:

E-Mail-Gateway

Die einfachste Methode – konfigurieren Sie Ihr Monitoring-System so, dass es E-Mail-Benachrichtigungen an Ihre TeamMessage-Adresse sendet. TeamMessage wandelt die E-Mail in SMS um und liefert sie an Ihr Bereitschaftsteam.

HTTP-API

Für engere Integration nutzen Sie die HTTP-API, um Alarme direkt aus Ihren Monitoring-Skripten zu senden:

curl -X POST https://teammessage.de/api/v1/sms/send/ \
  -H "Content-Type: application/json" \
  -d '{
    "team_id": "100042",
    "team_name": "myteam",
    "recipients": ["+4917012345678"],
    "message": "CRITICAL: Web server down"
  }'

Für detaillierte API-Dokumentation siehe REST-API.

Legacy HTTP

Für Abwärtskompatibilität unterstützt TeamMessage auch die Legacy-Schnittstelle sendtmsg.php, die von vielen bestehenden Integrationen verwendet wird:

curl "https://teammessage.de/mbr/sendtmsg.php?tm=100042&tn=myteam&tsms=+4917012345678&msg=CRITICAL:+Web+server+down"

Beliebte Monitoring-Systeme

Nagios / Icinga

Konfigurieren Sie einen Benachrichtigungsbefehl, der Alarme per E-Mail oder HTTP sendet:

define command {
    command_name    notify-by-sms
    command_line    /usr/bin/curl -s "https://teammessage.de/mbr/sendtmsg.php?tm=$CONTACTPAGER$&tn=alerts&tsms=$CONTACTADDRESS1$&msg=$NOTIFICATIONTYPE$:+$HOSTALIAS$+$SERVICEDESC$+$SERVICESTATE$"
}

Zabbix

Erstellen Sie einen Medientyp, der Alarme über TeamMessage sendet:

1. Gehen Sie zu Administration → Medientypen → Medientyp erstellen
2. Wählen Sie 'E-Mail' und setzen Sie den Empfänger auf Ihre TeamMessage-Adresse
3. Oder erstellen Sie einen 'Skript'-Medientyp, der curl verwendet, um die HTTP-API aufzurufen

Prometheus / Alertmanager

Konfigurieren Sie einen E-Mail-Empfänger, der an Ihre TeamMessage-Adresse sendet:

receivers:
  - name: 'sms-alerts'
    email_configs:
      - to: 'myteam-alerts@tmsg.de'
        send_resolved: true

Andere Systeme

Any monitoring system that supports email notifications can integrate with TeamMessage:

• Checkmk
• PRTG
• Datadog
• Grafana
• Uptime Robot
• Eigene Skripte

Maschinen- und Anlagen-Monitoring

Neben IT-Infrastruktur verarbeitet TeamMessage auch Alarme von Industriemaschinen und Anlagen. Viele moderne Systeme – von Produktionsanlagen bis zur Gebäudeautomation – können bei Problemen Benachrichtigungen per E-Mail oder SMS senden.

TeamMessage fungiert als zentrale Verteilstelle, die diese Alarme empfängt und über verschiedene Kanäle verteilt:

• E-Mail-Alarme als SMS an mobile Techniker weiterleiten
• Bei kritischen Anlagenausfällen zu Sprachanrufen eskalieren
• An mehrere Empfänger gleichzeitig verteilen
• Verschiedene Alarme an verschiedene Teams leiten

SMS-Gateway (sms2team)

Viele Industrieanlagen können nur SMS-Alarme senden – sie haben keine E-Mail-Funktion. Mit sms2team senden diese Maschinen ihre SMS an die TeamMessage-Gateway-Nummer, und TeamMessage verteilt den Alarm an Ihr Team.

Das ist ideal für:

• GSM-Modems an abgelegenen Standorten
• Industriesteuerungen mit SMS-Modulen
• Gebäudeautomationssysteme
• Ältere Anlagen ohne Netzwerkanbindung

Best Practices

Alarm-Filterung

Senden Sie nicht jeden Alarm per SMS. Reservieren Sie SMS für kritische Probleme, die sofortige Aufmerksamkeit erfordern:

• Nutzen Sie Schweregrade – senden Sie nur CRITICAL-Alarme per SMS
• Filtern Sie Rauschen – schließen Sie bekannte fluktuierende Dienste oder Wartungsfenster aus
• Nutzen Sie Eskalation – beginnen Sie mit E-Mail, eskalieren Sie zu SMS bei Nichtbestätigung

Nachrichtenformat

Halten Sie Monitoring-Alarme kurz und handlungsorientiert:

Bereitschaftsrotation

Nutzen Sie Teamlisten zur Verwaltung von Bereitschaftsplänen:

• Erstellen Sie eine dedizierte Alarm-Teamliste (z.B. meinteam-oncall@tmsg.de)
• Fügen Sie Bereitschafts-Teammitglieder zu dieser Liste hinzu
• Aktualisieren Sie die Liste, wenn die Bereitschaftsrotation wechselt
• Erwägen Sie Sprachanrufe für kritische Alarme während der Nachtstunden

Sprach-Eskalation

Für kritische Alarme, die nicht verpasst werden dürfen, erwägen Sie Sprach-Eskalation:

• Erstellen Sie eine separate Teamliste, die für Sprachzustellung konfiguriert ist
• Senden Sie kritische Alarme an diese Liste – Empfänger erhalten einen Telefonanruf
• Das Telefon klingelt weiter, bis abgenommen wird – perfekt für nächtliche Alarme
• Bei Nichtannahme wiederholt TeamMessage automatisch

Rate-Limiting

Schützen Sie sich vor Alarm-Stürmen durch Konfiguration von Rate-Limits:

• Setzen Sie eine maximale Anzahl von Nachrichten pro Stunde in Ihren Teamlisten-Einstellungen
• Dies verhindert, dass außer Kontrolle geratenes Monitoring Ihr SMS-Budget erschöpft
• Erwägen Sie, Alarme in Ihrem Monitoring-System zu aggregieren, bevor Sie sie senden

Testen Ihrer Einrichtung

Bevor Sie sich in der Produktion auf SMS-Alarme verlassen:

1. Senden Sie einen Testalarm von Ihrem Monitoring-System
2. Überprüfen Sie, dass die SMS auf allen Bereitschafts-Telefonen ankommt
3. Testen Sie zu verschiedenen Zeiten (Tag/Nacht)
4. Simulieren Sie einen echten Ausfall, um die gesamte Kette zu verifizieren