例:NETCONF および Junos XML プロトコル セッションの動作をトレースします。
この例では、NETCONF および Junos XML プロトコル セッションのトレース操作を構成する方法を示します。
Junos OS リリース 16.1 以降、階層で[edit system services netconf traceoptions]トレース操作を有効にすると、Junos OS は NETCONF および Junos XML プロトコル セッションの両方のトレース操作を有効にし、セッションの種類を識別するために、 および [JUNOScript] のタグをログ ファイル エントリに追加[NETCONF]します。Junos OS リリース 16.1 以前は、NETCONF セッション データのみが記録され、タグは[NETCONF]省略されていました。
要件
Junos OSリリース16.1以降を実行するルーティング、スイッチング、またはセキュリティデバイスが必要です。
概要
この例では、NETCONF および Junos XML プロトコル セッションの基本的なトレース操作を設定します。この例では、 netconf-ops.log トレース ファイルを構成し、20 個のトレース ファイルの最大数と、ファイルごとに最大サイズ 3 MB を設定します。ステートメントは flag all 、NETCONFまたはJunos XMLプロトコルデータのすべてについて、トレースを設定します。オプションにより、 world-readable トレース ファイルへの無制限のアクセスが可能になります。
構成
CLI クイックコンフィギュレーション
この例を迅速に設定するには、以下のコマンドをコピーしてテキスト ファイルに貼り付け、改行を削除し、ネットワーク設定に合わせて必要な詳細を変更し、コマンドを 階層レベルの CLI [edit] にコピー アンド ペーストします。
set system services netconf ssh set system services netconf traceoptions file netconf-ops.log set system services netconf traceoptions file size 3m set system services netconf traceoptions file files 20 set system services netconf traceoptions file world-readable set system services netconf traceoptions flag all
NETCONF および Junos XML プロトコル トレーシング操作の設定
手順
NETCONF および Junos XML プロトコル トレーシング操作を設定するには::
NETCONFセッションでは、SSH上でNETCONFを有効にします。
[edit] user@R1# set system services netconf ssh
traceoptions フラグを構成して、キャプチャーするセッション・データを指定します。
受信データ、送信データ、またはすべてのデータを指定できます。この例では、すべてのセッションデータのトレースを設定します。
[edit] user@R1# set system services netconf traceoptions flag all
(オプション)トレース ファイルのファイル名を設定します。
以下のステートメントは、/var/log ディレクトリに格納されているトレース ファイル netconf-ops.log を設定します。ファイル名を指定しない場合、NETCONFおよびJunos XMLプロトコルセッションデータは/var/log/netconfに保存されます。
[edit] user@R1# set system services netconf traceoptions file netconf-ops.log
(オプション)トレース ファイルの最大数と各ファイルの最大サイズを設定します。
以下のステートメントは、最大 20 個のトレース ファイルを設定し、最大サイズは 1 ファイルあたり 3 MB です。
[edit] user@R1# set system services netconf traceoptions file files 20 user@R1# set system services netconf traceoptions file size 3m
(オプション)トレース出力に、特定の正規表現に一致する行のみを含むように制限します。
この例では使用されていない以下の設定は、「エラーメッセージ」を含むセッションデータのみを照合し、ログに記録します。
[edit] user@R1# set system services netconf traceoptions file match error-message
(オプション)オンデマンドトレーシングを設定して、NETCONFまたはJunos XMLプロトコルセッションからのトレース操作を制御します。
この例では使用されていない以下の設定では、オンデマンドトレーシングを有効にします。
[edit] user@R1# set system services netconf traceoptions on-demand
(オプション)トレース ファイルが または かを指定して、トレース ファイル
world-readableの権限を設定しますno-world-readable。この例では、トレース ファイルへの無制限のアクセスを有効にします。
[edit] user@R1# set system services netconf traceoptions file world-readable
設定をコミットします。
[edit] user@R1# commit
結果
[edit]
system {
services {
netconf {
ssh;
traceoptions {
file netconf-ops.log size 3m files 20 world-readable;
flag all;
}
}
}
}
検証
NETCONF および Junos XML プロトコルのトレース操作の検証
目的
デバイスが NETCONF および Junos XML プロトコル セッション データを構成済みのトレース ファイルに書き込んでいます。この例では、送受信される NETCONF と Junos XML の両方のプロトコル データをログに記録します。ここでは詳しく説明されていないサンプル NETCONF セッションで、ユーザーは R1 の候補設定を bgp-troubleshoot.slax op スクリプトを含むように変更し、設定をコミットします。
アクション
運用モード コマンドを発行して、構成したトレース ファイル /var/log/netconf-ops.log のトレース出力を show log 表示します。
user@R1 show log netconf-ops.log Apr 3 13:09:04 [NETCONF] Started tracing session: 3694 Apr 3 13:09:29 [NETCONF] - [3694] Incoming: <rpc> Apr 3 13:09:29 [NETCONF] - [3694] Outgoing: <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/16.1R1/junos"> Apr 3 13:09:39 [NETCONF] - [3694] Incoming: <edit-config> Apr 3 13:09:43 [NETCONF] - [3694] Incoming: <target> Apr 3 13:09:47 [NETCONF] - [3694] Incoming: <candidate/> Apr 3 13:09:53 [NETCONF] - [3694] Incoming: </target> Apr 3 13:10:07 [NETCONF] - [3694] Incoming: <default-operation>merge</default-operation> Apr 3 13:10:10 [NETCONF] - [3694] Incoming: <config> Apr 3 13:10:13 [NETCONF] - [3694] Incoming: <configuration> Apr 3 13:10:16 [NETCONF] - [3694] Incoming: <system> Apr 3 13:10:19 [NETCONF] - [3694] Incoming: <scripts> Apr 3 13:10:23 [NETCONF] - [3694] Incoming: <op> Apr 3 13:10:26 [NETCONF] - [3694] Incoming: <file> Apr 3 13:10:44 [NETCONF] - [3694] Incoming: <name>bgp-troubleshoot.slax</name> Apr 3 13:10:46 [NETCONF] - [3694] Incoming: </file> Apr 3 13:10:48 [NETCONF] - [3694] Incoming: </op> Apr 3 13:10:52 [NETCONF] - [3694] Incoming: </scripts> Apr 3 13:10:56 [NETCONF] - [3694] Incoming: </system> Apr 3 13:11:00 [NETCONF] - [3694] Incoming: </configuration> Apr 3 13:11:00 [NETCONF] - [3694] Outgoing: <ok/> Apr 3 13:11:12 [NETCONF] - [3694] Incoming: </config> Apr 3 13:11:18 [NETCONF] - [3694] Incoming: </edit-config> Apr 3 13:11:26 [NETCONF] - [3694] Incoming: </rpc> Apr 3 13:11:26 [NETCONF] - [3694] Outgoing: </rpc-reply> Apr 3 13:11:26 [NETCONF] - [3694] Outgoing: ]]>]]> Apr 3 13:11:31 [NETCONF] - [3694] Incoming: ]]>]]> Apr 3 13:14:20 [NETCONF] - [3694] Incoming: <rpc> Apr 3 13:14:20 [NETCONF] - [3694] Outgoing: <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" xmlns:junos="http://xml.juniper.net/junos/16.1R1/junos"> Apr 3 13:14:26 [NETCONF] - [3694] Incoming: <commit/> Apr 3 13:14:35 [NETCONF] - [3694] Outgoing: <ok/> Apr 3 13:14:35 [NETCONF] - [3694] Incoming: </rpc> Apr 3 13:14:35 [NETCONF] - [3694] Outgoing: </rpc-reply> Apr 3 13:14:35 [NETCONF] - [3694] Outgoing: ]]>]]> Apr 3 13:14:40 [NETCONF] - [3694] Incoming: ]]>]]> Apr 3 13:30:48 [NETCONF] - [3694] Outgoing: <!-- session end at 2016-12-03 13:30:48 PDT -->
意味
この例では、 ステートメントをflag all設定して、トレース ファイルにすべての送受信 NETCONF または Junos XML プロトコル セッション操作が表示されるようにしました。各操作には、日付とタイムスタンプが含まれます。ログファイルには、 または [JUNOScript] タグをそれぞれ含めることで、NETCONF または Junos XML プロトコルのセッションタイプが[NETCONF]示されます。複数の NETCONF および Junos XML プロトコル セッションは、セッション番号で区別されます。この例では、セッション識別子3694を使用したNETCONFセッションは1つだけアクティブです。
[edit system services netconf traceoptions]トレース操作を有効にすると、Junos OS は NETCONF および Junos XML プロトコル セッションの両方のトレース操作を有効にし、セッションの種類を識別するために、 および
[JUNOScript] のタグをログ ファイル エントリに追加
[NETCONF]します。Junos OS リリース 16.1 以前は、NETCONF セッション データのみが記録され、タグは
[NETCONF]省略されていました。