Zum Hauptinhalt springen

Alarm

Inhaltsverzeichnis​

Alarm-Bildschirm — Liste der aufgetretenen Alarme


Überblick​

Die Alarm-Gruppe umfasst die Echtzeitüberwachung, die Verlaufssuche, die Registrierung von Regeln, die Visualisierungsanalyse und die Performance-Bewertung der aufgetretenen Alarme. Die Zustände Bestätigen, Ausblenden, Unterdrücken und Außer Betrieb setzen folgen der Norm ISA-18.2.

UntermenüInterne URLVerwendungszweck
Alarm/alarm/indexEchtzeit-Alarmüberwachung + Liste der Suchzeiträume + Statistiken/Rankings
Alarm-Suche/alarm/advsearch/indexDetaillierte Suche nach Zeitraum, Bereich, Priorität, Aktivität, Bestätigung und Inhalt
Erweiterte Alarme/alarm/config/indexListe der Alarm-Einstellungen, EQL-Alarm Registrierung/Bereitstellung, kurzzeitiges Ausblenden, Außer Betrieb setzen
Alarm-Analyse/alarm/analysis/indexVisualisierungsanalyse durch Rankings, Trends, Verteilungen, Treemaps etc.
Alarm-Performance/alarm/performance/indexBewertung der Alarm-Systemperformance (ISA-18.2 / EEMUA 191)

Neben dem Alarm-Glockensymbol im oberen Header zeigt ein rotes Badge die Anzahl der unbestätigten Alarme an; ein Klick führt zum Alarm-Bildschirm. Wenn derzeit ausgeblendete Ereignisse vorliegen, erscheint im Glocken-Dropdown eine separate Zeile «Unterdrückt N».


Vier Arten der Alarmbehandlung — Bestätigen · Ausblenden · Unterdrücken · Außer Betrieb setzen​

Bestätigung erfolgt einmal pro Alarm​

Die Bestätigung (acknowledge) ist der Nachweis, dass «jemand diesen Alarm gesehen und die Verantwortung übernommen hat». Sie erfolgt nicht pro Person, sondern einmal pro Ereignis. Die Person, die zuerst bestätigt, bleibt als Bestätiger eingetragen; spätere Bestätigungen ändern diesen ersten Eintrag nicht. Sobald eine Person den Alarm bestätigt, wird er für alle Personen als bestätigt angezeigt.

WannWas wird protokolliert
Bestätigung an der KonsoleBestätiger = angemeldeter Benutzer
Bestätigung in der Vor-Ort-AppBestätiger = der jeweilige Mitarbeiter
Öffnen der Alarm-DetailsEs wird nichts protokolliert — eine Bestätigung ist eine bewusste Handlung durch Drücken einer Taste

Ein Alarm verschwindet nicht durch die Bestätigung. Solange der Wert nicht wieder im Normalbereich liegt, bleibt der Alarm aktiv.

RolleMögliche Aktionen
ADMIN[Alarm bestätigen] in den Alarm-Details, [Alle Alarme bestätigen] in Alarm, Alarm-Suche und Details
API[Bestätigen] im Empfänger-Panel der Alarm-Details. In V5 Einzel-, Stapel- oder Gesamtbestätigung
MANAGER · USERBestätigen einzelner Alarme über [Alarm bestätigen] in den Alarm-Details. [Alle Alarme bestätigen] ist nicht sichtbar

[Alle Alarme bestätigen] wird auf alle unbestätigten Alarme angewendet und gilt für alle Benutzer. Die Anzahl der betroffenen Alarme wird angezeigt und eine erneute Bestätigung abgefragt.

Ausblenden · Unterdrücken · Außer Betrieb setzen​

Diese drei Zustände werden im Moment des Auslösens beurteilt. Wenn eine Bedingung zutrifft, wird das Ereignis nicht als Alarmzeile, sondern separat als ausgeblendetes Ereignis protokolliert und wird weder in der Alarmliste, noch in Benachrichtigungen, der Alarmanzahl oder der Alarm-Performance-Statistik aufgeführt. Alarme, die bereits aktiv waren, bleiben auch nach Beginn eines Ausblendens oder Unterdrückens bestehen.

BehandlungBezeichnung im BildschirmWerBis wannSicherheits- & Umweltalarme
Bediener-AusblendungKurzzeitig ausgeblendetADMIN unter Erweiterte AlarmeFür eine festgelegte Zeit (1 Min. bis 7 Tage). Wird danach automatisch aufgehobenKönnen nicht ausgeblendet werden
Geplante WartungsunterdrückungDesign-UnterdrückungAutomatisch, wenn ein Wartungskalender für die Anlage hinterlegt istBis zum Ende des KalenderzeitraumsWerden nicht unterdrückt
ReparaturunterdrückungDesign-UnterdrückungAutomatisch, wenn eine Störungsreparatur an der Anlage läuftBis zum Abschluss der ReparaturWerden nicht unterdrückt
Außer Betrieb setzenAußer BetriebADMIN unter Erweiterte AlarmeKeine automatische Aufhebung. Rückführung erst nach RückführungsinspektionKönnen entfernt werden, aber ein Memo ist obligatorisch
  • Wenn mehrere Zustände gleichzeitig überlappen, wird nur einer in der Reihenfolge Außer Betrieb > Kurzzeitig ausgeblendet > Design-Unterdrückung protokolliert.
  • Die Design-Unterdrückung gilt nur für die Anlage, mit der der Tag verbunden ist, und breitet sich nicht auf untergeordnete Anlagen aus.
  • Wenn die Bedingung nach Ende des Ausblendens/Unterdrückens immer noch erfüllt ist, wird das ausgeblendete Ereignis geschlossen (SUPPRESSION_ENDED) und ein neuer Alarm wird zu diesem Zeitpunkt ausgelöst. Die Benachrichtigung wird ebenfalls erst dann gesendet. Ereignisse, die vor Ablauf der Zeit endeten, erscheinen nicht in der Alarmliste.
  • Das Außer-Betrieb-Setzen ist anders: Ein Alarm, der beim Entfernen aktiv war, wird geschlossen (Aufhebungsgrund «Außer Betrieb»). Dies bedeutet nicht, dass das Problem behoben wurde.

중복 알람 억제 unterscheidet sich von diesen drei Zuständen. Hier werden nur Benachrichtigungen (Push) desselben Typs für eine festgelegte Zeit reduziert, während der Alarm weiterhin normal protokolliert wird.

Die Anzahl der durch Reparaturen ausgeblendeten Alarme wird im Wartungs-Tab der Anlage als «N Alarme durch diese Reparatur ausgeblendet» angezeigt. Ereignisse während eines kurzzeitigen Ausblendens oder Außer-Betrieb-Setzens werden über die Karte «Während Ausblendung aufgetretene Ereignisse anzeigen» in den Erweiterten Alarmen eingesehen. Per API erfolgt dies über GET /api/v5/alarm/suppressed, per MCP über list_alarm_suppressions.


Bildschirmstruktur — 5 Untermenüs​

BildschirmHauptbenutzerZusammenfassung
AlarmOperatorEchtzeit-Alarme + Statistiken + Rankings (Hauptüberwachung)
Alarm-SucheOperator/AnalystPräzise Suche nach Bereich + Bedingungen
Erweiterte AlarmeADMINDefinition, Bereitstellung, Aufhebung und Neubereitstellung von Regeln, kurzzeitiges Ausblenden, Außer Betrieb setzen
Alarm-AnalyseAnalyst7 Visualisierungscharts (Rankings, Zeitfenster, Anteile, Trends, Treemaps etc.)
Alarm-PerformanceManager/AnalystBewertung der Alarm-Systemperformance (ISA-18.2 / EEMUA 191)

Alle fünf Menüs sind für ADMIN, API und USER sichtbar. USER können die Liste der erweiterten Alarme einsehen, aber die Schreib-Schaltflächen (Hinzufügen, Bereitstellung, Aufhebung, Neubereitstellung, Ändern, Löschen, Ausblenden, Außer Betrieb setzen) sind nicht verfügbar.


Alarm-Bildschirm (/alarm/index)​

Obere Suchregion​

🔔 알람 [기간] [사이트 ▼] [☐ 신호 끊김만] [검색] [알람 검색] [↻]
SteuerelementBeschreibung
Zeitraum (alarm_time)Start ~ Ende
Site (site_id)Site-Name [Beschreibung]
Nur SignalverlustZeigt nur Alarme in der Liste an, bei denen der Wert unterbrochen ist und der Zustand unbekannt ist. Die Statistiken basieren weiterhin auf der gesamten Suche
SucheLiest die Daten mit den aktuellen Bedingungen erneut ein
Alarm-SucheWechsel zum Alarm-Suchbildschirm
AktualisierenLiest die Daten mit den aktuellen Bedingungen erneut ein

Timeline​

ElementBeschreibung
Header🕐 «Timeline» + Beschriftung des Anzeigezeitraums(alarm_timeline_range_label)
Schnellzeiträume6 Schaltflächen(10M/30M/1H/6H/12H/ALL) — identisch mit anderen Bildschirmen
Alle Alarme bestätigen✓ — Nur für ADMIN sichtbar. Bestätigt alle unbestätigten Alarme(Bestätigen)
Timeline-Bereich (alarm_timeline)Alarmmarker werden farblich auf der Zeitachse 표시
Keine DatenHinweis «Keine Daten» (alarm_timeline_no_data)

Die Markerfarben entsprechen der Priorität(Statuscode): Information (Grün) / Warnung (Orange) / Kritisch (Rot).

Bereich col-lg-9 auf der linken Seite. Alarme des Suchzeitraums werden in Seiten aufsteigend nach Aktualität angezeigt; die Gesamtzahl steht in der Informationszeile unter der Tabelle. Es können bis zu den neuesten 10.000 Ereignissen geblättert werden.

SpalteBreiteBeschreibung
🔔30pxAlarm-Glockensymbol
Alarmnummer100pxDomänen-Alarm-ID
Priorität80pxFarbbadge für INFO/WARN/ERROR
Alarm Start/Endzeit160pxZweizeilig — Zeitpunkt des Auftretens / der Aufhebung
Tag | Ort380pxTag-ID + Ort (Asset-Pfad)
NachrichtAutomatischTextkörper der Alarmnachricht
Bestätigung60pxAnzeige, ob bestätigt wurde

Ein Klick auf eine Zeile führt zum Alarm-Detailbildschirm. Die Bestätigung erfolgt im Detailbildschirm.

Rechts — Statistik- und Ranking-Panel​

Zwei Panels im Bereich col-lg-3 auf der rechten Seite.

Statistik-Panel​

ElementIDBeschreibung
Headlinealarm_count_label«Gefundene Alarme : N Stück» in großer Schrift
Trend-Sparklinealarm_trend_spark_line (150px)Trend der Alarmauftretungen im Suchzeitraum
Prioritäts-Donutalarm_priority_count_chart (150px)Verteilung Information/Warnung/Kritisch
ON/OFF-Donutalarm_onoff_count_chart (150px)Verteilung Aktiv(is_on=Y) / Aufgehoben(is_on=N)
Alarm-Analyse (Button)—Oben rechts → Wechsel zum Alarm-Analyse-Bildschirm
Leerzustands-Hinweisstats_no_data«Keine Daten»

Ranking-Panel (3 Tabs)​

TabIDAnzeige
Nach Tag/Alarmtyprank_containerRanking der Tags/Typen mit hoher Alarmfrequenz
Nach Verbindungrank_opc_containerRanking der Alarmfrequenz pro OPC/Edge-Einheit
Nach Assetrank_asset_containerRanking der Alarmfrequenz pro Asset(Anlage)

Wenn in einem Tab keine Daten vorhanden sind, wird der Hinweis «Keine Daten» angezeigt.

Alarm-Hilfe​

Informationsfeld am unteren Bildschirmrand.

❓ Alarm-Hilfe Überwachen Sie in Echtzeit eingehende Alarmnachrichten.

  • Die Liste zeigt Alarme des Suchzeitraums in Seiten aufsteigend nach Aktualität an, die Gesamtzahl steht in der Informationszeile unter der Tabelle.
  • Verwenden Sie die Schaltfläche [Alarm-Suche], um detaillierte Suchen nach Zeitraum, Tag oder Priorität über alle Alarme hinweg durchzuführen.
  • Fügen Sie zusammengesetzte Alarmbedingungen auf Basis von EQL (Event Query Language) über die Schaltfläche [Alarm-Einstellung hinzufügen] im Menü [Erweiterte Alarme] hinzu.

Alarm-Suchbildschirm (/alarm/advsearch/index)​

🔔 알람 검색 [알람 기간] [← 알람 이동] [↻] [☰ ▼]

Links befindet sich die Suchkarte für Bereich + Bedingungen, rechts die Statik-Charts + Ergebnisliste.

Seiten-Header​

ButtonAktion
Alarm-Zeitraum (alarm_time)Zeitbereich
← Zu AlarmeWechsel zum Alarm-Bildschirm
↻ AktualisierenAktualisierung des Bildschirms
☰ ▼Dropdown — Wechsel zu anderen Alarm-Bildschirmen

Der Bereich wird in der Reihenfolge Site > Zone > Linie > Anlage eingegrenzt. Die Bedingungen sind wie folgt:

FeldOptionen
Priorität (priority)Alle / Information(INFO) / Warnung(WARN) / Kritisch(ERROR)
Aktiv (is_on)Alle / Aktiv / Beendet
Bestätigung (acknowledged)Alle / Bestätigt / Unbestätigt
Inhalt (description)Schlüsselwörter im Textkörper der Alarmnachricht

Ein Klick auf Suche unter der Karte zeigt die Ergebnisse auf der rechten Seite an.

Rechts — Ergebnisse​

Die Schaltfläche ✓ Alle Alarme bestätigen am Kopf der Ergebnisliste ist nur für ADMIN sichtbar und bestätigt alle unbestätigten Alarme, nicht nur die Suchergebnisse(Bestätigen).

Statistik-Chart-Bereich (über der Liste, nur bei vorhandenen Ergebnissen)​

BereichInhalt
Prioritäts-DonutDonut-Diagramm der Anteile von INFO/WARN/ERROR
Zeitreihen-SparklineSparkline der Alarmmenge während des Suchzeitraums

Ergebnis-Tabelle (6 Spalten)​

SpalteBreiteAnzeige
🔔30pxGlockensymbol
Alarmnummer100pxAlarm-Seriennummer — Klick führt zum Alarm-Detailbildschirm
Priorität80pxFarbbadge für Information/Warnung/Kritisch
Alarmdatum160pxZeitpunkt des Auftretens
Tag-Name200pxAuslösender Tag
InhaltAutomatischTextkörper der Alarmnachricht

Alarm-Analyse-Bildschirm (/alarm/analysis/index)​

Dieser Bildschirm dient der Analyse von Alarmdaten mithilfe verschiedener Visualisierungscharts.

Alarm-Analyse-Bildschirm — Nummern geben die Lesereihenfolge an

NummerPositionFunktion
①Links BereichAuswahl von Site · Zone · Linie · Anlage («Alle …» bedeutet Gesamtheit darunter)
②Links BedingungVisualisierungs-Selektor — Auswahl eines Charts für die Ergebnisse
③Unten linksAnalyse — Ergebnisse bleiben leer, bis diese Taste gedrückt wird
④KopfzeileAlarm-Zeitraum — Standardwert ist ein Monat
⑤HauptbereichErgebnis — Das gewählte Chart wird hier gezeichnet
Es ist normal, dass das Feld vor dem Klicken auf «Analyse» leer ist

Das obige Bild zeigt diesen Zustand — «Wählen Sie Alarm-Zeitraum und Visualisierung aus und führen Sie dann die Analyse aus».

7 Visualisierungen — Auswahl im Selektor​

Es gibt sieben Optionen im ⑤ Visualisierungs-Selektor. Die folgenden Namen erscheinen direkt im Bildschirm:

Name im BildschirmInhalt
Ranking Tag-FrequenzRanking der Tags mit den meisten Alarmen
Verteilung nach UhrzeitAuftretenshäufigkeit pro Stunde über 24h
Anteil nach PrioritätVerhältnis Information / Warnung / Kritisch
Tages-TrendTrend der Auftretungen pro Datum
Tages-Anteil-KalenderPrioritätsverhältnis pro Tag in den Kalenderfeldern
Wochentags-ZeitmusterKreuzung Wochentag × Uhrzeit — zur Identifikation wiederkehrender Zeitfenster
Anlagen-TreemapAlarmverteilung nach Flächenanteil der Asset-Hierarchie
Es gibt drei weitere Charts im Produkt, die nicht im Selektor enthalten sind

Die drei Bildschirme matrix · eventdrops · heatmap verfügen noch über Serverpfade und Zeichencode, und der Verzweigungscode(analysis-index.js) verarbeitet diese ebenfalls, aber sie sind nicht in den Optionen des Visualisierungs-Selektors aufgeführt. Das bedeutet, sie können im aktuellen Bildschirm nicht ausgewählt werden — dies betrifft die in älteren Dokumenten erwähnten «Wochentag·Uhrzeit Heatmap», «Wochentag·Zeit Matrix» und «EventDrops».

(Im Heatmap-Pfad bleibt im Code eine Beschränkung auf maximal 30 Tags bestehen — «Für die Kalender-Heatmap können maximal 30 Tags ausgewählt werden».)

Gemeinsam genutzte Filter​

SteuerelementOptionen
PrioritätAlle · Information · Warnung · Kritisch
IntervallStunden · Tage · Monate · Jahre — Zeitliche Bündelungseinheit des Charts

Bedienablauf​

  1. In der linken Baumstruktur die zu analysierenden Tags markieren — wenn nichts ausgewählt ist, erscheint der Hinweis «Bitte wählen Sie Tags für die Analyse aus»
  2. Alarm-Zeitraum sowie Visualisierung, Priorität und Intervall festlegen
  3. Analyse drücken (Ergebnisse sind bis dahin leer)
  4. Bei Erkennung eines Musters den Zeitraum/das Asset über Alarm oder Alarm-Suche eingrenzen und Details prüfen
  5. Falls eine Anpassung des Schwellenwerts erforderlich ist: Bei Bandalarmen in den Alarm-Einstellungen des Tags, bei EQL-Alarmen im Bildschirm Erweiterte Alarme ändern

Die Alarm-Analyse eignet sich für die nachträgliche Musteranalyse des Betriebs. Für die Echtzeitüberwachung verwenden Sie bitte den Alarm-Bildschirm.


Alarm-Performance-Bildschirm (/alarm/performance/index)​

Dieser Bildschirm bewertet anhand der Kennzahlen von ISA-18.2 / EEMUA 191, ob das Alarm-System für den Bediener handhabbar ist. Wählen Sie in der linken Karte Site · Zone · Linie aus und drücken Sie Abfrage (keine Auswahl auf Anlagenebene). Die Zeiträume im Header sind letzte 7 Tage · letzte 15 Tage · letzte 31 Tage.

Alarm-Performance-Bildschirm — Nummern geben die Lesereihenfolge an

NummerPositionFunktion
①LinksAbfragebedingungen — Site · Zone · Linie, Abfrage
②KopfzeileZeitraum — letzte 7, 15, 31 Tage
③Über Hauptbereich8 Kennzahlen-Kacheln
④DarunterTrend der Alarmmenge (10-Minuten-Balken, EEMUA-Referenzlinien)
⑤UntenPrioritätsverteilung · Top 10 häufigster Alarme · Chattering-Alarme · Dauerhafte Alarme
Während Ausblendung/Unterdrückung aufgetretene Alarme werden nicht gezählt

Die Kennzahlen zählen nur Ereignisse, die tatsächlich an den Bediener gemeldet wurden. Ereignisse, die während eines kurzzeitigen Ausblendens, einer Design-Unterdrückung oder eines Außer-Betrieb-Setzens auftraten, werden ausgeschlossen und separat in der Kachel Ausgeblendet/Unterdrückt aufgeführt.

8 Kennzahlen-Kacheln​

KachelBedeutung
Ø Alarme / 10 Min.Gemeldete Ereignisse im Zeitraum ÷ Anzahl der 10-Minuten-Fenster (auch Fenster ohne Alarm werden gezählt). Bewertung erfolgt über den Farbbalken darunter
Max. 10-Min-AlarmzahlEreigniszahl des am stärksten belasteten 10-Minuten-Fensters und dessen Startzeitpunkt
Anteil Alarmflut-ZeitAnteil der Fenster, die mehr als 10 Ereignisse hatten. Genau 10 Ereignisse gelten nicht als Alarmflut
Anteil Top 10 AlarmeProzentualer Anteil der 10 am häufigsten ausgelösten Alarm-Einstellungen an der Gesamtzahl
Chattering-Alarm-Einst.Anzahl der Einstellungen, die innerhalb einer Minute zum dritten Mal oder häufiger auslösten, sowie deren Ereigniszahl
Dauerhafte AlarmeAnzahl der Alarme, die derzeit seit über 24 Stunden aktiv sind
Ausgeblendet/Unterdr.Aktuelle Anzahl der kurzzeitig ausgeblendeten, design-unterdrückten und außer Betrieb gesetzten Alarme
Gemeldete AlarmzahlEreigniszahl im Zeitraum (ausgeblendete/unterdrückte Ereignisse ausgeschlossen)
Ø Alarme / 10 Min.Bewertung
≤ 1Sehr gut
≤ 2Handhabbar
≤ 10Überlastet
$> 10$Alarmflut

Charts und Tabellen​

KarteInhalt
Trend der Alarmmenge10-Minuten-Balken (bei Zeiträumen über 7 Tagen 1-Stunden-Balken — Höhe entspricht dem 10-Minuten-Schnitt dieser Stunde). Gestrichelte Linien bei 1, 2, 10 markieren die Kriterien; rote Balken zeigen Alarmfluten. Klick auf einen Balken führt zur Alarm-Suche für diesen Zeitraum
PrioritätsverteilungVergleich des Ist-Verhältnisses mit der ISA-18.2 Empfehlung (Hoch 5 · Mittel 15 · Niedrig 80 %). Kritisch · Warnung · Information entsprechen Hoch · Mittel · Niedrig
Top 10 häufigste AlarmeAlarm-Einstellung · Tag · Priorität · Ereignisse · Anteil
Chattering-AlarmeBis zu 50 Zeilen, sortiert nach Häufigkeit
Dauerhafte AlarmeBis zu 100 Zeilen, sortiert nach Dauer

In Zeiträumen ohne Alarme ist die Zahl 0, das Verhältnis -, und im Chart erscheint «In diesem Zeitraum liegen keine Alarme vor».

Dieselben Werte werden über GET /api/v5/alarm/performance?scope_type=SITE|AREA|LINE&scope_id=…&days=1..31 (oder from · to, bis zu 31 Tage) sowie per MCP get_alarm_performance ausgelesen. Bildschirm, API und AI verwenden dieselbe Berechnung.


Erweiterte Alarme (/alarm/config/index)​

🔔 고급 알람 [← 알람 이동] [↻] [▼] [➕ 알람 설정 추가]

Dieser Bildschirm dient der Verwaltung von Alarm-Einstellungen. EQL-Regeln definieren Alarme unter beliebigen Bedingungen; Einstellungen können kurzzeitig ausgeblendet oder außer Betrieb gesetzt werden. (Ähnlich wie Trigger in CEP, jedoch spezialisiert auf die Alarmauslösung.)

Bandalarme und EQL-Alarme​

BandalarmEQL-Alarm
Anzahl pro TagEinerMehrere möglich
ErstellungAlarm-Einstellung des Tags — wird von der Platform beim Speichern des Tags erstelltÜber Alarm-Einstellung hinzufügen in diesem Bildschirm
NameAutomatisch — <태그 이름> 밴드 알람 (in Installationssprache)Manuelle Benennung
ÄnderungAlarm-Einstellung des Tags. Änderung in der Zeile führt zum Tag-BildschirmFormular für Alarm-Einstellungen

Versuche, einen Bandalarm wie einen EQL-Alarm zu erstellen oder zu ändern, werden mit «Bandalarme werden in den Alarm-Einstellungen des Tags geändert» abgelehnt (HTTP 409, alarm.band.edit_on_tag). Die Beschränkung auf eine Band-Einstellung pro Tag wird durch eine DB-Unique-Constraint sichergestellt.

Alarm-Einstellungs-ID​

Neue Alarm-Einstellungs-IDs werden vom Server vergeben — Format: ALARM_CONFIG_ + 6 Stellen (z.B. ALARM_CONFIG_000376). Dies gilt auch für Bandalarme.

  • Ältere Formate(ALARM_CONFIG_00375, ALARM_CONFIG_TAG_…) bleiben gültig, können aber nur noch geändert werden.
  • Bei Neuerstellung per API muss die ID über GET /api/v5/alarm/config/new-id bezogen werden. Manuell vergebene IDs werden mit HTTP 422 alarm.invalid.alarm_config_id abgelehnt.
  • Benutzen Sie die Tag-ID nicht als Alarm-Einstellungs-ID zur Suche. Für die Band-Einstellung eines Tags wird in GET /api/v5/alarm/config/list/by-tag?tag_id=… nach Einträgen gesucht, bei denen alarm_config_priority gleich BAND ist.
Eine Alarm-Einstellung = Ein Tag

Ein EQL-Alarm gilt, genau wie ein Bandalarm, für einen einzigen Tag — der Ziel-Tag im Formular ist ein Pflichtfeld. Um Alarme basierend auf einer Kombination mehrerer Tags auszulösen, erstellen Sie zuerst einen virtuellen Tag und hängen den Alarm an diesen virtuellen Tag.

EQL-Alarme, die andere Tags lesen, mehrere Tags kombinieren oder keine Tag-Bedingung enthalten, können nicht gespeichert werden; auch die Funktion [EQL ausführen] im Formular wird aus denselben Gründen abgelehnt(alarm.eql.one_tag, HTTP 422) — siehe virtuelle Tags für detaillierte Texte und die Behandlung bereits gespeicherter Alarme.

Listen-Tabelle​

In der Liste des ADMIN erscheinen alle Alarm-Einstellungen. Somit können auch von anderen erstellte Alarme oder durch Tag-Speicherung entstandene Bandalarme hier ausgeblendet oder außer Betrieb gesetzt werden. In Listen anderer Rollen erscheinen nur die vom Benutzer selbst registrierten Alarm-Einstellungen. Alle Alarm-Einstellungen einer Anlage sind im Alarm-Tab des Asset-Baums einsehbar.

Im Header des Listen-Panels rechts befinden sich drei Schaltflächen: Ausgewählte Alarm-Einstellungen bereitstellen / Aufheben / Alle neu bereitstellen.

SpalteBreiteBeschreibung
Auswahl50pxCheckbox für Stapelbereitstellung/-aufhebung
Status80pxBadge für Bereitstellung/Aufhebung
Alarm-Einstellungs-ID150pxVom Server vergebene ID — Alarm-Einstellungs-ID
Name | Beschreibung200pxMetadaten für den Operator
Priorität80pxPriorität des auszulösenden Alarms (INFO/WARN/ERROR). Bei Bandalarmen BAND — die tatsächliche Priorität bestimmt der ausgelöste Band
NachrichtAutomatischTextkörper der Alarmnachricht bei Auslösung
Gesamte Auslösungen70pxKumulierte Anzahl der Übereinstimmungen
Letztes Auftreten110pxZeitpunkt des letzten Auftretens
Fehler70pxKumulierter Fehlerzähler
Erstellungsdatum110px
Letzte Änderung110px
Aktion110pxAuge-Symbol (Details) + ⋯ Menü: Ändern · Kurzzeitig ausblenden · Außer Betrieb setzen · Löschen

Ein Klick auf den Namen oder die ID führt zu den Alarm-Einstellungsdetails(/alarm/config/view/{id}) — inklusive Auftretungen der letzten 7 Tage, Änderungsverlauf und Lösungshilfe. Im Änderungsverlauf werden Band-Einstellungen nach dem jeweiligen Tag gruppiert.

Kurzzeitig ausblenden​

ADMIN kann über das ⋯ Menü einer Zeile die Funktion Kurzzeitig ausblenden wählen, um neue Ereignisse dieser Einstellung für eine festgelegte Zeit zu verbergen.

EingabeWert
Zeitraum30 Min. · 2 Std. · 8 Std. · Manuell (1~10080 Min., max. 7 Tage)
GrundWartung · Sensordefekt · Sonstiges
MemoOptional. Maximal 500 Zeichen

Ausgeblendete Einstellungen erscheinen in der Karte Kurzzeitig ausgeblendete Alarme unter der Liste — mit Grund, Memo, Person, Zeitpunkt, Restzeit und Ereignissen während der Ausblendung. Nach Ablauf der Zeit werden sie automatisch wieder sichtbar; zum vorzeitigen Aufheben klicken Sie auf Wieder anzeigen. Protokolle aus der Ausblendzeit bleiben erhalten.

Sicherheits- & Umweltalarme werden mit «Sicherheits- & Umweltalarme können nicht ausgeblendet werden» abgelehnt.

Außer Betrieb setzen und Rückführung​

Für Zeiträume, in denen Alarme aufgrund von Demontage, Gerätewechsel oder Kalibrierung bedeutungslos sind, kann ADMIN die Funktion Außer Betrieb setzen im ⋯ Menü nutzen.

EingabeWert
GrundSensordemontage · Geräteentfernung · Kalibrierung · Umbau · Sonstiges
MemoObligatorisch, wenn Grund «Sonstiges» oder Sicherheits-/Umweltalarm. Maximal 500 Zeichen
Geplante RückkehrLeer lassen für «unbestimmt». Keine automatische Rückführung nach Ablauf des Datums

Entfernte Einstellungen erscheinen in der Karte Außer Betrieb gesetzte Alarme — mit Grund, Memo, Genehmiger, Startzeitpunkt, geplanter Rückkehr, verstrichenen Tagen und Ereignissen während der Zeitspanne.

Die Rückführung erfolgt über die Schaltfläche Rückführen in der Zeile. Eine Rückführungsinspektion muss erfolgreich sein — der aktuelle Wert muss im Normalbereich liegen, und es muss ein Wert innerhalb der letzten 10 Minuten eingegangen sein.

ErgebnisFolge
BestandenDie Einstellung wird zurückgeführt
Nicht im Normalbereich«Aktueller Wert … — nicht im Normalbereich, Rückführung erfolglos». Der Zustand «Außer Betrieb» bleibt bestehen und eine Diagnose wird aktiviert
Kein Wert / Veraltet«Kein Wert nach Rückführung eingegangen oder letzter Wert älter als 10 Min., Rückführung erfolglos». Der Zustand «Außer Betrieb» bleibt bestehen und eine Diagnose wird aktiviert
Trotzdem zurückführenBei Angabe eines Grundes wird die Inspektion übersprungen. Aktive Bedingungen lösen sofort einen Alarm aus
DiagnoseWann
diagnostic.alarm.out_of_service_long«Außer Betrieb» dauerte länger als 30 Tage oder das geplante Rückkehrdatum ist überschritten
diagnostic.alarm.return_check_failedRückführungsinspektion fehlgeschlagen

Formular für Alarm-Einstellungen​

Über Alarm-Einstellung hinzufügen oben oder über die Zeilenaktion gelangt man zum Formular-Bildschirm(/alarm/config/form).

Erweitertes Alarm-Einstellungsformular — Nummern geben die Lesereihenfolge an

NummerPositionFunktion
①Oben rechts[EQL ausführen] — Prüft den Satz in ③ nach denselben Regeln wie beim Speichern, ohne zu speichern — siehe unten
②BasisinfoAlarmname · Beschreibung · Priorität(Information · Warnung · Kritisch) — alle Pflichtfelder
③Bedingung (EQL) → EQLAlarmbedingung. Wie im Beispiel der Hilfe «Alarm löst aus, wenn Ergebniswert der EQL-Bedingung existiert»: Muss eine band Spalte definieren und nur einen Ziel-Tag lesen. Fehlerursachen erscheinen im Kasten unter diesem Editor
④NachrichtAlarmnachricht. Ersetzungs-Token {tag_id} · {tag_name} · {timestamp} · {value}
⑤Ziel-TagPflichtfeld — «Bitte wählen Sie den Tag-Namen, der mit dem Alarm verknüpft werden soll.»
⑥Duplikatunterdrückung → Unterdrückungszeit (Min.)«Unterdrückt Push-Benachrichtigungen desselben Alarmtyps für die festgelegte Zeit.»
⑦Erkennungs-Einstellung (ISA-18.2) → Einschaltverzögerung«Bedingung muss für diese Zeit(ms) andauern, bevor Alarm ausgelöst wird. 0 zum Deaktivieren, max. 3.600.000 ms (1 Std.).»
⑧Unten rechts[Speichern]
EingabePfadBeschreibung
Alarm-Einstellungs-IDalarm_config_idNur Lesen (vom Server vergeben)
Alarm-Einstellungsnamealarm_config_nameMenschliche Identifikation
BeschreibungdescriptionMemo zum Zweck der Regel
EQLeplMatching-Bedingung. Muss band Spalte und 'NORMAL' definieren und nur einen Ziel-Tag lesen (z.B. SELECT timestamp, tag_id, tag_name, value, quality, error_code, CASE WHEN to_double(value) > 80 THEN 'HIGH' ELSE 'NORMAL' END AS band FROM Point(tag_id = 'TAG_…').win:length(1))
Ziel-Tagtag_idPflichtfeld. Ein Tag, an den dieser Alarm gebunden ist — Hilfe «Bitte wählen Sie den Tag-Namen, der mit dem Alarm verknüpft werden soll.»
Prioritätalarm_config_priorityINFO / WARN / ERROR
NachrichtmessageErsetzungs-Token {tag_id} · {tag_name} · {timestamp} · {value}
Unterdrückungszeit (Min.)duplicate_check_timeUnterdrückt Push-Benachrichtigungen desselben Alarmtyps für diese Zeit

Nach dem Speichern wird die Regel sofort in der Engine bereitgestellt. Wenn die Engine den Satz ablehnt, wird die Änderung rückgängig gemacht(«Änderung wurde rückgängig gemacht, da die Engine den Satz abgelehnt hat»). Zum Stoppen in der Liste markieren und Aufheben wählen; zum erneuten Aktivieren Ausgewählte Alarm-Einstellungen bereitstellen klicken.

[EQL ausführen] — Prüfung nach denselben Regeln wie beim Speichern​

① [EQL ausführen] prüft den Satz nach den gleichen Regeln wie beim Speichern. Das Ergebnis erscheint im Informationskasten direkt unter dem EQL-Editor. Hier wird auch angezeigt, wenn das Speichern(⑧) abgelehnt wird. Diese Ablehnung erfolgt nicht über ein separates Toast-Fenster.

FallKastenInhalt
Liest zwei oder mehr Tags · Keine Tag-Bedingung · Join mit anderen TagsOrange «Diese EQL entspricht nicht den Regeln»«EQL-Alarme dürfen nur einen Tag lesen — den Tag des Alarms. …»
band Spalte fehltOrange, gleiche Überschrift«EQL-Sätze müssen eine band-Spalte definieren (... END AS band).»
band kann 'NORMAL' nicht liefernOrange, gleiche Überschrift«EQL-Sätze müssen in der Lage sein, den Wert 'NORMAL' im band-Feld zu liefern. Andernfalls wird der Alarm nicht beendet.»
KompilierungsfehlerRot «EQL konnte nicht gelesen werden»Positions-Chip «Zeile N Spalte M»(Klick setzt Cursor), Ursachensatz, Korrekturhinweis, einklappbare Originalansicht der Engine. Markierungen erscheinen auch im Editor
BestandenGrün «Prüfung bestanden»

Alle Ablehnungen erfolgen per HTTP 422; nach Korrektur des Satzes verschwindet die Anzeige. Falls die CEP nicht gestartet ist, liegt kein Fehler im Satz vor, sondern es erscheint ein Toast: «Verbindung zur CEP-Engine fehlgeschlagen, EQL konnte nicht validiert werden».

Wenn ein gespeicherter Alarm beim Serverstart oder bei der Neubereitstellung nicht in die Engine geladen werden kann, wird für diesen Alarm die Diagnose «Bereitstellung Tag-Alarm fehlgeschlagen» (diagnostic.tag.alarm_deploy_failed) aktiviert. Die Funktion «Bildschirm zur Korrektur öffnen» in den Diagnosedetails öffnet dieses Formular. Nach korrekter Speicherung und Bereitstellung wird die Diagnose automatisch aufgehoben — Virtuelle Tags Betrieb.

EQL-Alarme können auch automatisch über den flow_create_alarm_config Knoten in Flows erstellt werden.


Alarm-Detailbildschirm (/alarm/view/{alarm_seq})​

Ein Klick auf einen Alarm im Alarm- oder Alarm-Suchbildschirm führt zu dieser Detailansicht. Dies ist eine Analyseansicht, die einen Alarm und dessen Kontext (Tag, Daten, andere Alarme, Statistiken, Empfänger) zusammenfasst.

Oben — Identifikations-Header​

🔔 알람 | {alarm_seq} [ 사이트 > 구역 > 라인 > 설비 > 태그명 ]
BereichAktion
← Vorheriger Bildschirmback() — Zurück zur Alarm-Liste
Aktualisierenrefresh() — Bildschirminhalt neu laden

Panel 1 — Alarm-Informationen (Panel 알람 정보)​

Tabellarische Übersicht der Kerninformationen des Alarms. Im Panel-Header befindet sich die Schaltfläche Alarm bestätigen (für alle Rollen); für ADMIN ist zusätzlich Alle Alarme bestätigen sichtbar.

Alarm bestätigen bestätigt diesen einen Alarm. Bei bereits bestätigten Alarmen ist die Schaltfläche deaktiviert; beim Hovern wird angezeigt, wer wann bestätigt hat. Das reine Öffnen des Bildschirms führt nicht zur Bestätigung — Bestätigen.

SpalteBreiteBeschreibung
Priorität200pxFarbbadge für INFO/WARN/ERROR
Aktiv60pxStatus der Aktivität
Alarm Startzeit120pxZeitpunkt des Auftretens
Alarm Endzeit120pxZeitpunkt der Aufhebung (bei Aktivität -)
Tag400px🏷 Tag-Name — Klick führt zu Tag-Details
NachrichtAutomatischTextkörper des Alarms
Bestätigung100pxAnzeige, ob bestätigt wurde

Datensituation Fieldset​

Zeigt die Tag-Daten im Zeitraum ±Abfragezeitraum um den Alarmzeitpunkt in Tabellenform. Im Header rechts befindet sich die Schaltfläche Zum Trend(goStorage()).

SpalteBreiteBeschreibung
Zeitstempel180pxMesszeitpunkt
Wert200pxTag-Wert zu diesem Zeitpunkt
Einheit50pxMesseinheit
Datentyp100pxINT/FLOAT/BOOL etc.
Qualität100pxDatenqualitäts-Code
Fehlercode100pxFehler zu diesem Zeitpunkt (falls vorhanden)
Verzögerung[MS]100pxIngress-Verzögerung
AttributAutomatischZusätzliche Attribute

Dies ermöglicht die Analyse der Tag-Werte unmittelbar vor und nach der Alarmauslösung. Über Zum Trend gelangt man zu einer längeren Zeitreihe.

Alarm-Liste Fieldset​

Verlauf anderer Alarme desselben Tags im gleichen Zeitraum(${date_from} ~ ${date_to}). Über Zu Alarme(goAlarm()) rechts gelangt man zurück zum Alarm-Menü.

SpalteBreiteBeschreibung
🔔30pxAlarm-Glockensymbol
Alarmnummer100pxAlarm-ID
Priorität80pxINFO/WARN/ERROR
Alarmdatum160pxZeitpunkt des Auftretens
InhaltAutomatischAlarmnachricht
Bestätigung60pxAnzeige, ob bestätigt wurde
Bestätigungszeit160pxZeitpunkt der Bestätigung

Diese Tabelle zeigt auf einen Blick, ob für denselben Tag im gleichen Zeitraum andere Arten von Alarmen aufgetreten sind.

Alarm-Trend-Panel​

Visualisierung des Alarm-Trends im Zeitraum mittels Zeitbalken. Zeigt die Auftretenshäufigkeit und Muster (z.B. Konzentration auf bestimmte Uhrzeiten).

Alarm-Statistik-Panel​

Zusammenfassung der Alarmstatistiken. Zähler nach Priorität und ON/OFF-Status werden als Donuts/Balken dargestellt.

Alarm-Empfänger-Panel​

Zeigt den Bestätigungsstatus und den Versandweg an.

  • Oberste Zeile — Bei Bestätigt: Bestätiger (Benutzer oder Mitarbeiter) und Zeitpunkt. Bei Unbestätigt: Schaltfläche [Bestätigen] (nur bei entsprechender Berechtigung sichtbar).
  • Darunterliegende Tabelle — Tatsächliche Versandprotokolle.
SpalteBeschreibung
EmpfängerBenutzer oder Mitarbeiter
KanalKonsole · E-Mail · SMS · App
VersandzeitZeitpunkt des Versands

Falls an niemanden gesendet wurde, erscheint: «An niemanden gesendet — lag im Unterdrückungsfenster oder es gab keine Empfänger».

Tag-Informations-Panel​

Detaillierte Informationen zum auslösenden Tag — Einstellungen, Alarmbänder, Validierung, OPC-Mapping, Metadaten. Weitere Details siehe Tag-Details.

Nutzungsmuster​

AnalyseflussBildschirmnavigation
Kausalanalyse des AlarmsAlarm-Info → Datensituationstabelle (Trend davor) → Zum Trend (Zeitreihe +/- 30 Min)
Verfolgung wiederkehrender AlarmeAlarm-Liste Fieldset → Andere Alarme desselben Tags → Mustererkennung
Prüfung der SchwellenwerteTag-Info-Panel → Alarmband-Einstellungen → Prädiktive Analyse zur Neuberechnung
Validierung der EmpfängerAlarm-Empfänger-Panel → Wer hat empfangen und wer hat bestätigt

Anwendungsszenarien​

SzenarioBildschirmAblauf
Aktuelle Alarme prüfenAlarmBildschirmeintritt → Glocken-Badge oben rechts + ON-Alarme in der Liste links
Analyse von ERRORs von gesternAlarm-SucheZeitraum = Gestern / Priorität = Kritisch / Site-Auswahl
Alarmmuster nach Wochentag/UhrzeitAlarm-AnalyseIm Modus Wochentags-Zeitmuster wiederkehrende Tage/Zeiten identifizieren
Anpassung Schwellenwerte bei WiederholungenTag / Erweiterte AlarmeBei Bandalarmen: Tag-Alarm-Einstellungen; bei EQL-Alarmen: Regel ändern → Neubereitstellung
Bewertung der AlarmbelastungAlarm-PerformanceFarbbalken Ø Alarm / 10 Min → Top 10 → Chattering-Einstellungen bereinigen
Alarme während Sensorkalibrierung entfernenErweiterte Alarme⋯ → Außer Betrieb setzen (Kalibrierung) → Rückführung nach Abschluss
Identifikation von Alarmfluten pro GerätAlarm-Analyse → Anlagen-TreemapAssets mit großer Fläche → Nur dieses Asset in Alarm-Suche prüfen
Automatische AlarmbenachrichtigungFlowflow_on_alarm Trigger → E-Mail/SMS Versand

Häufig gestellte Fragen​

F. Wie viele Einträge werden in der Alarmliste angezeigt? A. Alarme des Suchzeitraums werden seitenweise angezeigt; es kann bis zu den neuesten 10.000 Ereignissen geblättert werden. Für ältere Daten grenzen Sie den Zeitraum ein oder nutzen Sie die Alarm-Suche.

F. Verschwinden Alarme, wenn ich auf «Alle Alarme bestätigen» klicke? A. Nein. Sie ändern nur den Status auf «bestätigt»; aktive Alarme bleiben bestehen. Beachten Sie, dass dies für alle Benutzer gilt — eine Bestätigung gilt pro Alarm, nicht pro Person.

F. Ich bin ein normaler Benutzer (USER) und sehe die Schaltfläche [Alle Alarme bestätigen] nicht. A. Diese Funktion ist exklusiv für ADMIN. USER bestätigen Alarme einzeln über [Alarm bestätigen] in den Alarm-Details. Mitarbeiter im Feld können dies auch über die Vor-Ort-App tun.

F. Alarme an einer Anlage in Reparatur lösen nicht aus. A. Wenn für eine Anlage eine Störungsreparatur läuft, werden neu auftretende Alarme dieses Tags unterdrückt (ausgenommen Sicherheits- & Umweltalarme). Dies ist im Wartungs-Tab der Anlage unter «N Alarme durch diese Reparatur ausgeblendet» einsehbar. Wenn die Bedingung bei Abschluss der Reparatur noch erfüllt ist, löst zu diesem Zeitpunkt ein neuer Alarm aus.

F. Ein Alarm wurde geschlossen, der Aufhebungsgrund ist jedoch «Außer Betrieb». A. Dies bedeutet, dass ein Administrator die Alarm-Einstellung außer Betrieb gesetzt hat. Es bedeutet nicht, dass die Ursache des Problems behoben wurde.

F. Ich möchte bei Alarmauslösung automatisch E-Mails/SMS versenden. A. Dies können Sie über den Bildschirm Flow realisieren, indem Sie den flow_on_alarm Trigger mit den Knoten flow_send_email / flow_send_sms verbinden.

F. Ich habe einen EQL-Alarm registriert, aber er löst nicht aus. A. Prüfen Sie in der Liste, ob der Status auf «Bereitgestellt» steht. Wenn er auf «Aufgehoben» steht, markieren Sie die Einstellung und klicken Sie auf Ausgewählte Alarm-Einstellungen bereitstellen. Falls bereits bereitgestellt, prüfen Sie über das ⋯ Menü, ob er kurzzeitig ausgeblendet oder außer Betrieb gesetzt wurde, oder ob die Anlage in geplanter Wartung/Reparatur ist.

F. Was bedeutet die Fläche in der Treemap der Alarm-Analyse? A. Sie repräsentiert die kumulierte Häufigkeit der Alarme dieses Assets/Tags. Je größer die Fläche, desto häufiger sind Alarme an diesem Asset aufgetreten.

F. Die Prioritätsfarben der Alarme unterscheiden sich leicht zwischen den Bildschirmen. A. Die Farbtöne variieren je nach Bereich minimal, die Bedeutung bleibt jedoch identisch. Die genaue Farbzuordnung finden Sie in der Statuscode-Definition.

F. Welche Variablen können im Template für Alarmnachrichten verwendet werden? A. Nutzen Sie die Ersetzungs-Token {tag_id} · {tag_name} · {timestamp} · {value} aus der Formularhilfe.

F. Wie kann ich den Verlauf ausgelöster Alarme langfristig archivieren? A. Sie können die Standard-Aufbewahrungsdauer erhöhen oder die Daten über den flow_on_alarm Trigger in Flow automatisch in ein externes System übertragen.

F. Warum ist der ON/OFF-Donut immer 100% ON? A. Dies geschieht, wenn in den Suchergebnissen keine aufgehobenen Alarme vorhanden sind. Das bedeutet, alle Alarme wurden als aktiv ausgelöst und noch nicht beendet.

F. Was kann ich im Alarm-Detailbildschirm sehen? A. Sie erhalten eine kombinierte Ansicht aus Tag-Daten zum Zeitpunkt der Auslösung, anderen Alarmen desselben Tags, Trends, Statistiken, Bestätigungsstatus, Versandweg und Tag-Informationen.


Verwandte Bildschirme​

  • Dashboard — Alarmzahl des heutigen Tages in KPI-Karten, Alarmzähler im Diagnose-Panel
  • Tagesstatistik — Vergleichsanalyse von Alarmen nach Site, Asset und Tag
  • Datenpunkt — Optionen zur Alarmdarstellung in Trend-Charts
  • CEP — Übergeordnetes Konzept von Alarmen (Event-Regeln)
  • Virtuelle Tags — Erstellung von Alarmen bei Bedingungen aus mehreren Tags
  • Flow — Automatisches Alarm-Routing und Benachrichtigungsautomatisierung
  • Statuscode-Definition — Farben der Alarmprioritäten
  • Anlage — Heutige Alarmzähler (Information/Warnung/Kritisch) in den Karten