# Zabbix, PRTG und Checkmk: Alarm per SMS

> Alarme aus Zabbix, PRTG und Checkmk als SMS mit einem HTTP-Aufruf oder per E-Mail zu SMS, ohne GSM-Modem: Medientyp, HTTP-Aktion und Benachrichtigungsskript.

Veröffentlicht: 2026-11-15 · 7 Min. Lesezeit · Webversion: https://topsms.eu/de/blog/zabbix-prtg-checkmk-sms-alarm · English: https://topsms.eu/blog/zabbix-prtg-checkmk-sms-alerts.md

## Kurz gesagt

Alle drei Monitoring-Systeme können eine URL aufrufen: Zabbix mit einem Webhook-Medientyp, PRTG mit der Benachrichtigungsmethode Execute HTTP Action, Checkmk mit einem kleinen Benachrichtigungsskript. Richten Sie sie auf die HTTP-GET-API von TopSMS (https://www.topsms.cz/api/sms/get mit to und text), und jeder Alarm wird zur SMS, je 0,089 € nach Deutschland und Österreich. Systeme, die nur E-Mails senden, nutzen E-Mail zu SMS: 4915112345678@sms.topsms.eu.

Ein Monitoring-Alarm per E-Mail geht nachts oder unterwegs leicht unter. Eine SMS erreicht das Bereitschaftshandy ohne App, ohne mobile Daten und ohne Anmeldung. Diese Anleitung verbindet Zabbix, PRTG und Checkmk mit je einem HTTP-Aufruf mit SMS und zeigt den E-Mail-Weg für Geräte, die kein HTTP können.

## Der Baustein: SMS mit einer URL

Die HTTP-GET-API von TopSMS sendet eine SMS mit einem einzigen `GET` oder Formular-`POST` an `https://www.topsms.cz/api/sms/get` (auch erreichbar unter `https://topsms.eu/api/sms/get`). Pflicht sind zwei Parameter, `to` im internationalen Format und `text`; `from`, `send_at`, `ref` und `format=json` sind optional. Die Antwort ist eine Zeile Klartext, die selbst ein Shell-Skript prüfen kann:

```
curl -H "Authorization: Bearer CLIENT_ID:SECRET" \
  "https://www.topsms.cz/api/sms/get?to=%2B4915112345678&text=Disk%20full%20on%20db1"

OK cmh3x9k2a0001qz8l5v7w2abc
ERROR insufficient_credit Insufficient credit. ...
```

Die HTTP-Statuscodes entsprechen der REST-API: `200` gesendet, `401` falscher Schlüssel, `402` Guthaben reicht nicht, `429` Anfragelimit. Guthaben, Absender, Sperrliste, Testschlüssel und Anfrageprotokoll funktionieren genau wie bei `POST /api/sms/send`.

### Ein eigener Schlüssel für das Monitoring

Legen Sie im Dashboard einen separaten API-Schlüssel nur mit Scope `send` an und beschränken Sie ihn auf die IP-Adressen Ihres Monitoring-Servers. Authentifizieren Sie sich in dieser Reihenfolge: Header `Authorization: Bearer CLIENT_ID:SECRET`, dann `client_id` und `secret` im Body eines POST-Formulars. Der Schlüssel im Query-String ist für Geräte möglich, die nichts anderes können, aber standardmäßig aus; aktivieren Sie „URL-Authentifizierung erlauben“ unter *GET & E-Mail* nur für diesen Schlüssel und nur wenn nötig, denn URLs landen in Logs.

## Zabbix: Webhook-Medientyp

Der eigene SMS-Medientyp von Zabbix braucht ein GSM-Modem an der seriellen Schnittstelle des Servers. Der Webhook-Medientyp braucht nur HTTPS. Laut Zabbix-Handbuch legen Sie ihn unter **Alerts, Media types, Create media type** an; das Skript ist JavaScript, erhält die Parameter als JSON in `value` und muss einen Wert zurückgeben. Wählen Sie den Typ *Webhook* und legen Sie drei Parameter an:

- `to` = `{ALERT.SENDTO}`
- `message` = `{ALERT.SUBJECT}: {ALERT.MESSAGE}`
- `token` = `CLIENT_ID:SECRET`

Skript:

```
var p = JSON.parse(value);
var req = new HttpRequest();
req.addHeader('Authorization: Bearer ' + p.token);
req.addHeader('Content-Type: application/x-www-form-urlencoded');
var body = 'to=' + encodeURIComponent(p.to) + '&text=' + encodeURIComponent(p.message.slice(0, 600));
var res = req.post('https://www.topsms.cz/api/sms/get', body);
if (req.getStatus() !== 200 || res.indexOf('OK ') !== 0) throw 'TopSMS: ' + res;
return 'OK';
```

`HttpRequest`, `addHeader`, `post` und `getStatus` sind dokumentierte JavaScript-Objekte von Zabbix. Das Skript kürzt den Text auf 600 Zeichen, damit eine ausführliche Trigger-Beschreibung nicht zu zehn SMS wird; kürzen Sie weiter, wenn Sie eine SMS pro Alarm möchten. Fügen Sie das Medium dann jedem Benutzer hinzu, der SMS erhalten soll, mit der Mobilnummer im internationalen Format als „Send to“, und verwenden Sie den Medientyp in Ihren Trigger-Aktionen. Ein fehlgeschlagener Versand wirft einen Fehler, den Zabbix im Aktionsprotokoll anzeigt.

## PRTG: Execute HTTP Action

Öffnen Sie in PRTG **Setup, Account Settings, Notification Templates** (in der deutschen Oberfläche entsprechend übersetzt), fügen Sie eine Vorlage hinzu und aktivieren Sie **Execute HTTP Action**. Das PRTG-Handbuch beschreibt die Felder URL, HTTP-Methode und bei POST eine Nutzlast, die formularkodiert sein muss, kein JSON. Das passt zur HTTP-GET-API:

```
Method:  POST
URL:     https://www.topsms.cz/api/sms/get
Payload: client_id=CLIENT_ID&secret=SECRET&to=%2B4915112345678&text=%device %name %status %message
```

`%device`, `%name`, `%status` und `%message` sind PRTG-Platzhalter für Gerät, Sensor, alten und neuen Status und die letzte Sensormeldung. POST hält den Schlüssel aus der URL heraus. Legen Sie eine Vorlage pro Empfängernummer an, für eine Bereitschaftsgruppe entsprechend mehrere, und hängen Sie sie an die Trigger Ihrer Sensoren oder Gruppen.

## Checkmk: Benachrichtigungsskript

Checkmk übergibt Alarmdaten an Benachrichtigungsskripte in Umgebungsvariablen, die mit `NOTIFY_` beginnen. Laut Checkmk-Handbuch gehören eigene Skripte nach `~/local/share/check_mk/notifications` und müssen ausführbar sein; der Kommentar in der zweiten Zeile ist der Titel, der in der Benachrichtigungsregel erscheint. Speichern Sie als Site-Benutzer diese Datei als `topsms`:

```
#!/bin/bash
# TopSMS SMS
# parameter 1 in the notification rule: CLIENT_ID:SECRET
TEXT="$NOTIFY_WHAT $NOTIFY_HOSTNAME ${NOTIFY_SERVICEDESC:-} ${NOTIFY_SERVICESTATE:-}"
/usr/bin/curl -s -H "Authorization: Bearer $NOTIFY_PARAMETER_1" \
  --data-urlencode "to=$NOTIFY_CONTACTPAGER" \
  --data-urlencode "text=$TEXT" \
  https://www.topsms.cz/api/sms/get
```

Führen Sie `chmod +x topsms` aus. Wählen Sie in einer Benachrichtigungsregel die Methode „TopSMS SMS“ und tragen Sie `CLIENT_ID:SECRET` als ersten Parameter ein; er erreicht das Skript als `NOTIFY_PARAMETER_1`. Die Mobilnummer der Bereitschaft gehört in das Feld *Pager* im Benutzerprofil; das Skript liest sie aus `NOTIFY_CONTACTPAGER`. Nagios und Icinga funktionieren genauso mit einem curl-Benachrichtigungsbefehl, siehe [Dokumentation](https://topsms.eu/de/docs#http-get-api).

## E-Mail zu SMS für alles andere

USV-Anlagen, NAS-Systeme, Backup-Software und ältere Monitoring-Lösungen kennen oft nur E-Mail-Alarme. Senden Sie diese an die Telefonnummer unter unserer Domain: `4915112345678@sms.topsms.eu`. Der Klartext-Body wird zur SMS (HTML wird umgewandelt, zitierte Antworten und Signaturen entfernt, höchstens 1.600 Zeichen); ist der Body leer, wird der Betreff verwendet. Bis zu 10 Nummern passen in An und Cc einer E-Mail.

Die Einrichtung erfolgt bei einem Schlüssel unter *GET & E-Mail*: E-Mail zu SMS aktivieren und die erlaubten Absenderadressen oder Ihre eigene Domain eintragen. Eine E-Mail wird nur angenommen, wenn der Absender auf dieser Liste steht und DMARC, DKIM oder SPF für seine Domain besteht. Hat der Mailserver eines Geräts weder SPF noch DKIM, verwenden Sie die Adresse mit dem Schlüssel-Token, `4915112345678.tok_…@sms.topsms.eu`. Angenommen werden höchstens 60 E-Mails pro Stunde je Schlüssel und je Absenderadresse; das begrenzt auch einen Alarmsturm.

## Praxistipps

- **Texte kurz und in GSM-7 halten.** Eine SMS fasst 160 GSM-7-Zeichen; ein einziges Zeichen außerhalb dieses Zeichensatzes schaltet auf Unicode mit 70 Zeichen pro Teil um. Host, Dienst und Zustand reichen meist.
- **Alarmstürme vermeiden:** SMS nur für Trigger mit hohem Schweregrad senden und Eskalationen nutzen; den Rest übernimmt die E-Mail.
- **Erst testen:** Mit einem Testschlüssel erhält das Monitoring dieselben `OK`-Antworten, gesendet und berechnet wird nichts.
- **Guthaben im Blick behalten:** Ein `402` oder `ERROR insufficient_credit` bedeutet, dass Alarme ausbleiben. Laden Sie rechtzeitig auf; das Guthaben verfällt nicht.

## Was es kostet

Keine Grundgebühr, kein Modem, kein SIM-Vertrag. Jede SMS nach Deutschland, Österreich und in die übrige EU kostet 0,089 €, ein Endpreis ohne Aufschlag der Umsatzsteuer. 200 Alarme im Monat kosten 17,78 €. Neue Konten erhalten nach Bestätigung der Telefonnummer 0,50 € Startguthaben. Alle Länder finden Sie auf der [Preisseite](https://topsms.eu/de/preise), weitere Anbindungen unter [Integrationen](https://topsms.eu/de/integrationen). [Kostenloses Konto anlegen](https://topsms.eu/de#register).

## Häufige Fragen

### Brauche ich ein GSM-Modem?

Nein. Der eingebaute SMS-Medientyp von Zabbix setzt ein serielles GSM-Modem am Zabbix-Server voraus. Mit einem SMS-Gateway braucht der Server nur ausgehendes HTTPS zur API oder einen E-Mail-Weg.

### Wie halte ich den API-Schlüssel aus den Logs heraus?

Senden Sie ihn im Header Authorization (Zabbix, Checkmk) oder im POST-Body (PRTG). Der Schlüssel im Query-String der URL ist standardmäßig aus und liefert 403 url_auth_disabled, bis Sie ihn für einen Schlüssel erlauben. Nutzen Sie einen eigenen Schlüssel nur mit Scope send und IP-Whitelist.

### Was, wenn derselbe Alarm mehrfach auslöst?

Nutzen Sie den Parameter ref, wo Ihr System eine stabile Ereignis-ID bietet: Dieselbe ref innerhalb von 24 Stunden sendet keine zweite SMS. Bei E-Mail zu SMS wird dieselbe E-Mail (gleiche Message-ID), die innerhalb von 24 Stunden erneut ankommt, ignoriert.

### Kann ich die Einrichtung ohne SMS-Versand testen?

Ja. Mit einem Test-API-Schlüssel werden Anfragen wie im Livebetrieb geprüft und beantwortet, aber nichts gesendet oder berechnet. Danach wechseln Sie zum Live-Schlüssel.

## Passende Seiten

- [Dokumentation der HTTP-GET-API](https://topsms.eu/de/docs#http-get-api)
- [Dokumentation E-Mail zu SMS](https://topsms.eu/de/docs#email-zu-sms)
- [Alle Integrationen](https://topsms.eu/de/integrationen)
- [Preise pro SMS](https://topsms.eu/de/preise)

## Quellen

- [Zabbix 8.0 manual: webhook media type (Alerts, Media types, JavaScript, timeout, return value)](https://www.zabbix.com/documentation/current/en/manual/config/notifications/media/webhook) (geprüft am 2026-11-15)
- [Zabbix 8.0 manual: HttpRequest object (addHeader, post, getStatus)](https://www.zabbix.com/documentation/current/en/manual/config/items/preprocessing/javascript/javascript_objects) (geprüft am 2026-11-15)
- [Zabbix 8.0 manual: SMS media type with a serial GSM modem](https://www.zabbix.com/documentation/current/en/manual/config/notifications/media/sms) (geprüft am 2026-11-15)
- [PRTG manual: notification templates, Execute HTTP Action](https://www.paessler.com/manuals/prtg/notification_templates) (geprüft am 2026-11-15)
- [PRTG manual: placeholders for notifications](https://www.paessler.com/manuals/prtg/list_of_placeholders_for_notifications) (geprüft am 2026-11-15)
- [Checkmk 2.5 user guide: notifications and custom notification scripts](https://docs.checkmk.com/latest/en/notifications.html) (geprüft am 2026-11-15)
