Konfigurieren einer Ereignisrichtlinie zum Ausführen von Befehlen im Betriebsmodus

Befehle für den Betriebsmodus führen einen Vorgang aus oder stellen eine Diagnoseausgabe auf einem Gerät bereit, auf dem Junos OS ausgeführt wird. Sie ermöglichen es Ihnen, Statistiken und Informationen über den aktuellen Betriebsstatus eines Geräts anzuzeigen. Sie ermöglichen es Ihnen auch, Korrekturmaßnahmen zu ergreifen, wie z. B. Softwareprozesse neu zu starten, eine Physical Interface Card (PIC) offline und wieder online zu schalten, auf redundante Schnittstellen umzuschalten und die LSP-Bandbreite (Label Switching Protocol) anzupassen. Weitere Informationen zu Befehlen im Betriebsmodus finden Sie im CLI-Explorer.

Sie können eine Ereignisrichtlinie konfigurieren, die Befehle im Betriebsmodus ausführt und die Ausgabe dieser Befehle zur Analyse an einen angegebenen Speicherort hochlädt, indem Sie die folgenden Anweisungen auf Hierarchieebene [edit event-options] einfügen:

In der events Anweisung können Sie mehrere Ereignisse auflisten. Wenn eines oder mehrere der aufgelisteten Ereignisse eintreten, führt der eventd-Prozess die für die commands Anweisung konfigurierten Betriebsmodusbefehle aus. Schließen Sie jeden Befehl in Anführungszeichen (" ") ein. Der eventd-Prozess gibt die Befehle in der Reihenfolge aus, in der sie in der Konfiguration angezeigt werden. In der folgenden Konfiguration bewirkt die Ausführung von policy1 beispielsweise, dass zuerst der show interfaces Befehl ausgegeben wird, gefolgt vom show chassis alarms Befehl:

Sie können Variablen in den Befehl aufnehmen, damit Daten aus dem auslösenden Ereignis automatisch in die Befehlssyntax aufgenommen werden. Der eventd-Prozess ersetzt jede Variable durch Werte, die in dem Ereignis enthalten sind, das die Richtlinie auslöst. Sie können Befehlsvariablen der folgenden Formen verwenden:

• {$$.attribute-name}—Die Notation mit doppeltem Dollarzeichen ($$) stellt das Ereignis dar, das die Richtlinie auslöst. In Kombination mit einem Attributnamen wird die Variable in den Wert des Attributs aufgelöst, das dem auslösenden Ereignis zugeordnet ist. Wird z. B. in den Schnittstellennamen aufgelöst, {$$.interface-name} der dem auslösenden Ereignis zugeordnet ist.

• {$event.attribute-name}—Das einzelne Dollarzeichen mit der Notation "Ereignisname" ($event) stellt das letzte übereinstimmende eventEreignis dar. In Kombination mit einem Attributnamen wird die Variable in den Wert des Attributs aufgelöst, das diesem Ereignis zugeordnet ist. Wenn z. B. eine Richtlinie den show interfaces {$COSD_CHAS_SCHED_MAP_INVALID.interface-name} Befehl ausgibt, wird die {$COSD_CHAS_SCHED_MAP_INVALID.interface-name} Variable in den Schnittstellennamen aufgelöst, der dem letzten COSD_CHAS_SCHED_MAP_INVALID vom Ereignisprozess zwischengespeicherten Ereignis zugeordnet ist.

• {$*.attribute-name}—Das Dollarzeichen mit dem Sternchen ($*) stellt das letzte Ereignis dar, das mit einem der korrelierenden Ereignisse übereinstimmt. Die Variable wird in den Wert des Attributs aufgelöst, das dem letzten Ereignis zugeordnet ist und mit einem der in der Richtlinienkonfiguration angegebenen korrelierten Ereignisse übereinstimmt.

Für ein bestimmtes Ereignis können Sie eine Liste von Ereignisattributen anzeigen, auf die Sie in einem Betriebsmodusbefehl verweisen können, indem Sie den help syslog event folgenden Befehl ausführen:

In der folgenden Befehlsausgabe wird z. B. Text in spitzen Klammern (< >) angezeigt, dass classifier-type es sich um ein Attribut des cosd_unknown_classifier Ereignisses handelt:

Eine weitere Möglichkeit, eine Liste von Ereignisattributen anzuzeigen, besteht darin, den set attributes-match event? Befehl configuration mode auf Hierarchieebene [edit event-options policy policy-name] abzugeben:

In der folgenden Befehlsausgabe wird in der event.attribute Liste beispielsweise angezeigt, dass es classifier-type sich um ein Attribut des cosd_unknown_classifier Ereignisses handelt:

Hinweis:

In diesem set Befehl gibt es kein Leerzeichen zwischen dem Ereignisnamen und dem Fragezeichen (?).

Um eine Liste aller Ereignisattribute anzuzeigen, auf die Sie verweisen können, geben Sie den set attributes-match ? Befehl Konfigurationsmodus auf Hierarchieebene [edit event-options policy policy-name] ein:

Wenn der eventd-Prozess die Befehle ausführt, lädt er die Datei mit der Befehlsausgabe an den in der destination Anweisung angegebenen Speicherort hoch. Fügen Sie in der destination Anweisung einen Zielnamen ein, der auf Hierarchieebene [edit event-options destinations] konfiguriert ist. Weitere Informationen finden Sie unter Beispiel: Definieren von Zielen für die Dateiarchivierung nach Ereignisrichtlinien.

Definieren Sie in der output-filename Anweisung eine beschreibende Zeichenfolge, die im Dateinamen enthalten sein soll. Jede hochgeladene Datei enthält auch den Hostnamen und den Zeitstempel im Dateinamen, um sicherzustellen, dass jeder Dateiname eindeutig ist. Wenn eine Richtlinie innerhalb von 1 Sekunde mehrmals ausgelöst wird, wird eine Indexnummer an den Dateinamen angehängt, um sicherzustellen, dass die Dateinamen weiterhin eindeutig sind. Der Indexnummernbereich ist 001 bis 999.

Ab Junos OS Version 14.1R3 werden die Namenskonvention und das Format für die von eventd generierte Ausgabedatei geändert. Wenn eventd die auf der [edit event-options policy policy-name then execute-commands commands] Hierarchieebene definierten Befehle ausführt und eine Datei mit der Befehlsausgabe generiert, hängt der Name der Datei von der Version von Junos OS ab, die auf dem Gerät ausgeführt wird. Vor Junos OS Version 14.1R3 hatte der Dateiname die folgende Namenskonvention:

Ab Junos OS Version 14.1R3 wird die output-filename Zeichenfolge im Dateinamen nach dem Zeitstempel eingefügt.

Wenn Sie beispielsweise auf einem Gerät mit dem Namen r1, auf dem Junos OS Version 14.1R3 oder eine höhere Version ausgeführt wird, die output-filename Anweisung als ifl-events konfigurieren und diese Ereignisrichtlinie dreimal innerhalb von 1 Sekunde ausgelöst wird, erhalten die Dateien den Namen:

• r1_20060623_132333_ifl-Veranstaltungen

• r1_20060623_132333_ifl-events_001

• r1_20060623_132333_ifl-events_002

Standardmäßig ist das Befehlsausgabeformat Junos Extensible Markup Language (XML). Konfigurieren Sie die output-format text Anweisung so, dass die Befehlsausgabe als ASCII-Text formatiert wird.