[comment]: # ({29480506-29480506}) # 1 Konfigurieren eines Auslösers [comment]: # ({/29480506-29480506}) [comment]: # ({84bca7a2-ea19cfe1}) #### Übersicht Um einen Auslöser zu konfigurieren, gehen Sie wie folgt vor: - Gehen Sie zu: *Data collection* > *Hosts* - Klicken Sie in der Zeile des Hosts auf *Auslöser* - Klicken Sie rechts auf *Auslöser erstellen* (oder auf den Namen des Auslösers, um einen vorhandenen Auslöser zu bearbeiten) - Geben Sie die Parameter des Auslösers im Formular ein Siehe auch [allgemeine Informationen](/manual/config/triggers) zu Auslösern und deren Berechnungszeiten. [comment]: # ({/84bca7a2-ea19cfe1}) [comment]: # ({d8575635-f29d794b}) #### Konfiguration Die Registerkarte **Trigger** enthält alle wesentlichen Trigger-Attribute. ![](../../../../assets/en/manual/config/triggers/trigger.png){width="600"} Alle obligatorischen Eingabefelder sind mit einem roten Sternchen markiert. |Parameter|Beschreibung| |--|--------| |*Name*|Triggername.
Unterstützte [Makros](/manual/appendix/macros/supported_by_location) sind: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.VALUE.AGE}, {ITEM.VALUE.DATE}, {ITEM.VALUE.TIME}, {ITEM.VALUE.TIMESTAMP}, {ITEM.LASTVALUE}, {ITEM.LASTVALUE.AGE}, {ITEM.LASTVALUE.DATE}, {ITEM.LASTVALUE.TIME}, {ITEM.LASTVALUE.TIMESTAMP}, {ITEM.LOG.\*} und {$MACRO}-Benutzermakros.
Die Makros **$1, $2...$9** können verwendet werden, um auf die erste, zweite...neunte Konstante des Ausdrucks zu verweisen.
*Hinweis*: Die Makros $1-$9 werden korrekt aufgelöst, wenn sie sich auf Konstanten in relativ einfachen, geradlinigen Ausdrücken beziehen. Der Name "Processor load above $1 on {HOST.NAME}" wird beispielsweise automatisch in "Processor load above 5 on New host" geändert, wenn der Ausdruck last(/New host/system.cpu.load\[percpu,avg1\])>5 lautet.| |*Event name*|Wenn definiert, wird dieser Name zum Erstellen des Problemereignisnamens verwendet. Standardmäßig ist der Ereignisname identisch mit dem Triggernamen.
Der Ereignisname kann verwendet werden, um aussagekräftige Alarme mit Problemdaten zu erstellen (siehe [Beispiel](/manual/config/triggers/expression#example-18)).
Es wird derselbe Satz an Makros unterstützt wie im Triggernamen, zusätzlich die Ausdrucksmakros {TIME}, {TIMESTAMP} und {?EXPRESSION}.| |*Operational data*|Operational data ermöglicht die Definition beliebiger Zeichenfolgen zusammen mit Makros. Die Makros werden dynamisch in Echtzeitdaten unter *Monitoring* > *[Problems](/manual/web_interface/frontend_sections/monitoring/problems)* aufgelöst. Während Makros im Triggernamen (siehe oben) zum Zeitpunkt des Auftretens eines Problems auf ihre Werte aufgelöst werden und die Grundlage für einen statischen Problemnamen bilden, behalten die Makros in den Operational data die Fähigkeit, die aktuellsten Informationen dynamisch anzuzeigen. Wenn auf Trigger-Ebene keine Operational data konfiguriert ist, werden die neuesten Werte aller Datenpunkte aus dem Ausdruck angezeigt.
Es wird derselbe Satz an Makros unterstützt wie im Triggernamen.| |*Severity*|Legen Sie die erforderliche Trigger-[Schweregrad](severity) fest, indem Sie auf die Schaltflächen klicken.| |*Expression*|Logischer [Ausdruck](expression), der zur Definition der Bedingungen eines Problems verwendet wird.
[Zeit-Suffixe](/manual/appendix/suffixes#time-suffixes) und [Speichergrößen-Suffixe](/manual/appendix/suffixes#memory-size-suffixes) werden unterstützt.
Ein Problem wird erstellt, nachdem alle in den Ausdruck aufgenommenen Bedingungen erfüllt sind, d. h. der Ausdruck zu TRUE ausgewertet wird. Das Problem wird so bald behoben, wie der Ausdruck zu FALSE ausgewertet wird, sofern in *Recovery expression* keine zusätzlichen Wiederherstellungsbedingungen angegeben sind.| |*OK event generation*|Optionen zur Erzeugung von OK-Ereignissen:
**Expression** - OK-Ereignisse werden auf Grundlage desselben Ausdrucks wie Problemereignisse erzeugt;
**Recovery expression** - OK-Ereignisse werden erzeugt, wenn der Problemausdruck zu FALSE und der Wiederherstellungsausdruck zu TRUE ausgewertet wird;
**None** - in diesem Fall kehrt der Trigger niemals von selbst in den OK-Zustand zurück.| |*Recovery expression*|Logischer [Ausdruck](expression) (optional), der zusätzliche Bedingungen definiert, die erfüllt sein müssen, bevor das Problem behoben wird, nachdem der ursprüngliche Problemausdruck bereits als FALSE ausgewertet wurde.
Der Wiederherstellungsausdruck ist für die Trigger-[Hysterese](/manual/config/triggers/expression#hysteresis) nützlich. Es ist **nicht** möglich, ein Problem allein durch den Wiederherstellungsausdruck zu beheben, wenn der Problemausdruck weiterhin TRUE ist.
Dieses Feld ist nur verfügbar, wenn für *OK event generation* 'Recovery expression' ausgewählt ist.| |*PROBLEM event generation mode*|Modus zur Erzeugung von Problemereignissen:
**Single** - ein einzelnes Ereignis wird erzeugt, wenn ein Trigger zum ersten Mal in den Zustand 'Problem' wechselt;
**Multiple** - bei *jeder* 'Problem'-Auswertung des Triggers wird ein Ereignis erzeugt.| |*OK event closes*|Wählen Sie aus, ob das OK-Ereignis schließt:
**All problems** - alle Probleme dieses Triggers;
**All problems if tag values match** - nur jene Triggerprobleme mit übereinstimmenden Ereignis-Tag-Werten.| |*Tag for matching*|Geben Sie den Namen des Ereignis-Tags ein, der für die Ereigniskorrelation verwendet werden soll.
Dieses Feld wird angezeigt, wenn für die Eigenschaft *OK event closes* 'All problems if tag values match' ausgewählt ist, und ist in diesem Fall obligatorisch.| |*Allow manual close*|Aktivieren Sie dieses Kontrollkästchen, um das [manuelle Schließen](/manual/config/events/manual_close) von durch diesen Trigger erzeugten Problemereignissen zu erlauben. Das manuelle Schließen ist beim Bestätigen von Problemereignissen möglich.| |*Menu entry name*|Wenn nicht leer, wird der hier eingegebene Name (bis zu 64 Zeichen) an mehreren Stellen im Frontend als Bezeichnung für die im Parameter *Menu entry URL* angegebene Trigger-URL verwendet. Wenn leer, wird standardmäßig der Name *Trigger URL* verwendet.
Es wird derselbe Satz an Makros unterstützt wie im Triggernamen, zusätzlich {EVENT.ID}, {HOST.ID} und {TRIGGER.ID}.| |*Menu entry URL*|Wenn nicht leer, ist die hier eingegebene URL (bis zu 2048 Zeichen) an mehreren Stellen im [Ereignismenü](/manual/web_interface/menu/event_menu) im Frontend als Link verfügbar, zum Beispiel beim Klicken auf den Problemnamen in *Monitoring > [Problems](/manual/web_interface/frontend_sections/monitoring/problems)* oder im Dashboard-Widget *[Problems](/manual/web_interface/frontend_sections/dashboards/widgets/problems#using-the-widget)*.
Es wird derselbe Satz an Makros unterstützt wie im Triggernamen, zusätzlich {EVENT.ID}, {HOST.ID} und {TRIGGER.ID}. Hinweis: Benutzermakros mit geheimen Werten werden in der URL nicht aufgelöst.| |*Description*|Textfeld zur Bereitstellung weiterer Informationen zu diesem Trigger. Kann Anweisungen zur Behebung eines bestimmten Problems, Kontaktdaten der zuständigen Mitarbeiter usw. enthalten.
Es wird derselbe Satz an Makros unterstützt wie im Triggernamen.| |*Enabled*|Wenn Sie dieses Kontrollkästchen deaktivieren, wird der Trigger bei Bedarf deaktiviert.
Probleme eines deaktivierten Triggers werden im Frontend nicht mehr angezeigt, aber nicht gelöscht.| Die Registerkarte **Tags** ermöglicht es Ihnen, Trigger-Ebene-[Tags](/manual/config/tagging) zu definieren. Alle Probleme dieses Triggers werden mit den hier eingegebenen Werten versehen. ![](../../../../assets/en/manual/config/triggers/trigger_b.png){width="600"} Zusätzlich ermöglicht die Option *Inherited and trigger tags* das Anzeigen von auf Vorlagenebene definierten Tags, wenn der Trigger aus dieser Vorlage stammt. Wenn mehrere Vorlagen denselben Tag haben, werden diese Tags einmal angezeigt und die Vorlagennamen durch Kommas getrennt. Ein Trigger "erbt" und zeigt keine Host-Ebene-Tags an. |Parameter|Beschreibung| |--|--------| |*Name/Value*|Legen Sie benutzerdefinierte Tags fest, um Triggerereignisse zu kennzeichnen.
Tags sind ein Paar aus Tag-Namen und Wert. Sie können nur den Namen verwenden oder ihn mit einem Wert kombinieren. Ein Trigger kann mehrere Tags mit demselben Namen, aber unterschiedlichen Werten haben.
Benutzermakros, Benutzermakros mit Kontext, Low-Level-Discovery-Makros und Makro-[Funktionen](/manual/config/macros/macro_functions) mit `{{ITEM.VALUE}}`, `{{ITEM.LASTVALUE}}` werden in Ereignis-Tags unterstützt. Low-Level-Discovery-Makros können innerhalb des Makro-Kontexts verwendet werden.
Das Makro {TRIGGER.ID} wird in Trigger-Tag-Werten unterstützt. Es kann nützlich sein, um Trigger zu identifizieren, die aus Trigger-Prototypen erstellt wurden, und beispielsweise Probleme dieser Trigger während Wartungsarbeiten zu unterdrücken.
Wenn die Gesamtlänge des erweiterten Werts 255 überschreitet, wird er auf 255 Zeichen gekürzt.
Siehe alle für Ereignis-Tags unterstützten [Makros](/manual/config/tagging#macro-support).
[Ereignis-Tags](/manual/config/tagging) können für die Ereigniskorrelation, in Aktionsbedingungen verwendet werden und sind außerdem unter *Monitoring* > *Problems* oder im *Problems*-Widget sichtbar.| Die Registerkarte **Dependencies** enthält alle [Abhängigkeiten](dependencies) des Triggers. Klicken Sie auf *Add*, um eine neue Abhängigkeit hinzuzufügen. ::: noteclassic Sie können einen Trigger auch konfigurieren, indem Sie einen vorhandenen öffnen, auf die Schaltfläche *Clone* klicken und dann unter einem anderen Namen speichern. ::: [comment]: # ({/d8575635-f29d794b}) [comment]: # ({dbfe2e70-dbfe2e70}) #### Testen von Ausdrücken Es ist möglich, den konfigurierten Auslöser-Ausdruck zu testen, um zu sehen, welches Ausdrucksergebnis in Abhängigkeit vom empfangenen Wert entstehen würde. Der folgende Ausdruck aus einer offiziellen Vorlage wird als Beispiel verwendet: avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN} or last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS} Um den Ausdruck zu testen, klicken Sie im Feld des Ausdrucks auf *Expression constructor*. ![](../../../../assets/en/manual/config/triggers/trigger_test.png) Im Expression constructor werden alle einzelnen Ausdrücke aufgelistet. Um das Testfenster zu öffnen, klicken Sie unter der Ausdragsliste auf *Test*. ![](../../../../assets/en/manual/config/triggers/expr_test_button.png){width="600"} Im Testfenster können Sie Beispielwerte eingeben ('80', '70', '0', '1' in diesem Beispiel) und anschließend durch Klicken auf die Schaltfläche *Test* das Ausdrucksergebnis anzeigen lassen. ![](../../../../assets/en/manual/config/triggers/expr_test.png){width="600"} Das Ergebnis der einzelnen Ausdrücke sowie des gesamten Ausdrucks kann angezeigt werden. "TRUE" bedeutet, dass der angegebene Ausdruck korrekt ist. In diesem speziellen Fall A ist "80" größer als der angegebene Wert {$TEMP_WARN}, in diesem Beispiel "70". Wie erwartet wird ein Ergebnis von "TRUE" angezeigt. "FALSE" bedeutet, dass der angegebene Ausdruck nicht korrekt ist. In diesem speziellen Fall B muss {$TEMP_WARN_STATUS} "1" mit dem angegebenen Wert "0" in diesem Beispiel übereinstimmen. Wie erwartet wird ein Ergebnis von "FALSE" angezeigt. Der gewählte Ausdruckstyp ist "OR". Wenn mindestens eine der angegebenen Bedingungen (in diesem Fall A oder B) TRUE ist, ist auch das Gesamtergebnis TRUE. Das bedeutet, dass der aktuelle Wert den Warnwert überschreitet und ein Problem aufgetreten ist. [comment]: # ({/dbfe2e70-dbfe2e70})