Alarme & Benachrichtigungen

Alarme

Alarm Manager ▸ Alarme listet die Alarme auf, die Ihre Regeln ausgelöst haben: was gerade ausgelöst ist, die behobenen oder beides. In Mirox öffnen

Jeder Alarm zeigt seine Stufe, die Regel, die Anlage, die Komponente (bei Regeln, die pro Komponente beurteilt werden), den Wert und seit wann — oder von wann bis wann — er ausgelöst war. Ein Alarm, der während einer Stummschaltung eintraf, ist als Stummgeschaltet markiert.

Ein Alarm ist von selbst behoben, wenn die Bedingung nicht mehr gilt, wenn die Regel ausgeschaltet, so geändert, dass sie nicht mehr passt, oder gelöscht wird. Behobene Alarme bleiben als Verlauf in der Liste.

Quittieren zeigt Ihren Kolleginnen und Kollegen, dass sich jemand darum kümmert. Es schließt den Alarm nicht — das tun allein die Werte der Anlage.

Änderungen an Regeln und Stummschaltungen erscheinen außerdem in der Aktivität Ihrer Organisation.

Wer benachrichtigt wird

Wenn sich ein Alarm öffnet, werden alle Personen Ihrer Organisation benachrichtigt, die Zugriff auf die Anlage haben — in der App, per Push in der mobilen App und per E-Mail, genau so, wie jede Person es in ihren eigenen Benachrichtigungseinstellungen unter der Gruppe Alarm Manager gewählt hat. Dort wählt jede Person die Kanäle und die Mindest-Stufe, ab der sie von diesen Alarmen hören möchte; standardmäßig ist das Normal.

Wenn der Alarm behoben ist, erhalten die benachrichtigten Personen eine Benachrichtigung über die Behebung. Die Benachrichtigung verlinkt direkt auf den Alarm.

Stummschaltungen

Eine Stummschaltung hält Benachrichtigungen eine Zeit lang fern — für Wartungsarbeiten, ein bekanntes Problem oder eine geplante Abschaltung. Passende Alarme öffnen und schließen sich weiterhin und erscheinen in der Liste, als Stummgeschaltet markiert; nur die Benachrichtigungen und Empfänger bleiben still.

Öffnen Sie Alarm Manager ▸ Stummschaltungen und klicken Sie auf Neue Stummschaltung. In Mirox öffnen Wählen Sie:

• Regel — eine Regel oder jede Regel.
• Anlage — eine Anlage oder jede Anlage.
• Beginnt — jetzt oder zu einem geplanten Zeitpunkt.
• Für — von 1 Stunde bis zu 1 Jahr, oder Bis zu einem Datum… für ein freies Enddatum (höchstens ein Jahr nach dem Beginn).
• Kommentar — warum, damit Ihre Kolleginnen und Kollegen es wissen.

Eine Stummschaltung endet von selbst. Entfernen Sie sie früher mit ihrer Löschen-Schaltfläche. Stummschaltungen werden von Admins und Moderatoren erstellt und entfernt.

Empfänger

Ein Empfänger erhält automatisch jeden Alarm der Regeln, denen er zugeordnet ist — ein Ticketsystem, ein Team-Kanal oder ein gemeinsames Postfach. Personen brauchen keinen Empfänger; sie werden ohnehin über ihre eigenen Einstellungen benachrichtigt.

Öffnen Sie Alarm Manager ▸ Empfänger und klicken Sie auf Neuer Empfänger In Mirox öffnen, und ordnen Sie ihn dann im Regel-Editor unter Empfänger Regeln zu. Test senden stellt einen Beispielalarm zu, damit Sie die Verbindung prüfen können.

E-Mail

Eine Liste von E-Mail-Adressen. Jeder Alarm und seine Behebung kommen als eine E-Mail an.

Webhook

Eine HTTPS-Adresse, die für jeden Alarm und seine Behebung einen POST erhält, in einem dieser Formate:

• JSON (signiert) — der vollständige Alarm als JSON, siehe unten.
• Microsoft Teams, Slack, Discord — eine fertige Nachricht für einen eingehenden Webhook dieses Dienstes. Wie Sie einen erstellen, steht unter Microsoft Teams verbinden.

Beim Erstellen eines Webhook-Empfängers wird sein Signaturgeheimnis einmalig angezeigt. Jede Anfrage trägt den Header X-Mirox-Signature: sha256=<hex> — den HMAC-SHA256 des rohen Anfragekörpers mit diesem Geheimnis — sowie X-Mirox-Timestamp und eine eindeutige X-Mirox-Delivery-Id. Prüfen Sie die Signatur, bevor Sie einer Anfrage vertrauen, und ignorieren Sie über die Delivery-Id eine wiederholte Zustellung.

Der Körper von JSON (signiert):

{
  "version": "1",
  "status": "firing",
  "event_id": "1216448682925686786",
  "rule_uid": "A1B2C3D4E5F6",
  "rule_name": "Inverter without power",
  "rule_version": 3,
  "priority": "high",
  "park_uid": "0A1B2C3D4E5F",
  "park_name": "Plant North",
  "instance_key": "inverter_id=7",
  "labels": { "inverter_id": "7" },
  "component": "Inverter 7",
  "metric": "AC power per inverter",
  "value": 0.0,
  "unit": "W",
  "op": "lt",
  "threshold": 10.0,
  "condition_since": 1791200400,
  "title": "[FIRING] Inverter without power — Plant North (Inverter 7)",
  "body": "Inverter 7 delivers only 0 W (limit 10 W)",
  "link": "https://service.mirox.io/#/alertmanager?tab=alerts&alert=1216448682925686786",
  "sent_at": "2026-10-06T09:05:12+00:00"
}

status ist firing oder resolved; eine Behebung wiederholt den Alarm mit dem zuletzt beurteilten Wert. condition_since ist ein Unix-Zeitstempel. In späteren Versionen können Felder hinzukommen — ignorieren Sie, was Sie nicht kennen. event_id ist eine Zeichenkette – die ID ist länger, als eine JavaScript-Zahl exakt darstellen kann.

Nach wiederholt fehlgeschlagenen Zustellungen wird ein Empfänger ausgeschaltet und als Deaktiviert markiert; prüfen Sie die Adresse und erstellen Sie ihn neu.

BWE-Nichtverfügbarkeitsschnittstelle

Meldet die Nichtverfügbarkeiten Ihrer Windturbinen über die BWE-Nichtverfügbarkeitsschnittstelle an Ihren Direktvermarkter. Jeder Alarm einer Turbine wird zu einer Nichtverfügbarkeit: wird der Alarm ausgelöst, beginnt sie, ist er behoben, endet sie. Ihr Direktvermarkter betreibt die Schnittstelle und gibt Ihnen drei Dinge: die Webservice-Adresse, die Token-Adresse sowie Benutzername und Passwort – tragen Sie sie im Empfänger ein. Das Passwort wird verschlüsselt gespeichert und nie wieder angezeigt. Anmeldung testen meldet sich an und zeigt, wie viele Anlagen der Direktvermarkter Ihrem Zugang zugeordnet hat; eine Nichtverfügbarkeit wird dabei nie gemeldet.

• Grund der Nichtverfügbarkeit: ein Empfänger je Grund – MAINTENANCE (Störungen, Wartung, Handbetrieb), ADMINISTRATIVE (behördliche Auflagen wie Schall-, Fledermaus- oder Vogelschutz), GRID (Abregelung durch den Netzbetreiber) oder MARKET (Abregelung durch den Direktvermarkter). GRID und MARKET nur verwenden, wenn die Ursache der Abregelung sicher ist.
• Gemeldete verbleibende Leistung: 0 kW (vollständiger Ausfall) oder der Alarmwert, wenn die Regel eine Leistungsmetrik überwacht – nie mehr als die beim Direktvermarkter hinterlegte installierte Leistung.
• Im Voraus melden: die Schnittstelle verlangt eine Endzeit, deshalb wird ein offener Alarm bis zu so vielen Tagen im Voraus gemeldet (standardmäßig 30); sein Ende kürzt die Meldung auf das tatsächliche Ende.

Jede Turbine wird über die Seriennummer aus ihren Stammdaten in der Anlagenliste des Direktvermarkters gefunden; bei gleicher Seriennummer entscheidet der Hersteller. Hängen Sie den Empfänger an Regeln, die Turbinen einzeln überwachen – die Beispiele Turbine durch Störung aus und Turbine wegen Umweltauflagen abgeregelt sind dafür gemacht. Eine Turbine, die der Direktvermarkter nicht kennt, erscheint als fehlgeschlagene Zustellung des Empfängers.

Vorlagen

Eine Vorlage legt genau fest, was ein Empfänger sendet, damit jedes System das Format erhält, das es erwartet: bei einem Webhook die Methode (POST, PUT oder PATCH), eigene Header und den Inhalt als JSON, XML, CSV, HTML, reinen Text oder Formulardaten; bei einer E-Mail den Betreff und den Text (reiner Text oder Ihr eigenes HTML). Sie schreiben festen Text und fügen Variablen des Alarms, der Regel, der Anlage und der Komponente ein. Eine Vorlage ist wiederverwendbar: Mehrere Empfänger können dieselbe nutzen, und eine Änderung gilt sofort für alle.

Öffnen Sie Alarm Manager ▸ Empfänger In Mirox öffnen: Unter den Empfängern finden Sie Ihre Vorlagen und die Beispiele zum Start. Beispiel verwenden übernimmt eines in Ihre Organisation; Neue Vorlage beginnt leer. Die Vorlage öffnet sich im Editor: links die Einstellungen, die Header und der Inhalt, in der Mitte die Liste der Variablen — ein Klick fügt die Variable an der Cursorposition ein — und rechts die Live-Vorschau: die Anfrage oder E-Mail genau so, wie sie gesendet würde, mit dem Beispielalarm oder einem Ihrer letzten Alarme, mit allen Fehlern und Warnungen. Wählen Sie die Vorlage dann für einen Empfänger — beim Anlegen oder über die Vorlagen-Schaltfläche in seiner Zeile. Ohne Vorlage behält ein Empfänger sein eingebautes Format.

Vorlagen werden von Admins und Moderatoren angelegt und geändert; jedes Mitglied kann sie ansehen. Eine Vorlage, die ein Empfänger nutzt, lässt sich nicht löschen — wählen Sie zuerst eine andere für diesen Empfänger.

Die Vorlagensprache

In einem Listen-Abschnitt stehen {{@index}} (ab 0), {{@number}} (ab 1), {{@first}} und {{@last}} zur Verfügung — zum Beispiel setzt {{^@last}},{{/@last}} ein Komma zwischen die Einträge. Eine Variable, die es nicht gibt, bleibt leer, und die Vorschau zeigt sie als Warnung. In einer Vorlage wird nichts ausgeführt; sie erzeugt immer nur Text.

Variablen

Datumsangaben erscheinen in der Zeitzone der Anlage, sofern der Filter date keine andere nennt. Die Anlage hat kein Feld für eine MaStR-Nummer oder eine Marktlokation — tragen Sie solche Kennungen als festen Text in die Vorlage ein.

Filter folgen der Variable nach | und lassen sich verketten, zum Beispiel {{alert.value|kw|number:1:de}}:

Formate und Maskierung

Das Format einer Vorlage bestimmt, wie ein Wert eingefügt wird, damit ein Anlagenname mit Anführungszeichen oder einem Und-Zeichen das Ergebnis nie zerstört:

• JSON — innerhalb eines Strings ("plant": "{{plant.name}}") wird ein Wert als Text maskiert; außerhalb ("value": {{alert.value}}) wird er zu einem JSON-Wert: Eine Zahl bleibt eine Zahl, Text erhält Anführungszeichen, ein leerer Wert wird null, Objekte und Listen werden als JSON geschrieben.
• XML und HTML — <, >, & und Anführungszeichen werden maskiert.
• CSV — ein Feld wird in Anführungszeichen gesetzt, wenn es das Trennzeichen, ein Anführungszeichen oder einen Zeilenumbruch enthält; in einem Feld, das die Vorlage selbst in Anführungszeichen setzt, werden Anführungszeichen verdoppelt. Als Trennzeichen gilt das, das Ihre Vorlage verwendet (Komma, Semikolon, Tabulator).
• Formulardaten — Werte werden URL-kodiert.
• Reiner Text — unverändert.

Header-Werte und der E-Mail-Betreff enthalten nie einen Zeilenumbruch. Eine Vorlage wird beim Speichern geprüft: Sie muss vollständig sein (jeder Abschnitt geschlossen, jeder Filter bekannt), darf höchstens 64 KiB groß sein, und ihr Ergebnis für den Beispielalarm muss bei diesen Formaten gültiges JSON bzw. wohlgeformtes XML sein. Header: höchstens 30, nur Namen aus Standardzeichen. Content-Type folgt dem Format; Content-Length, Host und die X-Mirox-*-Header setzt Mirox — Sie können sie nicht überschreiben. Jede Webhook-Anfrage bleibt signiert: X-Mirox-Signature ist der HMAC-SHA256 genau des Inhalts, den Ihre Vorlage erzeugt hat.

Beispiele

Jedes Beispiel ist ein Ausgangspunkt, den Sie übernehmen und anpassen:

• Allgemeines JSON (signierter Umschlag) — Der dokumentierte Mirox-Alarmumschlag — Grundlage für Ticketsysteme und Automatisierung.
• Microsoft-Teams-Karte — Eine Adaptive Card für einen Teams-Workflows-Webhook mit Anlage, Komponente und Wert.
• Slack-Nachricht — Block-Kit-Nachricht für einen eingehenden Slack-Webhook mit Schaltfläche zum Alarm.
• Discord-Embed — Ein farbiges Embed für einen Discord-Kanal-Webhook (rot ausgelöst, grün aufgehoben).
• XML-Dokument — Der Alarm als XML-Dokument für Systeme, die XML erwarten.
• CSV-Zeile — Eine Kopfzeile und eine Datenzeile je Alarm, durch Kommas getrennt.
• Text-E-Mail — Eine kompakte Text-E-Mail mit den wichtigsten Angaben im Mirox-E-Mail-Rahmen.
• HTML-E-Mail — Ihre eigene HTML-E-Mail mit Faktentabelle — genau so versendet, wie gestaltet.
• Direktvermarkter: Meldung eingeschränkte Verfügbarkeit (CSV) — Meldung eingeschränkter Verfügbarkeit als CSV mit Semikolon — ein Ausgangspunkt, den Sie an die Vorgaben Ihres Direktvermarkters anpassen.
• Direktvermarkter: Meldung eingeschränkte Verfügbarkeit (E-Mail) — E-Mail-Meldung mit Anlage, Beginn, Ende und verfügbarer Leistung — passen Sie sie an die Anforderungen Ihres Direktvermarkters an.

Die Direktvermarkter-Beispiele melden eine eingeschränkte Verfügbarkeit einer Anlage: Name und ID der Anlage, Beginn und Ende, installierte Leistung und — bei einer Regel auf eine Leistungs-Metrik — die verfügbare Leistung, einmal als CSV-Zeile mit Semikolon und einmal als E-Mail. Für diese Meldung gibt es kein verbindliches Format; passen Sie Spalten und Wortlaut an die Vorgaben Ihres Direktvermarkters an und tragen Sie MaStR-Nummer und Marktlokation als festen Text ein.

Eine Vorlage für ein Ticketsystem, das XML erwartet:

<ticket priority="{{alert.level}}">
  <title>{{alert.title}}</title>
  <site id="{{plant.uid}}">{{plant.name}}</site>
  {{#component.name}}<asset>{{component.name}}</asset>{{/component.name}}
  <opened>{{alert.since|date:"iso"}}</opened>
  <link>{{alert.link}}</link>
</ticket>

Alarmierung testen

Ein Testlauf zeigt den ganzen Weg eines Alarms an einer Ihrer Anlagen – ohne auf ein echtes Problem zu warten und ohne die Daten der Anlage zu berühren. Öffnen Sie Alarm Manager ▸ Übersicht und klicken Sie auf Alarmierung testen In Mirox öffnen. Wählen Sie dann die Anlage, die Stufe des Testalarms (bis Kritisch) und optional Empfänger.

Die Plattform schreibt dann ein festgelegtes Testsignal für diese Anlage: 5 Minuten ruhig, 15 Minuten über dem Schwellwert, dann wieder ruhig. Der Agent der Anlage wertet es aus wie jede Ihrer Regeln, also:

1. etwa 5–10 Minuten nach dem Start öffnet der Testalarm – in der gewählten Stufe;
2. alle, die über einen echten Alarm dieser Stufe an dieser Anlage benachrichtigt würden, werden benachrichtigt – in der App, per Push und per E-Mail, nach ihren eigenen Einstellungen –, und die gewählten Empfänger erhalten ihn ebenfalls;
3. etwa 15 Minuten später wird er von selbst behoben, mit seiner Entwarnung.

Die Seite verfolgt den Lauf Schritt für Schritt. Ein Lauf endet nach etwa 30 Minuten von selbst oder früher mit Beenden; sein Alarm bleibt im Verlauf. Testläufe erscheinen nie unter Ihren Regeln, und Testdaten werden nur geschrieben, solange ein Lauf aktiv ist. Admins und Moderatoren starten Testläufe; bis zu drei können gleichzeitig laufen.

Verwandte Seiten

• Alarm-Manager-Übersicht
• Alarmregeln
• Benachrichtigungseinstellungen