Umbrella: Diagnostic Tool の使い方と注意点 (Windows 版)

[tkitahar]

• 1. はじめに
• 2. Diagnostic Tool の起動方法
• 3. Diagnostic Tool の使い方
• 4. 起動時に .NET Framework 3.5 が求められる場合
• 5. エラーが表示される場合
• 6. Diagnostic Tool で情報採取ができない場合

※ 2022 年 9 月 2 日現在の情報をもとに作成しています

1. はじめに

Umbrella の DNS セキュリティ機能にはトラブルシューティング情報を採取できる Diagnostic Tool が用意されており、Japan TAC (または Umbrella Global Support) にケースを起票した際、Diagnostic Tool の実行結果の提供を求められる場合があります。

本記事では、Windows  版 Diagnostic Tool の使い方と注意点について紹介します。なお、macOS 版についてはこちらの記事を参照してください。

2. Diagnostic Tool の起動方法

Windows 版 Diagnostic Tool の実行ファイルは以下のサポート記事内のリンクからダウンロードできます。

Umbrella Diagnostic Tool

https://support.umbrella.com/hc/en-us/articles/234692027-Umbrella-Diagnostic-Tool

> Microsoft Windows : Download here

ダウンロードした実行ファイルをトラブルが発生しているクライアント PC でダブルクリックすると、Diagnostic Tool が起動します。

ただし、以下のような起動を停止する旨の警告画面が表示された場合、[詳細情報] をクリックし、表示された [実行] をクリックしてください。上記の URL からダウンロードしたものであれば、Cisco が提供しているものであるため、実行しても問題ありません。

なお、Roaming Client および AnyConnect Umbrella Roaming Security Module には、それぞれ付属の Diagnostic Tool が以下のフォルダーに用意されております。さらに、Roaming Client に関しては GUI から Diagnostic Tool を起動することが可能です。

(Roaming Client)
C:\Program Files (x86)\OpenDNS\Umbrella Roaming Client\UmbrellaDiagnostic.exe

(AnyConnect Umbrella Roaming Security Module)
C:\Program Files (x86)\Cisco\Cisco AnyConnect Secure Mobility Client\UmbrellaDiagnostic.exe

(Cisco Secure Client)
C:\Program Files (x86)\Cisco\Cisco Secure Client\UmbrellaDiagnostic.exe

※ AnyConnect 5 以降は Cisco Secure Client という名称になります

ただし、環境によっては、画面表示が乱れるなど正常に動作しない場合があるため、前述のダウンロード版の使用を推奨します。

3. Diagnostic Tool の使い方

Diagnostic Tool を起動すると、以下のような画面が表示されます。

 

「OpenDNS account (optional)」および「Ticket # (optional)」については、Global Umbrella Support (umbrella-support@cisco.com) に問い合わせをした場合において、登録メールアドレスとチケット番号を入れる欄となります。Japan TAC に問い合わせをした場合は不要です。

※ Diagnostic Tool のバージョンにより、上記の 2 種類の欄が表示されない場合があります

また、特定のドメインの名前解決で問題が発生している場合、「Domain to test (optional)」にそのドメイン名を入力します。これにより、診断ログの採取の際に、そのドメインに特化したテストが追加で行われるようになり、トラブルシューティングの助けになる場合があります。

情報の入力が終わったら (すべて未入力も可)、「Run tests」ボタンをクリックします。トラブルシューティングに関連するネットワークコマンドが連続的に実行され、その進捗が逐次「Test Status」の中に表示されます。

全てのコマンドの実行が終わると、画面の下部に ID が表示されます。この ID を現在対応しているサポートエンジニアまでお送りください。

なお、古いバージョンの Diagnostic Tool では、詳細な診断結果を実行者が閲覧することができるものもありましたが、現在のバージョンでは、画面に表示されるものは ID のみとなり、結果を閲覧することはできません。

また、出力結果に URL が表示されるバージョンもありましたが、現在は ID が表示される動作となっているため、もし URL が表示されている場合は、最新バージョンの Diagnostic Tool をダウンロードの上、再度実行してください。

4. 起動時に .NET Framework 3.5 が求められる場合

一部の Windows 環境では、ダウンロード版 Diagnostic Tool を起動した際に、以下の画像のように .NET Framework 3.5 (.NET 2.0 および 3.0 を含む) を求められる場合があります。

.NET Framework 3.5 は Diagnostic Tool を動作させる上での前提条件となりますので、インストールをお願いいたします。

5. エラーが表示される場合

「Run tests」ボタンを押した後、全てのテストが完了したにも関わらず、以下の画像のようなエラー (Error submitting.) が表示される場合があります。

このエラーは ID の発行 (またはそのための通信) に失敗したことを示しています。代わりに自動的にテキスト エディタが開き、そこに実行結果が書き出されますので、その内容をファイルに保存して、サポートエンジニアまでお送りください。

6. Diagnostic Tool で情報採取ができない場合

何らかの理由で Diagnostic Tool による情報採取ができない場合は、以下のサポート記事の Microsoft Windows の項に列記されているコマンドをコマンド プロンプトで実行し、結果をご提供ください。

Umbrella Diagnostic Tool

https://support.umbrella.com/hc/en-us/articles/234692027-Umbrella-Diagnostic-Tool

> If the Diagnostic does not run, provide the results of the following command prompt commands:

また、Roaming Client、AnyConnect Umbrella Roaming Security Module の問題の場合は、以下の詳細ログ ファイルも併せてご提供ください。

(Roaming Client)
C:\ProgramData\OpenDNS\ERC\OpenDNS_ERC_Service.log

(AnyConnect Umbrella Roaming Security Module)
C:\ProgramData\Cisco\Cisco AnyConnect Secure Mobility Client\Umbrella\data\acumbrellaplugin.log

(Cisco Secure Client)
C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\data\acumbrellaplugin.log

※ ファイル名の後ろにドット (.) と数字が付いているものは古いログ ファイルです。併せてご提供ください
※ AnyConnect 5 以降は Cisco Secure Client という名称になります