Junos OS を実行するデバイスでのコミット スクリプト処理のトレース
コミットスクリプトトレース操作は、コミットスクリプトの操作を追跡し、ログファイルに記録します。ログに記録されたエラーの説明には、問題をより迅速に解決するために役立つ詳細情報が記載されています。
コミットスクリプトトレースのデフォルトの操作は、デバイス上の /var/log/cscript.log ファイルにエラー、警告、進行状況メッセージ、スクリプト処理イベントを含む重要なイベントをログに記録することです。ファイル cscript.log が 128 キロバイト(KB)に達すると、ファイルの末尾に 0~9 の数字(昇順)で名前が変更され、圧縮されます。たとえば、ログ ファイルは cscript.log.0.gz、次に cscript.log.1.gz として保存され、10 個のトレース ファイルが存在するまで保存されます。そして、最も古いトレース ファイル(cscript.log.9.gz)が上書きされます。
このセクションでは、以下のトピックについて説明します。
コミット スクリプト操作のトレースの最小設定
コミットスクリプトトレースオプションが設定されていない場合、コミットスクリプトのトレース出力を表示する最も簡単な方法は、traceフラグを output
設定し、 コマンドを show log cscript.log | last
発行することです。これを行うには、次の手順を実行します。
まだ行っていない場合は、 階層レベルで ステートメントを
file
含めてコミットスクリプトを[edit system scripts commit]
有効にします。[edit system scripts commit] user@host# set file filename
階層レベルで ステートメントを含めることで、
traceoptions flag output
トレース オプションを[edit system scripts commit]
有効にします。[edit system scripts commit] user@host# set traceoptions flag output
設定をコミットします。
[edit] user@host# commit
/var/log/cscript.log ファイルに記録された結果のトレース メッセージを表示します。ログの最後には、ステップ 1 で有効にしたコミット スクリプトによって生成される出力が表示されます。ログの終了を表示するには、 動作モード コマンドを
show log cscript.log | last
発行します。[edit] user@host# run show log cscript.log | last
表 1 は、ファイルの選択された部分を表示する有用なフィルタリング・コマンドを cscript.log
要約したものです。
タスク |
コマンド |
---|---|
すべてのスクリプト処理に関連するロギング データを表示します。 |
|
最新のコミット操作のみのスクリプト処理を表示します。 |
|
スクリプト・エラーの処理を表示します。 |
|
特定のスクリプトのスクリプト処理を表示します。 |
|
例:コミット スクリプトの Traceoptions を有効にする最小構成
コミット スクリプト ファイル source-route.xsl のトレース出力を表示します。
[edit] system { scripts { commit { file source-route.xsl; traceoptions { flag output; } } } }
[edit] user@host# commit [edit] user@host# run show log cscript.log | last Jun 20 10:21:24 summary: changes 0, transients 0 (allowed), syslog 0 Jun 20 10:24:15 commit script processing begins Jun 20 10:24:15 reading commit script configuration Jun 20 10:24:15 testing commit script configuration Jun 20 10:24:15 opening commit script '/var/db/scripts/commit/source-route.xsl' Jun 20 10:24:15 script file '/var/db/scripts/commit/source-route.xsl': size=699; md5 = d947972b429d17ce97fe987d94add6fd Jun 20 10:24:15 reading commit script 'source-route.xsl' Jun 20 10:24:15 running commit script 'source-route.xsl' Jun 20 10:24:15 processing commit script 'source-route.xsl' Jun 20 10:24:15 results of 'source-route.xsl' Jun 20 10:24:15 begin dump <commit-script-output xmlns:junos="http://xml.juniper.net/junos/*/junos" xmlns:xnm="http://xml.juniper.net/xnm/1.1/xnm" xmlns:jcs="http://xml.juniper.net/junos/commit-scripts/1.0"> <xnm:warning> <edit-path>[edit chassis]</edit-path> <message>IP source-route processing is not enabled.</message> </xnm:warning> </commit-script-output>Jun 20 10:24:15 end dump Jun 20 10:24:15 no errors from source-route.xsl Jun 20 10:24:15 saving commit script changes Jun 20 10:24:15 summary: changes 0, transients 0 (allowed), syslog 0
コミット スクリプトのトレースの設定
トレースファイルが書き込まれるディレクトリ(/var/log)を変更することはできません。ただし、 階層レベルで以下のステートメントを含めることで、他のトレース ファイル設定を [edit system scripts commit traceoptions]
カスタマイズできます。
[edit system scripts commit 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;
これらのステートメントについては、以下のセクションで説明します。
コミット スクリプト ログ ファイル名の設定
デフォルトでは、トレース出力を記録するファイル名は cscript.log です。階層レベルで ステートメントを含めることで、別の file
名前を [edit system scripts commit traceoptions]
指定できます。
[edit system scripts commit traceoptions] file filename;
コミット スクリプト ログ ファイルの数とサイズの設定
デフォルトでは、トレース ファイルのサイズが 128 KB に達すると、トレース ファイルが 10 個になるまで、トレース ファイルの名前が .0.gz、次filenameに .1.gz に圧縮されますfilename。そして、最も古いトレース ファイル(filename.9.gz)が上書きされます。
トレース・ファイルの数とサイズに制限を設定するには、 階層レベルで以下のステートメントを [edit system scripts commit traceoptions file <filename>]
含めます。
[edit system scripts commit traceoptions file <filename>] files number size size;
例えば、最大ファイル・サイズを 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(ギガバイト)までの範囲です。
最大ファイル サイズまたはトレース ファイルの最大数のいずれかを設定する場合は、他のパラメーターとファイル名も指定する必要があります。
コミット スクリプト ログ ファイルへのアクセスの設定
デフォルトでは、コミットスクリプトログファイルへのアクセスは所有者に制限されています。階層レベルで または no-world-readable
ステートメントを含めることで、アクセスをworld-readable
[edit system scripts commit traceoptions file <filename>]
手動で設定できます。
[edit system scripts commit traceoptions file <filename>] (world-readable | no-world-readable);
ステートメントは no-world-readable
、コミットスクリプトのログへのアクセスを所有者に制限します。ステートメントは world-readable
、コミットスクリプトログファイルへの無制限のアクセスを有効にします。
コミット スクリプトトレース操作の設定
デフォルトでは、構成設定に関係なく traceoptions events
フラグがオンになり、重要なイベントのみが記録されます。これには、エラー、警告、進行状況メッセージ、スクリプト処理イベントが含まれます。トレース操作が記録されるように設定するには、 階層レベルで以下のステートメントを [edit system scripts commit traceoptions]
含めます。
[edit system scripts commit traceoptions] flag all; flag events; flag input; flag offline; flag output; flag rpc; flag xslt;
表 2 は、コミット スクリプト トレーシング フラグの意味を示しています。
フラグ |
説明 |
デフォルト設定 |
---|---|---|
|
すべてのコミット スクリプト操作をトレースします。 |
オフ |
|
エラー、警告、進行状況メッセージ、スクリプト処理イベントなど、重要なコミット スクリプト イベントをトレースします。 |
に |
|
コミット スクリプト入力データをトレースします。 |
オフ |
|
オフライン開発のためのデータを生成します。 |
オフ |
|
コミット スクリプト出力データをトレースします。 |
オフ |
|
- コミット スクリプト RPC をトレースします。 |
オフ |
|
XSLT(Extensible Stylesheet Language Transformations)ライブラリをトレースします。 |
オフ |