次のオプションがデフォルト値で既存の monitor subscriber コマンドに追加されました。

UPF Monitor Subscriber CLI

オプションは次のとおりです。

• W - UP PCAP Trace (ON)：このパラメータは、slowpath と fastpath の PCAP トレースを作成するために使用されます。

• U - Mon Display (ON)：非プロトコルイベント（ECS からの統計情報や課金情報など）も slowpath PCAP ファイルにキャプチャされ、UPF モニターコンソールに表示されます。

• V - PCAP Hexdump (ON)：UPF で 16 進ダンプ形式のテキストファイルにプロトコルパケットをキャプチャするには、このフラグを ON に設定する必要があります。

（注）	現在、fastpath および slowpath PCAP ファイルをキャプチャするには、UP PCAP トレースフラグを ON に設定する必要があります。

• F - Packet Capture (Full Pkt)：fastpath からすべてのパケットをキャプチャします。

  オペレータはこのオプションを使用して、完全なパケットキャプチャと部分的なパケットキャプチャを選択できます。F を入力すると、パケットキャプチャタイプを完全なキャプチャまたは部分的なキャプチャに変更できます。部分的なパケットキャプチャでは、1 ～ 16384 バイトのパケットサイズを入力できます。たとえば、20 と入力すると、fastpath パケットの最初の 20 バイトだけがキャプチャされ、残りのパケットはドロップされます。

  （注）	PCAP ファイルを開くと、概要ビューにはパケットのフルレングスが表示されますが、詳細ビューには切り捨てられたパケットのみが表示されます。

• / - Priority (0)：値は「0（ベストエフォート）」～「7（保証）」の範囲です。

  • 0：ベストエフォート

  • 1：低

  • 2：低～中

  • 3：中

  • 4：中～高

  • 5：高

  • 6：クリティカル

  • 7：保証

  注意	デフォルト値を変更しないことを強く推奨します。システム パフォーマンスに悪影響を及ぼす可能性があります。

• N - MEH Header (OFF)：このオプションが設定されている場合、IP パケットから MEH ヘッダーが削除されます。

Monitor Subscriber セッションの表示

進行中の MonSub セッションを表示する新しい CLI を以下に示します。

show monitor subscriber fastpath session all CLI コマンドは、SMF と UPF の両方からトリガーできます。show monitor subscriber fastpath session up-ip-address CLI コマンドは SMF からトリガーできます。

• SessId：UPF Sessmgr の MonSub セッションのローカルセッション ID です。

• CallID：UPF のコール ID。

• PSN：これはパノプティコンのシーケンス番号です。1 つの UPF には、0 ～ 3 の範囲の PSN を持つ最大 4 つの MonSub fastpath トレースセッションがあります。

• Start time：MonSub トレースセッションの開始時刻。

• Interface Type：開始された MonSub fastpath トレースセッションのコールタイプ（Sxa、Sxb、Sxab）を識別します。

Monitor Subscriber セッションの解除

進行中の MonSub セッションを切断する新しい CLI を以下に示します。CP と UP の両方から CLI をトリガーできます。

monitor subscriber fastpath disconnect sessmgr-instance upf_sessmgr_instance_id session-id local_monsub_sessid_sessmgr_level

MonSub セッションの切断に成功すると、次のメッセージがコンソールに表示されます。

Session Disconnected Successfully

MonSub セッションの切断に失敗すると、次のメッセージがコンソールに表示されます。

Monitor Subscriber session does not exist

（注）	モニター切断 CLI を実行できるのは、セキュリティ管理者だけです。

16 進ダンプモジュールは、オペレータがファイル名とポーリングタイマーを設定するためのプロビジョニングを提供するように設定する必要があります。16 進ダンプモジュールは、CDRMOD 機能の一部である EDR、UDR などのモジュールの 1 つです。ECS コンテキストなどの非ローカルコンテキストで 16 進ダンプを設定します。ローカルコンテキストでは 16 進ダンプモジュールはサポートされていません。

16 進ダンプモジュールとその設定の詳細については、「UPF での MonSub の 16 進ダンプモジュールの設定」の項を参照してください。

ここでは、PCAP ファイルの命名規則について説明します。

（注）	PCAP ファイルの命名では、monitor-subscriber-file-name および rotation オプションのみを使用します。

slowpath ファイル名の規則

slowpath ファイル名は次のフォーマットになります。

curr_slowpath_{SMGR Mon Sub Session Id}_{monsub_file_name_option_val}_{Timestamp}_{RotationCount}.pcap

または

slowpath_{SMGR Mon Sub Session Id}_{monsub_file_name_option_val}_{Timestamp}_{RotationCount}.pcap

プレフィックス「curr_」が付いているファイルは、現在書き込み中で、まだ閉じられていないファイルです。ファイルをローテーションする場合（ファイル ローテーション パラメータに応じて）、プレフィックス「curr_」が付いていないファイルがハードディスクにコピーされます。

SMGR MonSub Session Id：これは、この PCAP を作成した Uplane SMGR インスタンス ID で作成された MonSub セッションのセッション ID です。この ID は SMGR インスタンスに対してローカルであるため、同じ ID でキャプチャされた slowpath PCAP が 2 つ存在する可能性があります。

ファイルをハードディスクにコピーする場合、monsub_file_name_option_val は次のように置き換えられます。

• monitor-subscriber-file-name が「imsi」に設定されている場合は IMSI 値

• monitor-subscriber-file-name が「call-id」に設定されている場合はコール ID 値

• monitor-subscriber-file-name が「username」に設定されている場合はユーザー名の値

タイムスタンプのフォーマットは「MMDDYYYYHHMMSS」です。

• MM：月、DD：日、YYYY：年

• HH：時間、MM：分、SS：秒

RotationCount は 9 桁の値で、古いファイルがローテーションされ、新しいファイルが生成されるたびに 1 増加します。

slowpath ファイルのローテーションは、hexdump-module file 設定の次のオプションによって規定されます。

rotation { num-records number | time seconds| volume bytes }

• num-records：[num-records] はパケット数を指定します。パケット数がこの数を超えると、新しいファイルが生成され、ファイル名の [RotationCount] が 1 増加します。[number] の範囲は 100 ～ 10240 で、デフォルト値は 1024 です。

• time：[time] は新しいファイルが生成され、ファイル名の [RotationCount] が 1 増加するまでの待機時間を秒単位で指定します。[seconds] は 30 ～ 86400 までの整数である必要があります。デフォルト値は 3600 です。

• volume：[volume] はバイト数を指定します。バイト数がこの数を超えると、ファイル名の [RotationCount] が 1 増加します。[bytes] は 51200 ～ 62914560 までの整数である必要があります。デフォルト値は 102400 です。

（注）	ローテーション中の tarriff-time パラメータは、PCAP ファイルのキャプチャには適していないため、無視されます。

以下に、slowpath PCAP ファイルのファイル命名規則の例を示します。

• [imsi] オプションが設定されていて、IMSI が「112233445566778」である場合、slowpath ファイルは次のように命名されます。

  slowpath_S0_112233445566778_07152019050907_000000000.pcap

• [call_id] オプションが設定されていて、コール ID が「01317b22」である場合、slowpath ファイルは次のように命名されます。

  slowpath_S0_01317b22_07152019050907_000000000.pcap

（注）	tarrif-time パラメータは、PCAP ファイルキャプチャには適用されません。

fastpath ファイル名の規則

fastpath ファイル名は次のフォーマットになります。

vpp_{S}_{B}_{encap}_{monsub_file_name_option}_{Timestamp}_{FileCount}.pcap

• S は、「S1」、「S2」、「S3」、「S4」のいずれかに置き換えられます。

• B は、Panopticon によって生成されたバンドルに応じて、「B0」、「B1」、「B2」、「B3」のいずれかに置き換えられます。

• monsub_file_name_option は次のように置き換えられます。

  • monitor-subscriber-file-name が「imsi」に設定されている場合は IMSI 値

  • monitor-subscriber-file-name が「call-id」に設定されている場合はコール ID 値

  • monitor-subscriber-file-name が「username」に設定されている場合はユーザー名の値

タイムスタンプのフォーマットは「MMDDYYYYHHMMSS」です。

• MM：月、DD：日、YYYY：年

• HH：時間、MM：分、SS：秒

RotationCount は 9 桁の値で、古いファイルがローテーションされ、新しいファイルが生成されるたびに 1 増加します。

fastpath の [FileCount] は、slowpathの [RotationCount] パラメータと同じではないため、fastpath ファイルの命名時には [hexdump-module file Rotation] パラメータは無視されます。

この機能のフェーズ 1 では、fastpath で生成されたファイル名は「vpp_S1_B0_ip.pcap」または「vpp_S1_B1_ip.pcap」などであり、不揮発性ストレージにコピーされるときに次のように名前が変更されます。

• vpp_S1_B0_ip_01317b22_07152019050907_000000000.pcap

• vpp_S1_B1_ip_01317b22_07152019050908_000000001.pcap

• vpp_S1_B0_ip_01317b22_07152019050908_000000002.pcap

MonSub フェーズ 3 では、PCAP「バンドル」は、イーサネットカプセル化を使用する単一の PCAP ファイルに置き換えられます。

フェーズ 3 では、各 fastpath セッションファイルは「vpp_S0_B0_eth.pcap」というイーサネット PCAP ファイルにキャプチャされ、不揮発性ストレージにコピーされるときに次のように名前が変更されます。

vpp_S0_B0_eth_01317b22_07152019050907_000000000.pcap

[call_id] オプションが設定されていて、コール ID が「12345678ef」である場合：

• slowpath_S0_12345678ef _07152019050907_000000000.pcap

• vpp_S1_B0_eth_12345678ef _07152019050907_000000000.pcap

[username] オプションが設定されていて、ユーザー名が「9890098900」である場合：

• slowpath_S0_07152019050907_000000000_9890098900.pcap

• vpp_S1_B0_eth_07152019050907_000000000_9890098900.pcap

fastpath PCAP ファイルは、セッションマネージャがサブスクライバセッションを所有しているのと同じカードおよび CPU コンプレックス内の /records/pcap ディレクトリに書き込まれます。

/records ディレクトリは「tmpfs」ファイルシステムにマッピングされ、このファイルシステムは RAM にマッピングされます。この状態で、ファイルには「.pending」の拡張子が付けられます。次に例を示します。

（注）	この段階のファイルサイズは、永続ストレージに書き込まれるときの実際のファイルサイズではありません。

fastpath トレースメカニズムによってファイルが書き込まれると、「.pcap」ファイルに変換され、次のように名前が変更されます。「.done」の拡張子で終わるファイルもあります。

-rw-rw-r--    1 root     root       8689188 Oct 16 22:06 vpp_S0_B0_eth.pcap

PCAP ファイルが fastpath トレースメカニズムによって書き込まれた後、Co-Proc 機能によってファイルがインスタンス化され、ハードディスクまたは永続ストレージにコピーされます。

前述の fastpath のファイル格納プロセスは、slowpath にも当てはまります。

すべてのケースでターゲットファイルの場所は /hd_raid/records/hexdump になります。ただし、16 進ダンプモジュールの設定では use-harddisk が有効になっており、hexdump file では directory オプションはカスタム値になります。たとえば、directory オプションの値が「abc」に設定されている場合、PCAP ファイルのターゲットの場所は /hd_raid/records/hexdump/abc/ になります。

この機能を実装すると、事前定義した場所が PCAP ファイルに設定されます。

• use-harddisk および hexdump module の設定を使用して問題が発生した場合に、/records/pcap ディレクトリにデータが入力されないようにするため。

• /hd_raid/records/hexdump ディレクトリを定期的にクリーンアップするため。

外部ロケーションへのファイル転送

ファイルがハードディスクにコピーされたら、hexdump-module コンフィギュレーションの hexdump コマンドで transfer-mode オプションを使用すると、外部サーバーにコピーできます。

transfer-mode 以外にも、hexdump では他の関連オプションを外部へのファイル転送に使用できます。オペレータはこれらのコマンドを使用して、fastpath 処理中のストレージ不足を回避できます。

制限事項は次のとおりです。

• 終了直後にトレースを再開すると、/records/pcap ディレクトリ内の fastpath ファイルが上書きされる可能性があります。短時間（数秒）待ってからセッションを再開することを推奨します。

• MonSub トレースが停止すると、切断プロセスに数秒かかることがあるため、数秒待つことを推奨します。最大 5 秒（秒単位の 16 進ダンプのポーリングタイマー値）待ってから切り替えて、MonSub トレースを開始します。そうしないと、MAX TRACING SESSIONS REACHED が一時的にオペレータに表示されることがあります。

• show monitor subscriber fastpath sessions CLI では、停止中の MonSub セッションは表示されないため、最大セッション数に達したことで、新しい MonSub セッションが一時的に拒否される期間があり、show CLI ではセッション数が少なく表示されます。オペレータは、しばらく待機してから、新しい MonSub トレースセッションを開始することを推奨します。

• fastpath 設定オプションの変更は、UP Pcap トレースが [OFF] に設定されている場合にのみ可能です。

• マルチ PDN で MT=ON になっている場合、MT=OFF になると、MAX TRACING REACHED が原因で新しい PDN トレースは開始されず、他のすべてのトレースが停止します。これは、最初の新しい PDN トレースが開始されてから MT=OFF になり、以前の PDN がすべて停止されたためです。

• 異なる CLI から同じ UE MonSub セッションを起動しないことを推奨します。

• slowpath PCAP では、GTP-U を追加する機能が fastpath にあり、出力 DL パケットに GTPU-U ヘッダーが表示されないため、入力パケットに適用された HTTP X-Header などのパケット変更がない限り、入力および出力 DL パケットは重複して表示されます。

• C オプションと D オプションを切り替えても、PCAP キャプチャには影響しません。

• マルチ PDN の場合、fastpath ファイル名にコール ID は使用されません。これは、定義上、マルチ PDN のケースには複数のコール ID があり、IMSI などの上位レベルの設定がファイルの命名に適しているためです。

• このドキュメントで明示的に言及されている名前付きオプションのみが、hexdump-module ファイルの設定でサポートされます。

• fastpath でトレースできるストリームの数は 5,000 に制限されています。ストリームは、送信元 IP アドレス、宛先 IP アドレス、送信元ポート、および宛先ポート、トランスポートプロトコル（TCP または UDP）で構成される TCP または UDP フローとして定義されます。

• fastpath パケットは外部サーバーにストリーミングできないため、ハードディスクに保存され、手動で、または transfer-mode オプションを使用して転送されます。

• fastpath および slowpath PCAP ファイルをキャプチャするには、UP PCAP トレースを [ON] に設定する必要があります。

• MonSub CLI オプション <SPACE> [Pause] は、コンソールイベントを一時停止するだけです。このオプションは、他のトレースイベント（slowpath PCAP、fastpath PCAP、および 16 進ダンプ形式のテキストファイルのプロトコルパケットトレース）には影響しません。

• UP トレース PCAP ファイルには、競合状態が原因で、最初の PFCP Sx 要求/応答は含まれていません。

• ICMP パケットと TCP および UDP ストリームの最初のパケットは、slowpath と fastpath の両方を通過します。GTPU（オプション 26）およびユーザー L3（オプション 19）のデフォルト値は [OFF] に設定されているため、それらのパケットは slowpath キャプチャでキャプチャされません。オプション 26 が [ON] に設定されている場合、それらのパケットは slowpath PCAP キャプチャでキャプチャされます。前のポイントで説明したように、オプション 19 は slowpath PCAP キャプチャには影響を及ぼしません。

• fastpath および slowpath PCAP ファイルをキャプチャするには、データイベントフラグを [ON] に設定する必要があります。

• Pure-S コールでは最初の PDN トレースのみがサポートされます。この制限は、複数のサブスクライバトレースのサポートで修正されます。

• MoSub トレースは、UP 時の Next-SAEGW Call オプションではサポートされていません。

• MonSub トレースは、Pure-S コールタイプの Next call by APN オプションではサポートされていません。

• デフォルト値の poll-timer を使用した ASR 5500 セットアップでは、既知の問題が原因ですべてのパケットがキャプチャされない可能性があります。多数のパケットが拒否されないようにするには、poll-timer 値を可能な限り低い値（10 ミリ秒）に変更することを推奨します。

• コンテキストの置換が発生した場合（同じサブスクライバが切断されずに再接続した場合）、新しいコールの slowpath キャプチャは古い slowpath ファイルに残り続けます。

この設定を使用して、PCAP ファイルキャプチャチェックの頻度を設定します。

configure 
   context context_name 
      hexdump-module 
         hexdump monitor-subscriber-poll-timeout poll_timer_value  
         end 

注：

• hexdump monitor-subscriber-poll-timeout ：このオプションは、揮発性ストレージ内の新たにキャプチャされた PCAP ファイルを、永続ストレージにコピーする前に実行する必要があるチェックの頻度を指定します。

• poll_timer_value ：ポーリングタイマー値をミリ秒単位で指定します。10 ミリ秒～ 60 秒までの整数で指定する必要があります。デフォルト：30 秒。

  （注）	このタイマーに 5 秒未満の値は設定しないでください。

• このオプションは、fastpath 機能を備えた製品（PGW、ASR-5500 上の SAEGW、および VPC-SI）で MonSub が有効になっている場合にのみ適用されます。

次の設定を使用して、IMSI、コール ID、またはユーザー名を含む PCAP ファイルのファイル名を指定します。

configure 
   context context_name 
      hexdump-module 
         file rotation { num-records number | tariff-time minute minutes hour hours | time seconds| volume bytes | monitor-subscriber-file-name { imsi | username | call-id }  
         end 

注：

• monitor-subscriber-file-name { imsi | username | call-id } ：このオプションは、キャプチャされた PCAP ファイルの名前に IMSI、コール ID、またはユーザー名を含むかどうかを指定します。このオプションは、fastpath 機能を備えた製品（PGW、ASR 5500 上の SAEGW、および VPC-SI）で、かつサブスクライバのモニター機能が有効になっている場合にのみ適用されます。デフォルトは IMSI です。

• rotation { num-records number | tariff-time minute minutes hour hours | time seconds | volume bytes } ：16 進ダンプファイルを閉じて新しいファイルを作成するタイミングを指定します。

  • num-records number ：16 進ダンプファイルに追加する必要があるレコードの最大数を指定します。ファイル内のレコード数がこの値に達すると、ファイルが完成します。

    number は 100 ～ 10240 の整数である必要があります。デフォルト：1024

  • tariff-time minute minutes hour hours ：現在の 16 進ダンプファイルを閉じて、タリフ時間（時分単位）に基づいて新しいファイルを作成します。

    minutes は 0 ～ 59 までの整数である必要があります。

    hours は 0 ～ 23 までの整数である必要があります。

  • time seconds ：現在の 16 進ダンプファイルを閉じて新しいファイルを作成するまでの待機時間（秒単位）を指定します。

    seconds は 30 ～ 86400 の整数である必要があります。デフォルト：3600

    重要	ローテンション時間は 30 秒に設定します。

  • volume bytes ：16 進ダンプファイルを閉じて、新しいファイルを作成するまでのファイルの最大サイズを指定します（バイト単位）。

    bytes は 51200 ～ 62914560 の整数である必要があります。compression キーワードが gzip に設定されている場合、設定が大きいほど圧縮率が向上する場合があることに注意してください。デフォルト：102400

モニターサブスクライバ機能をサポートするために、次の SNMP トラップが追加されました。

• MonSubProcessInitFailure：このトラップは、MonSub ハンドラプロセスが特定のプロセスやサービスで失敗した場合にトリガーされます。