Netskope Client デバッグモード

Netskope Clientデバッグモードは、トラブルシューティングに必要なすべての情報を簡単かつ効率的に集約できる方法を提供します。問題が発生した場合は、デバッグモードを有効にして問題を再現してください。問題が発生したら、デバッグモードを停止し、生成されたアーカイブファイルをNetskopeに共有してください。

Netskope Clientデバッグモードが有効になると、以下の処理が実行されます。

複数のファイル回転を伴う内部パケットキャプチャ。
複数のファイル回転を伴う外部パケットキャプチャ。
Netskope Clientサービスのデバッグログは、複数のファイルにローテーションされます。
管理者権限でデバッグモードを開始し、次の情報を収集します。

Windowsではnsdiagコマンドを管理者として実行し、macOSではsudoコマンドを管理者として実行してください。
- Macでは、 sysdiagnoseログを収集します（この処理には数分かかる場合があります）。
- Windowsでは、
  - Netskope Clientサービス（stAgentSvc.exe）のメモリダンプを生成します。そして、現在のテナントユーザーUI（stAgentUI.exe）。
    
    Protect Client configuration and resourcesが有効になっている場合、デバッグモードではメモリダンプは収集されません。
  - Windowsアプリケーションおよびシステムイベントログを収集します。
クライアントUI上のSave Logsオプションを無効にします。
Advanced Debuggingクライアント UI 機能 ( Set Log Level 、 Save Driver Logs 、 Inner Packet Capture 、 Outer Packet Captureなど) を無効にします。
ログレベルの設定、nsdiagNetskope Client UIからの内側および外部パケットキャプチャの開始、ログファイルサイズの増加を無効化します。

デバッグモードコマンド

Windows

nsdiag -b [start | stop | status | cleanup] -l [ dump | debug | info | error | critical] -s <snap length> -m <max debug log files> -i [disable | maxInnerPcapTotalSize in MB] -e [disable | maxOuterPcapTotalSize in MB] -c [disable | CPU sample interval in second] -r [enable | disable driver log] -t [duration of time in minutes] -o <output archive path>

macOS

nsdiag -b [start | stop | status | cleanup] -l [ dump | debug | info | error | critical] -s <snap length> -m <max debug log files> -i [disable | maxInnerPcapTotalSize in MB] -e [disable | maxOuterPcapTotalSize in MB] -c [disable | CPU sample interval in second] -d [enable | disable sysdiagnose log] -t [duration of time in minutes] -o <output archive path>

Linux

nsdiag -b [start | stop | status | cleanup] -l [ dump | debug | info | warning | error | critical] -s <snap length> -m <max debug log files> -i [disable | maxInnerPcapTotalSize in MB] -e [disable | maxOuterPcapTotalSize in MB]-t [duration of time in minutes] -o <output archive path>

パラメータ	デスクリプション
-b [開始 \|停止 \|ステータス \|掃除]	開始/停止/ステータスの取得/デバッグモードのクリーンアップ
-l [ ダンプ \| デバッグ \| 情報 \| エラー \| 重大]	デバッグモードのログレベルを設定します。デフォルト値はdebugです。
-s<snap length>	デバッグモードで、内部および外部パケットのキャプチャスナップ長を設定します。デフォルト値は0です。
-m<max debug log files>	デバッグモードで、デバッグログファイルの最大数を設定します。デフォルト値は10です。
-i [disable \| maxInnerPcapTotalSize (MB)]	デバッグモードで内部パケットキャプチャの合計サイズを設定します。デフォルト値は600MBです。
-e [disable \| maxOuterPcapTotalSize (MB)]	デバッグモードで外部パケットキャプチャの合計サイズを設定します。デフォルト値は800MBです。
-c [無効にする \| CPUサンプリング間隔（秒）]	WindowsとMacのみ対応。 – （間隔）秒ごとにすべてのプロセスのCPU使用率のスナップショットを取得します。結果はNetskope Clientログフォルダーの新しい nsDMCpuUsage.log に記録されます。
-r [ドライバログを有効にする \| 無効にする]	Windowsのみ対応。デバッグモードでのドライバログの有効化/無効化。
-d [enable \| disable]	– macOSのみ。 – システム診断ログの収集を有効/無効にします。注：システム診断ログの詳細を収集するには数分かかります。
-t [時間（分）]	オプション：デフォルト値は2160分または36時間です。最小値は1分です（。– 最大値は 86,400 分または 60 日です – Netskope Client は、指定された期間が経過すると自動的にデバッグモードを停止し、必要な情報を収集します。
-o<output archive full path>	必須：出力アーカイブファイル（.zip）のフルパスを設定してください。 – Netskope Client自動的に.zipファイルを追加します指定されたファイルに拡張子がない場合は、拡張子を追加します。 -b 開始コマンドで設定されている場合、-b 停止コマンドでは不要です。

デバッグコマンドを停止します

Netskope Clientユーザーがコマンドnsdiag -b stopを実行してデバッグモードを終了するまで、情報の収集を継続します。

デバイスの再起動ではデバッグモードは停止しません。

デバッグコマンドの例

例１

Netskope Clientでは、ユーザーが頻繁に問題に遭遇します。この問題をトラブルシューティングするには、デバッグモードを開始してください。デフォルトのパラメータを使用して、以下の手順で問題を再現してみてください。

nsdiag -b start -o ~/debug/NSClientLogs.zip

問題が発生した場合は、直ちにデバッグモードを停止してください。~/debug フォルダに、NSClientLogs_timestamp.zip という名前のファイル（例: NSClientLogs_2025.04.03_16-16-35-0800.zip）が生成されます。このファイルをNetskopeサポートに共有してください。

nsdiag -b stop

例２

ユーザーは時折、すぐには再現できない問題に遭遇することがあります。問題が発生するまでに数時間、あるいは数日かかる場合もあります。トラブルシューティングを行うには、次のようにデバッグモードを開始できます。

作業を進める前に、十分なディスク容量が確保されていることを確認し、必要に応じてパラメータを調整してください。

nsdiag -b start -s 200 -i 1000 -e 1200 -m 50 -o ~/debug/NSClientLogs.zip

内部pcapファイルの合計サイズを1000Mバイトに設定します。
外側のpcapファイルの合計サイズを1200Mバイトに設定します。
デバッグログファイルを合計50個設定します。

問題が数時間後または数日後に発生した場合は、ユーザーはデバッグモードを速やかに無効にすることができます。

nsdiag -b stop

例３

Netskope Clientで不安定な動作が発生し、プロセスがハングアップしたりクラッシュしたりする場合があります。管理者として、以下のコマンドを実行してください。

nsdiag -b start -o “c:\debug\NSClientLogs.zip“

問題が発生した場合は、直ちにデバッグモードを停止してください。デバッグモードを停止するには、コマンドプロンプトで次のコマンドを実行します。

nsdiag -b stop

例4

トンネルの負荷が原因でパフォーマンスの問題が発生した場合は、コマンドプロンプトで次のコマンドを実行してください。

nsdiag -b start -l info -s 200 -i 1200 -e disable -r disable -c 3 -o "c:\debug\loadtest.zip"

上記のコマンドで、以下のパラメータを設定してください。

ログレベルを「info」に設定してください。
snaplenを200に設定します
内部pcapの合計サイズを1200Mバイトに設定します
外部pcapを無効にする
ドライバーログを無効にする

CPU使用率は3秒ごとに評価できます。検証が完了したら、デバッグモードを無効にしてください。

例5

管理者がmacOSでデバッグモードを開始し、sysdiagnoseログを含むすべての関連情報を収集したい場合は、次の手順を実行してください。

sudo nsdiag -b start -o ~/debug/1.zip

nsdiag -b stop

例6

管理者が sysdiagnose ログを収集せずに macOS デバイスでデバッグモードを開始する場合は、次のいずれかの操作を実行します。

nsdiag -b start -o ~/debug/1.zip

nsdiag -b stop

sudo nsdiag -b start -o ~/debug/1.zip

nsdiag -b stop -d disable

例7

デバッグモードを停止した後、すべてのデバッグモードファイルをクリーンアップするには：

nsdiag.exe -b cleanup

例8

管理者は、デフォルトパラメータを使用して、 60 minutesのみデバッグモードを実行するように指定したいと考えています。

-b start -t 60 -o outputFile(.zip)

60分後、デバッグモードは自動的に停止し、必要な情報をoutputFile_YYYY.MM.DD_HH-MM-SS-UTC.zipという形式の出力ファイルに収集します。

Netskope Client 60分以内に再起動しても、デバッグモードは停止しません。

デバッグステータスを確認する

デバッグモードの状態を確認するには、次の2つの方法のいずれかを使用できます。

コマンドラインを使います: nsdiag -b status
Netskope Client UI を使う:
1. デバッグモードが有効になっている場合、 Save Logs … メニューはグレー表示されます。
2. Advanced Debuggingをクリックしてください。
  
  「ログレベルの設定」、「ドライバログの保存」、「内部パケットキャプチャ」、「外部パケットキャプチャ」のオプションもグレー表示され、現在のステータス（開始または停止）が表示されます。