NETCONF および Junos XML プロトコル トレーシングの運用の概要
NETCONF および Junos XML 管理プロトコルのトレース操作を設定できます。NETCONF および Junos XML プロトコル トレース操作は、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]
省略されていました。
NETCONF および Junos XML プロトコルトレーシング操作は、 階層レベルで設定します [edit system services netconf traceoptions]
。
[edit system services] netconf { traceoptions { file <filename> <files number> <match regular-expression> <size size> <world-readable | no-world-readable>; flag flag; no-remote-trace; on-demand; } }
NETCONF と Junos XML プロトコルのトレース操作を有効にし、そのデバイス上の NETCONF および Junos XML プロトコル セッションから送受信されるすべてのデータをトレースするには、 ステートメントを flag all
設定します。Junos OSリリース16.1では、 ステートメントの下に flag
新しいオプション、 が debug
導入されました。このオプションは、デバッグレベルのトレースを有効にします。ただし、 オプションの使用をお flag all
勧めします。フラグ値 incoming
をそれぞれ または outgoing
のいずれかに設定することで、NETCONF または Junos XML プロトコルの送受信データのみにトレースを制限できます。さらに、トレース出力に特定の式に一致する行のみを含むように制限するには、 ステートメントを file match
設定し、出力が一致する正規表現を定義します。
NETCONF および Junos XML プロトコル トレース操作は、 /var/log/netconf ファイルにセッション データを記録します。別のトレース ファイルを指定するには、 ステートメントと目的のファイル名を file
設定します。
デフォルトでは、トレース ファイルのサイズが 128 KB に達すると、トレース ファイルが 10 個になるまで、トレース ファイルの名前が .0.gz、次filenameに .1.gz に圧縮されますfilename。そして、最も古いトレース ファイル(filename.9.gz)が上書きされます。および file size size
ステートメントを含めることで、トレース ファイルの数とサイズに制限をfile files number
設定できます。最大1000個のファイルを設定できます。ファイル サイズをバイト単位で指定するか、KB を指定するか、 sizem
MB を指定するか、GB sizeg
を指定するために使用sizek
します。トレース ファイルの最大数と最大トレース ファイル サイズを個別に設定することはできません。1 つのオプションが設定されている場合、もう一方のオプションもファイル名とともに設定する必要があります。
NETCONF または Junos XML プロトコル セッション内からトレース操作を制御するには、 ステートメントを on-demand
設定します。そのため、セッション内からトレース操作を開始および停止する必要があります。ステートメントを設定した on-demand
場合、そのセッションのトレース操作を <rpc><request-netconf-trace><start/></request-netconf-trace></rpc>
開始するには、セッションでRPCを発行する必要があります。そのセッションのトレースを停止するには、RPC を発行します <rpc><request-netconf-trace><stop/></request-netconf-trace></rpc>
。
デフォルトでは、トレース ファイルへのアクセスは所有者に制限されています。または no-world-readable
ステートメントのいずれかを含めることで、アクセスを手動でworld-readable
設定できます。ステートメントはno-world-readable
、所有者へのトレース ファイルのアクセスを制限します。これはデフォルトです。ステートメントはworld-readable
、トレース ファイルへの無制限のアクセスを有効にします。
[edit system services netconf traceoptions]
トレース操作を有効にすると、Junos OS は NETCONF および Junos XML プロトコル セッションの両方のトレース操作を有効にし、セッションの種類を識別するために、 および
[JUNOScript]
のタグをログ ファイル エントリに追加
[NETCONF]
します。