Trace-Op-Skriptverarbeitung auf Geräten mit Junos OS
Ablaufverfolgungsvorgänge für Op-Skripts verfolgen Op-Skriptvorgänge und zeichnen sie in einer Protokolldatei auf. Die protokollierten Fehlerbeschreibungen enthalten detaillierte Informationen, die Ihnen helfen, Probleme schneller zu lösen.
Bei Junos OS besteht der Standardvorgang der Op-Skriptablaufverfolgung darin, wichtige Ereignisse wie Fehler, Warnungen, Statusmeldungen und Skriptverarbeitungsereignisse in der Datei /var/log/op-script.log auf dem Gerät zu protokollieren. Wenn die Datei op-script.log 128 Kilobyte (KB) erreicht, wird sie umbenannt, wobei die Zahl 0 bis 9 (in aufsteigender Reihenfolge) an das Ende der Datei angehängt und dann komprimiert wird. Die resultierenden Dateien werden op-script.log.0.gz und dann op-script.log.1.gz, bis 10 Ablaufverfolgungsdateien vorhanden sind. Dann wird die älteste Trace-Datei (op-script.log.9.gz) überschrieben.
Junos OS Evolved erfasst standardmäßig Ablaufverfolgungsdaten für alle Anwendungen und sammelt die Daten für alle Skripttypen in Ablaufverfolgungsdateien, die der cscript Anwendung entsprechen. Um die Ablaufverfolgungsdaten anzuzeigen, geben Sie den show trace application cscript Befehl aus. Weitere Informationen finden Sie unter Trace-Skriptverarbeitung auf Geräten, auf denen Junos OS Evolved ausgeführt wird.
Mindestkonfiguration für die Aktivierung von Trace-Optionen für Op-Skripte
Wenn keine Ablaufverfolgungsoptionen für das Op-Skript konfiguriert sind, besteht die einfachste Möglichkeit, die Ablaufverfolgungsausgabe eines Op-Skripts anzuzeigen, darin, das output Ablaufverfolgungsflag zu konfigurieren und den show log op-script.log | last Befehl auszugeben. Führen Sie dazu die folgenden Schritte aus:
Wenn Sie dies noch nicht getan haben, aktivieren Sie ein op-Skript, indem Sie die
fileAnweisung auf der[edit system scripts op]Hierarchieebene einfügen:[edit system scripts op] user@host# set file filename
Aktivieren Sie Ablaufverfolgungsoptionen, indem Sie die
traceoptions flag outputAnweisung auf der[edit system scripts op]Hierarchieebene einschließen:[edit system scripts op] user@host# set traceoptions flag output
Bestätigen Sie die Konfiguration.
[edit] user@host# commit and-quit
Zeigen Sie die resultierenden Ablaufverfolgungsmeldungen an, die in der Datei /var/log/op-script.log aufgezeichnet sind. Am Ende des Protokolls befindet sich die Ausgabe, die von dem op-Skript generiert wird, das Sie in Schritt 1 aktiviert haben. Um das Ende des Protokolls anzuzeigen, geben Sie den Befehl für den
show log op-script.log | lastBetriebsmodus ein:user@host> show log op-script.log | last
Tabelle 1 fasst nützliche Filterbefehle zusammen, mit denen ausgewählte Teile der op-script.log Datei angezeigt werden.
| Aufgabe |
Befehl |
|---|---|
| Zeigen Sie Protokollierungsdaten an, die mit der gesamten Op-Script-Verarbeitung verbunden sind. |
|
| Zeigen Sie die Verarbeitung nur für den letzten Vorgang an. |
|
| Zeigen Sie die Verarbeitung von Skriptfehlern an. |
|
| Zeigen Sie die Verarbeitung für ein bestimmtes Skript an. |
|
Beispiel: Mindestkonfiguration für die Aktivierung von Trace-Optionen für Op-Skripte
Zeigen Sie die Trace-Ausgabe der op-Skriptdatei source-route.xsl an:
[edit]
system {
scripts {
op {
file source-route.xsl;
traceoptions {
flag output;
}
}
}
}
[edit] user@host# commit [edit] user@host# run show log op-script.log | last
Konfigurieren der Ablaufverfolgung von lokalen Betriebsskripten
Sie können das Verzeichnis (/var/log), in das Ablaufverfolgungsdateien geschrieben werden, nicht ändern. Sie können jedoch andere Ablaufverfolgungsdateieinstellungen für lokale Op-Skripts anpassen, indem Sie die folgenden Anweisungen auf Hierarchieebene [edit system scripts op traceoptions] einfügen:
[edit system scripts op traceoptions] file <filename> <files number> <size size> <world-readable | no-world-readable>; flag all; flag events; flag input; flag offline; flag output; flag rpc; flag xslt; no-remote-trace;
Sie können Ablaufverfolgungsvorgänge nur für lokale Betriebsskripts anpassen. Für Remote-Op-Skripte (Op-Skripte, die mit dem op url Befehl ausgeführt werden) protokolliert Junos OS die Standard-Trace-Ereignisse immer in der Standard-Op-Skript-Protokolldatei.
Diese Anweisungen werden in den folgenden Abschnitten beschrieben:
- Konfigurieren des Dateinamens des Op-Skriptprotokolls
- Konfigurieren der Anzahl und Größe von Op-Skript-Protokolldateien
- Konfigurieren des Zugriffs auf Op-Skript-Protokolldateien
- Konfigurieren der Op-Skript-Ablaufverfolgungsvorgänge
Konfigurieren des Dateinamens des Op-Skriptprotokolls
Standardmäßig lautet der Name der Datei, die die Ablaufverfolgungsausgabe für alle Op-Skripte aufzeichnet, op-script.log. Sie können die Trace-Ausgabe für lokale Op-Skripte in einer anderen Datei aufzeichnen, indem Sie die file Anweisung auf der [edit system scripts op traceoptions] Hierarchieebene einschließen:
[edit system scripts op traceoptions] file filename;
Die file Anweisung wirkt sich nicht auf den Ausgabespeicherort der Ablaufverfolgung für Remotebetriebsskripts aus, die immer den standardmäßigen op-script.log der Protokolldatei verwenden.
Konfigurieren der Anzahl und Größe von Op-Skript-Protokolldateien
Wenn die Ablaufverfolgungsdatei eine Größe von 128 KB erreicht, wird sie standardmäßig umbenannt und in filename.0.gz, dann filenamein .1.gz usw. komprimiert, bis 10 Ablaufverfolgungsdateien vorhanden sind. Dann wird die älteste Trace-Datei (filename.9.gz) überschrieben.
Sie können die Grenzwerte für die Anzahl und Größe von Ablaufverfolgungsdateien konfigurieren, indem Sie die folgenden Anweisungen auf Hierarchieebene [edit system scripts op traceoptions file filename] einschließen:
[edit system scripts op traceoptions file filename] files number size size;
Legen Sie beispielsweise die maximale Dateigröße auf 640 KB und die maximale Anzahl von Dateien auf 20 fest. Wenn die Datei, die die Ausgabe des Ablaufverfolgungsvorgangs (filename) empfängt, 640 KB erreicht, wird sie umbenannt und in filename.0.gz komprimiert, und es wird eine neue Datei mit dem Namen filename erstellt. Bei filename Erreichen von 640 KB filenamewird .0.gz in .1.gz umbenanntfilename und in filename.0.gz komprimiert.filename Dieser Vorgang wird wiederholt, bis 20 Ablaufverfolgungsdateien vorhanden sind. Dann wird die älteste Datei (filename.19.gz) überschrieben.
Die Anzahl der Dateien kann zwischen 2 und 1000 Dateien liegen. Die Dateigröße kann zwischen 10 KB und 1 Gigabyte (GB) liegen.
Wenn Sie entweder eine maximale Dateigröße oder eine maximale Anzahl von Ablaufverfolgungsdateien festlegen, müssen Sie auch den anderen Parameter und einen Dateinamen angeben.
Konfigurieren des Zugriffs auf Op-Skript-Protokolldateien
Standardmäßig ist der Zugriff auf die Op-Skript-Protokolldatei auf den Besitzer beschränkt. Sie können den Zugriff manuell konfigurieren, indem Sie die world-readable oder-Anweisung no-world-readable auf der [edit system scripts op traceoptions file filename] Hierarchieebene einschließen.
[edit system scripts op traceoptions file filename] (world-readable | no-world-readable);
Die no-world-readable Anweisung schränkt den Zugriff auf das Op-Skriptprotokoll auf den Besitzer ein. Die world-readable Anweisung ermöglicht den uneingeschränkten Zugriff auf die Protokolldatei des Op-Skripts.
Konfigurieren der Op-Skript-Ablaufverfolgungsvorgänge
Standardmäßig ist das Traceoptions-Flag events unabhängig von den Konfigurationseinstellungen aktiviert, und es werden nur wichtige Ereignisse protokolliert. Dazu gehören Fehler, Warnungen, Statusmeldungen und Skriptverarbeitungsereignisse. Sie können die Ablaufverfolgungsvorgänge so konfigurieren, dass sie für lokale Betriebsskripts protokolliert werden, indem Sie die folgenden Anweisungen auf Hierarchieebene [edit system scripts op traceoptions] einschließen:
[edit system scripts op traceoptions] flag all; flag events; flag input; flag offline; flag output; flag rpc; flag xslt;
Die flag Anweisung wirkt sich nicht auf die Ablaufverfolgungsausgabe für Remotebetriebsskripts aus, die nur Standardablaufverfolgungsereignisse protokollieren.
In Tabelle 2 wird die Bedeutung der Op-Script-Ablaufverfolgungsflags beschrieben.
| Flagge |
Beschreibung |
Defaulteinstellung |
|---|---|---|
|
|
Verfolgen Sie alle Vorgänge nach. |
Aus |
|
|
Verfolgen Sie wichtige Ereignisse, einschließlich Fehler, Warnungen, Statusmeldungen und Skriptverarbeitungsereignisse. |
Auf |
|
|
Verfolgen Sie die Eingabedaten des Op-Skripts. |
Aus |
|
|
Generieren Sie Daten für die Offline-Entwicklung. |
Aus |
|
|
Verfolgen Sie die Ausgabedaten des Op-Skripts. |
Aus |
|
|
Trace op script RPCs. |
Aus |
|
|
Verfolgen Sie die XSLT-Bibliothek (Extensible Stylesheet Language Transformations). |
Aus |