エンドポイント診断ツール(CEDT)について

はじめに

このドキュメントでは、システムから診断データを収集し、Cisco TACサポートケースにアップロードするためのCEDTについて説明します。

前提条件

このツールは、MacOSおよびWindowsで使用できます。

次の項目について理解しておく必要があります。

• MacOS:Cisco Endpoint Diagnostics Tool(CEDT).appをダブルクリックして起動します。
• Windows:CEDT.exeをダブルクリックして起動します。
• アクティブなインターネット接続。
• Cisco TACケースIDとトークン（結果を直接アップロードする場合にのみ必要）

システムデータの収集

このツールは、このシステムデータをカテゴリ別に収集します。いかなる種類の個人データもキャプチャされません。

一般的なシステム情報

ネットワーク設定

製品情報

ステップバイステップウォークスルー

ウェルカム画面

CEDTを起動すると、初期画面が表示されます。このツールの機能の概要を示します。

• システムスキャン：システムをスキャンして、検出されたCisco Secure Accessモジュールを探します。
• アプリケーションログ：クライアントソフトウェアとサービスインフラストラクチャによって生成された診断ログファイルデータを収集します。
• システムデータ：システムデータの収集は、セキュアで暗号化されており、セキュアアクセスの診断にのみ関連します。

右側では、システムにインストールされているCisco Secure Accessモジュールが自動的に検出されます。検出された各モジュールのチェックボックスとそのバージョン番号を確認できます。

• ゼロトラストアクセス(ZTNA)
• セキュアWebゲートウェイ(SWG)
• リモートアクセスVPN(RAVPN)
• 共通システム情報（常に利用可能）

[アクション（Actions）]

1. 診断する製品を選択または選択解除します。
2. Let's Startをクリックして先に進むか、Helpをクリックして詳細を参照してください。

ステップ1：診断データの収集

この画面では、含める診断テストとデータ収集モジュールを選択できます。

ネットワーク診断

実行する接続テストを選択してください：

• DNSルックアップ：指定されたホストに対してDNS解決テストを実行します。ターゲットルックアップ用のカスタムリゾルバIPをサポートします。すべての結果は、構造化されたセクション区切り記号を使用して1つの出力ファイル(dns/dns_lookups.txt)に統合されます。
• パケットキャプチャ：指定した期間のネットワークパケットをキャプチャします（管理者権限が必要）。
• Ping Hosts：指定したホストにpingを実行して、接続を確認します。
• ポリシーテスト出力：シスコのポリシーテストエンドポイント(policy.test.sse.cisco.com)を使用して、指定されたURLに対するポリシーの適用をテストします。 複数のコンマ区切りホストをサポート（最大10）。 結果には、ポリシーテストナビゲーション中に自動的に取得されたHARデータが含まれます。
• ネットワーク速度テスト：アップロード/ダウンロード速度および遅延をシスコの速度テストエンドポイント(speed.test.sse.cisco.com)と比較して測定します。 ダウンロード速度（6パラレルストリーム）、アップロード速度（3パラレルストリーム）、ping遅延/ジッタ（10 ICMPサンプル）を収集します。 結果は、JSON形式とテキストサマリー形式の両方で保存されます。
• URL Reachability：指定されたURLがHTTP GET要求を使用して到達可能かどうかをチェックします。デフォルトでは、HTTP（ポート80）とHTTPS（ポート443）の両方をサポートします。URLに非標準ポートを指定できます（https://など）。example.com:8443)を参照してください。 チェックごとに最大20のURL、URLごとに30秒のタイムアウトURLごとに収集されるデータには、URL、到達可能性ステータス、HTTPステータスコード、応答時間（ミリ秒）、コンテンツ長、解決済みIPアドレス、TLSバージョン、およびタイムスタンプが含まれます。結果はreachability/reachability_results.jsonおよびreachability/reachability_summary.txtに保存されます。

データ収集

パフォーマンスおよび接続データを収集するモジュールの選択：

• HAR Capture：ブラウザセッションからHTTPアーカイブ(HAR)データを記録します。現在、Google Chromeのみをサポート（ヘッドレスブラウザの自動化によりChrome DevTools Protocolを使用） このツールは、システム上のChromeインストールを自動的に検出します。現時点では、FirefoxとSafariはサポートされていません。HARの出力はHAR 1.2仕様に準拠しており、完全なネットワークトレース（JSがトリガするXHR/fetchコールを含む）が含まれています。
• DARTバンドル収集：Cisco Secure ClientからDART診断バンドルを収集します。これには、ゼロトラストアクセス(ZTA)ログ（WindowsのC:\ProgramData\Cisco\Cisco Secure Client\ZTA\logs\のflowlog.dbなど）を含むすべてのモジュールログが含まれます。
• Reserved IP：予約済みIP診断チェックを実行します。収集された診断の完全なリストについては、次のセクションを参照してください。

デバッグ

• デバッグフラグの有効化：エンドポイントの問題を診断するために、エンドポイントのアクティビティの詳細なログを収集します。このオプションは、1つ以上のCisco Secure Access製品が検出され、選択されている場合にのみ使用できます。

プラットフォーム固有

• DebugView Capture (Windows) - Windows Secure Endpoint Connectorのデバッグロギングを有効にします。このオプションは、Windowsシステムでのみ使用できます。

[アクション（Actions）]

1. 必要な診断オプションをオンまたはオフにします。
2. Step 2: Add diagnostic detailsをクリックして続行します。
3. BackをクリックしてWelcome画面に戻るか、Cancelをクリックして終了します。

ステップ2：診断の詳細の追加

この画面では、有効な診断テストごとに特定のパラメータを設定できます。手順1で有効にしたテストの設定のみが表示されます。

DNSルックアップ設定

• 検索するホスト： 1つ以上のホスト名（カンマ区切り）を入力します。 例： cisco.com
• リゾルバIP （オプション） – カスタムDNSリゾルバIP （コンマ区切り）を入力します。 例：208.67.222.222、208.67.220.220システムのデフォルトのDNSリゾルバを使用するには、空のままにします。指定すると、各ホストが各リゾルバに対して照会され、異なるDNSサーバ間での比較DNS解決結果が提供されます。

すべてのDNSルックアップ結果は、dns/dns_lookups.txtという1つの出力ファイルに統合されます。このファイルには、各ホスト/リゾルバの組み合わせごとに構造化されたTextFSMセクション区切り文字が含まれています。

パケットキャプチャの設定

• Interfaces：キャプチャするネットワークインターフェイスを選択します（またはAllのままにしておきます）。
  • 「すべて」(All) （自動モード）に設定した場合
    • macOS/Linux：このツールはtcpdump -Dを実行して、使用可能なすべてのインターフェイスを列挙した後、動作中のインターフェイス（切断されたインターフェイスを除く）をフィルタリングします。 アクティブなインターフェイスが見つからない場合は、特別なanyインターフェイスにフォールバックします。キャプチャは、一致するすべてのインターフェイスで並行して実行されます。
    • Windows：選択したキャプチャバックエンドを使用するすべてのNICのキャプチャ（次のセクションのツールを参照）。 インターフェイスが選択されていないdumpcapを使用すると、検出された最初の3つのインターフェイスまでが同時にキャプチャされます。
• パケットカウント – インターフェイスごとにキャプチャするパケットの数。デフォルト：100。最大：10,000。
• Duration(sec)：キャプチャの最大時間（秒単位）。デフォルト：macOS/Linuxでは20秒、Windowsでは5秒。最大：300秒。パケットカウントまたは制限時間のうち、いずれか早い方に達すると、キャプチャは停止します。

プラットフォーム別のパケットキャプチャツール

パケットキャプチャ出力ファイル

各インターフェイスのキャプチャは、命名規則tcpdump/{interface_name}_capture.pcap（en0_capture.pcap、eth0_capture.pcapなど）を使用して個別のファイルとして保存されます。 メタデータマニフェストファイル(tcpdump/packet_capture_manifest.txt)も生成され、使用されるプラットフォーム、パケット数、期間、キャプチャされたインターフェイス、およびキャプチャバックエンドが記録されます。

Ping設定

• Host/s to ping - pingするホストを入力します（カンマ区切り）。 例：wwwcisco.com）に基づいてコールをルーティングします。

URL到達可能性の設定

確認するURL：テストするURL（カンマ区切り）を入力します。 例： https://github.com

• HTTP GET要求を使用して、到達可能性をテストします。
• デフォルトポート：80(HTTP)/443(HTTPS)。 非標準ポート（https://など）のURLにポートを含めます。example.com:8443)を参照してください。
• チェックごとの最大20のURL
• タイムアウト：URLごとに30秒
• URLごとに収集されるデータ：URL、到達可能性ステータス、HTTPステータスコード、応答時間（ミリ秒）、コンテンツ長、解決済みIPアドレス、TLSバージョン、およびタイムスタンプ。
• 結果はreachability/reachability_results.jsonおよびreachability/reachability_summary.txtに保存されます。

ポリシーテストの設定

• ホストURL：ポリシーテスト用のホストを入力します（カンマ区切り、最大10）。 例：wwwcisco.com）に基づいてコールをルーティングします。
• ポリシーテストは、シスコのポリシーテストエンドポイント(policy.test.sse.cisco.com)で実行されます。
• 結果には、構造化ポリシーテストの出力と、テストナビゲーション中に自動的にキャプチャされたHARデータの両方が含まれます。

HARキャプチャ設定

• Target URLs - HARキャプチャのURLを入力します（カンマ区切り）。 例： https://www.cisco.com/ にアクセスしてください。

KDF設定

診断コレクション中に使用されるキー導出関数フラグを構成します。KDFフラグは、Cisco Secure Clientで有効にするデバッグカテゴリを制御します。

• KDFプリセット：キー導出関数プリセットを選択します。
• KDF HEX – 選択したプリセットに基づいて、16進数値が自動的に入力されます。Customを選択した場合は、独自の16進数値を入力します。

予約済みIP設定

• NSLookup URLs：オプションのカスタムnslookupホスト（カンマ区切り）。 最大10個のURL各カスタムホストは、設定されたすべてのリゾルバに対して照会されます。
• トレースURL：オプションのカスタムtraceroute/tracertホスト（カンマ区切り）。 最大10個のURLこのツールは、macOS/Linuxではtraceroute、Windowsではtracertを自動的に使用します。
• リゾルバIP:nslookupクエリ用のカスタムリゾルバIP（カンマ区切り。例：208.67.222）（オプション）
• 222、208.67.220.220)。 最大5つのIP指定した場合、3つの組み込みリゾルバ（システムデフォルトDNS、127.0.0.1、208.67.222.222）に加えてカスタムリゾルバが使用されます。

予約済みIPの詳細

予約済みIP診断は、デフォルトで次のデータを収集します。

デフォルトのtraceroute/tracertターゲット（これらすべてに対して自動的に実行）:

208.67.222.222:OpenDNSプライマリネームサーバへのルート

target	目的
208.67.220.220	OpenDNSセカンダリネームサーバへのルート
146.112.255.50	Cisco SWGインフラストラクチャIPへのルート
swg-url-proxy-https-sse.sigproxy.qq.op endns.com	SWGプロキシホスト名へのルート

• macOS/Linux:tracerouteコマンドを使用する
• Windows:tracertコマンドを使用する

デフォルトのNSLookupクエリ（これらすべてに対して自動的に実行）:

各nslookupターゲットは、リゾルバリスト内の各リゾルバに対して照会されます。デフォルトでは、リゾルバリストには3つの組み込みリゾルバが含まれています。

カスタムリゾルバIP（208.67.222.222など）が設定されている場合、それらはリゾルバリストに追加され、すべてのnslookupターゲットもそれらに対して照会されます。

NSLookupターゲット：

たとえば、デフォルトの3つのリゾルバがある場合、6つのnslookupクエリ（2つのターゲットx 3つのリゾルバ）が生成されます。 1つのカスタムリゾルバIPを追加すると、このクエリは8つになります（2ターゲットx 4リゾルバ）。

ユーザが指定したカスタムNSLookup URLは、それぞれ同じ完全なリゾルバリスト（組み込み+カスタムリゾルバ）に対して照会されます。

すべての結果は、単一のファイルreserved_ip/reserved_ip_diagnostics.txtに統合され、セクション(traceroute、nslookup)ごとにグループ化されます。このファイルには、エントリごとのターゲットとリゾルバを示す、人間が読める形式のヘッダーが含まれます。

パフォーマンス診断

SWGプロキシとDirect Internet Access(DIA)を使用してページのロード時間を比較します。 次の2つのモードがあります。

1. Overall Diagnostic Mode：各URLは現在のプロキシを介して直接テストされ、結果が並べて比較されます。オプションで、詳細な分析用にHARファイルを生成します。

2. One URL Diagnostic Mode：現在のプロキシ経由でテストする特定のURLと直接入力し、結果を並べて比較できます。オプションで、詳細な分析用にHARファイルを生成します。

証明書ストアのインベントリ設定

• 構成された証明書ストアから証明書を列挙します：
• システム
• ログイン
• Root
• その他
• 不足している証明書、期限切れの証明書、信頼できない証明書をすばやく特定

デバッグページ読み込みの設定：

• 設定可能なデバッグURLをロードします。
• キャプチャ：
• 応答ヘッダー
• 応答本文
• タイミング情報
• SSLメタデータ

[アクション（Actions）]

1. 有効な診断ごとに設定を入力または調整します。
2. Start Diagnosticsをクリックして、診断の実行を開始します。
3. Backをクリックしてステップ1に戻るか、Cancelをクリックして終了します

一時停止して続行

高度なトラブルシューティング（ZTNAまたはSWGトレースなど）を含む診断コレクションを実行すると、Cisco Endpoint Diagnostic Toolは実行の途中で一時停止し、続行する前に問題を再現するように求めるメッセージを表示できます。

これにより、詳細なロギングがオンになっている間に問題をトリガーする時間が与えられるため、サポートチームはより有用な診断データを受信します。

• Diagnostics Pausedウィンドウが表示されたら、現在有効なロギング機能を示すメッセージを確認します。
• トラブルシューティングを行っている問題を再現します。例：
  • VPNへの再接続
  • 失敗している内部アプリケーションを開きます
  • エラーの原因となる手順を繰り返します
• 問題の再現が完了したら、Continueをクリックします。

走りを終わらせなさい。その後、このツールはファイルを収集し、通常の設定を復元し、診断アーカイブを作成します。

一時停止している間はアプリケーションを閉じないでください。ロギングは、Continueをクリックして実行を完了するまでアクティブなままです。

(コマンドライン)

端末からツールを実行している場合は、ダイアログボックスの代わりにウィンドウに一時停止メッセージが表示されます。

1. 端末に表示される一時停止メッセージを読みます。
2. 問題を再現します。
3. 端末に戻り、Enterキーを押して続行します。
4. 実行が完了するのを待ちます。

管理者権限プロンプト

Start Diagnosticsをクリックした後、昇格されたアクセスが必要な機能（Packet CaptureやDebug Flagsなど）を有効にした場合は、管理者権限の入力を求められます。

ダイアログボックスが開き、「Administrator Privileges Required」というタイトルで表示されます。

• 管理者権限を付与するにはYesをクリックします。これにより、ネイティブmacOS/Windowsクレデンシャルプロンプトがトリガーされます。
• 制限モードをクリックして、立面図を表示せずに続行します。特権タスク（パケットキャプチャ、デバッグフラグ）はスキップされます。
• macOS: osascriptから標準のmacOSパスワードダイアログを表示できます。システムパスワードを入力し、OKをクリックします。
• Windows：標準のUAC標高プロンプトが表示されます。許可する場合はYesをクリックします。

診断中

起動すると、選択したすべての診断タスクが実行されます。

• 進行状況バーに全体の完了が表示されます（59% - Executing task 3/9: DNS Lookupなど）。
• 上部に「Diagnostics in progress...」バナーが表示されます。
• 実行中は、すべての設定フィールドが無効またはグレー表示になります。
• フッターにDiagnostics in progressボタン（無効）が表示され、ツールがビジーであることが示されます。

Diagnosticsが完了するまで待ちます。アプリケーションを閉じないでください。

診断の完了 – TACへのアップロード

すべての診断が終了すると、完了ダイアログが表示されます。

Diagnosticsが完了。TACケースにファイルをアップロードします。

ダイアログに次の情報が表示されます。

• Archive：生成された診断アーカイブのファイル名（cisco_diagnostics.tar.gzなど）。
• ファイルサイズ – アーカイブのサイズ（7.72 MBなど）。
• SHA256：整合性を検証するためのアーカイブファイルのチェックサム。

TACケースにアップロードするには、次の手順を実行します。

1. ケースID（698746730など）を入力します。
2. トークンを入力します（シスコサポートから提供）。
3. Open TAC Caseをクリックして、アップロードを開始します。

アップロードのステータスは、経過表示バーに表示されます(「Uploading... 85.0% (6.56 MB / 7.72 MB)」など)。

アップロードをスキップするには、次の手順を実行します。

• Skipをクリックして、アップロードせずにダイアログを閉じます。アーカイブファイルはローカルに保存されたままです。

アップロード完了 – 最終画面

アップロードが成功すると、完了バナーが次のように更新されます。

診断アーカイブがケース[ケースID]に正常にアップロードされました

経過表示バーに100%とクリーンアップ完了ステータスが表示されます。

[アクション（Actions）]

• Run Againをクリックして、新しい診断実行を開始します。
• Closeをクリックして、アプリケーションを終了します。

出力場所

診断出力の保存先：

• macOS:～/Desktop/cisco_diagnostics/
• Windows: %USERPROFILE%\Desktop\cisco_diagnostics\

出力アーカイブファイル(cisco_diagnostics.tar.gz)には、収集されたすべての診断データが構造化された形式で含まれています。

トラブルシューティング

FAQ

Q：このツールでは、どのようなデータが収集されますか。
A：このツールは、Cisco Secure Accessモジュールのみに関連するシステム情報（OS、ハードウェア、ネットワーク構成）、アプリケーションログ、シスコ製品の構成とインストール済みモジュールデータ、およびネットワーク診断データを収集します。詳細な内訳については、前のセクションの「収集されるシステムデータ」を参照してください。個人データは取得されません。

Q：管理者またはrootのアクセス権は必要ですか。
A：管理者アクセスはオプションですが、推奨されます。このコマンドを使用しないと、一部の診断（パケットキャプチャ、デバッグフラグ）がスキップされます。このツールでは、プロンプトが表示され、選択できます。

Q：ツールを複数回実行できますか。
A：はい。実行が完了するたびに、[再実行]をクリックして新しい診断セッションを開始できます。

Q：出力はどこに保存されますか。
A：診断アーカイブは、デスクトップのcisco_diagnosticsフォルダに保存されます。

Q:TAC Case IDがない場合はどうすればよいですか。
A：アップロードダイアログでSkipをクリックします。アーカイブファイルはローカルに保存されたままです。後でTACケースに手動でアップロードしたり、サポートエンジニアと共有したりできます。

Q：データは暗号化されていますか。
A：診断アーカイブは圧縮(tar.gz)され、機密データはパッケージ化の前に自動的に修正されます。

Q: HARキャプチャはどのブラウザをサポートしていますか。
A：現在、HARキャプチャはGoogle Chromeのみをサポートしています。このツールは、ヘッドレスブラウザの自動化にChrome DevTools Protocolを使用します。HARキャプチャを実行する前に、Chromeがインストールされていることを確認します。

Qポーズ画面が表示されません。何か問題でも？

A：必ずしもそうとは限りません。一時停止ステップは、シナリオに対して詳細ロギングが正常に有効化された場合にのみ表示されます。アプリの実行ログを確認します。有効化の手順をスキップすると、ツールは一時停止せずに続行されます。

Q Runがスタックしているようです。どうすればよいのですか。

A: Diagnostics Pausedウィンドウを探します。このウィンドウは他のウィンドウの背後に表示されている可能性があります。Continueをクリックするか、コマンドラインでEnterキーを押すまで、配管は前方に移動しません。

A：はい。このメッセージには、ツールでプラットフォームに対して有効になっているロギング機能と、選択した診断オプションが表示されます。

A：診断コレクションを再実行し、完了させてください。ログがオンのままになっているかどうかわからない場合は、サポートエンジニアに連絡して指示を受けてください。

更新履歴

改定	発行日	コメント
2.0	06-Jul-2026	代替テキストの書式設定を追加。
1.0	03-Jul-2026	初版