Junos OS を実行するデバイスでの Op スクリプト処理のトレース

Op スクリプトトレース操作は、op スクリプトの操作を追跡し、ログファイルに記録します。ログに記録されたエラーの説明には、問題をより迅速に解決するために役立つ詳細情報が記載されています。

opスクリプトトレーシングのデフォルトの操作は、デバイス上の /var/log/op-script.log ファイルにエラー、警告、進行状況メッセージ、スクリプト処理イベントを含む重要なイベントをログに記録することです。ファイル op-script.log が 128 キロバイト(KB)に達すると、ファイルの末尾に 0~9 の数字(昇順)で名前が変更され、圧縮されます。その結果、 op-script.log.0.gz、 op-script.log.1.gz というファイルがあり、トレースファイルが 10 個あるまでです。そして、最も古いトレースファイル(op-script.log.9.gz)が上書きされます。

このセクションでは、以下のトピックについて説明します。

運用スクリプトの Traceoptions を有効にするための最小構成

op スクリプトのトレース・オプションが構成されていない場合、op スクリプトのトレース出力を表示する最も簡単な方法は、trace フラグを output 構成し、コマンドを show log op-script.log | last 発行することです。これを行うには、次の手順を実行します。

まだ行っていない場合は、階層レベルでステートメントを含 file めて op スクリプトを [edit system scripts op] 有効にします。
階層レベルでステートメントを含めることで、 traceoptions flag output トレースオプションを [edit system scripts op] 有効にします。
設定をコミットします。
/var/log/op-script.log ファイルに記録された結果のトレースメッセージを表示します。ログの最後には、ステップ 1 で有効にした op スクリプトによって生成される出力があります。ログの終了を表示するには、動作モードコマンドをshow log op-script.log | last発行します。

表 1 は、ファイルの選択された部分を表示する有用なフィルタリング・コマンドを op-script.log 要約したものです。

表 1:Op スクリプトトレーシング動作モードコマンド
タスク	コマンド
すべての op スクリプト処理に関連するロギングデータを表示します。	`show log op-script.log`
最新の操作のみの処理を表示します。	`show log op-script.log \| last`
スクリプト・エラーの処理を表示します。	`show log op-script.log \| match error`
特定のスクリプトの処理を表示します。	`show log op-script.log \| match filename`

例:Op スクリプトの Traceoptions を有効にする最小構成

op スクリプトファイル source-route.xsl のトレース出力を表示します。

ローカル運用スクリプトのトレースの設定

トレースファイルが書き込まれるディレクトリ(/var/log)を変更することはできません。ただし、階層レベルで以下のステートメントを含めることで、ローカル op スクリプトのその他のトレースファイル設定を [edit system scripts op traceoptions] カスタマイズできます。

メモ：

ローカル op スクリプトのトレース操作のみをカスタマイズできます。リモート op スクリプト(コマンドを使用して op url 実行される op スクリプト)の場合、Junos OS は常にデフォルトのトレースイベントをデフォルトの op スクリプトログファイルに記録します。

これらのステートメントについては、以下のセクションで説明します。

Opスクリプトログファイル名の設定
Opスクリプトログファイルの数とサイズの設定
Opスクリプトログファイルへのアクセスの設定
Op スクリプトトレース操作の設定

Opスクリプトログファイル名の設定

デフォルトでは、すべての op スクリプトのトレース出力を記録するファイル名は op-script.log です。以下の階層レベルにステートメントを含めることで、異なるファイルにローカル op スクリプトの file トレース出力を [edit system scripts op traceoptions] 記録することができます。

メモ：

ステートメントは file 、デフォルトのログファイル op-script.logを常に使用するリモートopスクリプトのトレース出力場所には影響しません。

Opスクリプトログファイルの数とサイズの設定

デフォルトでは、トレースファイルのサイズが 128 KB に達すると、トレースファイルが 10 個になるまで、トレースファイルの名前が .0.gz、次filenameに .1.gz に圧縮されますfilename。そして、最も古いトレースファイル(filename.9.gz)が上書きされます。

トレース・ファイルの数とサイズに制限を設定するには、階層レベルで以下のステートメントを [edit system scripts op traceoptions file <filename>] 含めます。

例えば、最大ファイル・サイズを 640 KB に、最大ファイル数を 20 に設定します。トレース操作 (filename) の出力を受信するファイルが 640 KB に達すると、そのファイルの名前が変更され、圧縮が .0.gz にfilename圧縮され、というfilename新しいファイルが作成されます。640 KB に達するとfilename、filename.0.gz は .1.gz に変更され、filenameその名前filenameは .0.gz に変更され、圧縮は .0.gz にfilename変更されます。このプロセスは、20 個のトレースファイルが存在するまで繰り返されます。そして、最も古いファイル(filename.19.gz)が上書きされます。

ファイルの数は、2~1000ファイルの範囲です。ファイルサイズは、10 KB から 1 GB(ギガバイト)までの範囲です。

メモ：

最大ファイルサイズまたはトレースファイルの最大数のいずれかを設定する場合は、他のパラメーターとファイル名も指定する必要があります。

Opスクリプトログファイルへのアクセスの設定

デフォルトでは、opスクリプトログファイルへのアクセスは所有者に制限されています。階層レベルでまたは no-world-readable ステートメントを含めることで、アクセスをworld-readable[edit system scripts op traceoptions file <filename>]手動で設定できます。

ステートメントは no-world-readable 、opスクリプトのログへのアクセスを所有者に制限します。ステートメントは world-readable 、opスクリプトログファイルへの無制限のアクセスを有効にします。

Op スクリプトトレース操作の設定

デフォルトでは、構成設定に関係なく traceoptions events フラグがオンになり、重要なイベントのみが記録されます。これには、エラー、警告、進行状況メッセージ、スクリプト処理イベントが含まれます。ローカル op スクリプトでログに記録されるトレース操作を設定するには、階層レベルで以下のステートメントを [edit system scripts op traceoptions] 含めます。

メモ：

ステートメントは flag 、デフォルトのトレースイベントのみをログするリモート op スクリプトのトレース出力には影響しません。

表 2 は、op スクリプトトレーシングフラグの意味を示しています。

表 2:Op スクリプトトレーシングフラグ
フラグ	説明	デフォルト設定
`all`	すべての操作をトレースします。	オフ
`events`	エラー、警告、進捗メッセージ、スクリプト処理イベントなどの重要なイベントをトレースします。	に
`input`	op スクリプト入力データをトレースします。	オフ
`offline`	オフライン開発のためのデータを生成します。	オフ
`output`	op スクリプト出力データをトレースします。	オフ
`rpc`	op スクリプト RPC をトレースします。	オフ
`xslt`	XSLT(Extensible Stylesheet Language Transformations)ライブラリをトレースします。	オフ

このページで