クライアント診断ログの構成方法

Unified Service Desk クライアント診断ログを構成できる方法は 2 つあります:

• Microsoft Dataverse の Unified Service Desk 領域で作成され管理される監査 診断の設定レコードを使用することで、このレコードを使用することができます。

• UnifiedServiceDesk.exe.config ファイルを手動で変更する方法です。 このファイルはその後、Unified Service Desk クライアント診断ログが必要なすべてのデスクトップに配布する必要があります。

  さらに、Unified Service Desk クライアントで発生する可能性のある例外について、特に診断ログを構成することができます。

Unified Service Desk のクライアント診断ログの構成

このセクションでは、Unified Service Desk を手動で診断ログを構成する方法について説明します。 ここで説明する手順を使用するよりも、診断の一元的な管理とカスタム リスナーを接続するための機能を提供する監査と診断の設定機能を使用することをお勧めします。 詳細: Unified Service Desk で監査と診断を構成する

このトピックでは、クライアント ログの特性を変更する方法について説明します。

ログは、UnifiedServiceDesk.exe.config ファイルを使用することによって有効化でき、このファイルはユーザーのコンピューターの Unified Service Desk クライアントのインストール ディレクトリにあります。 ログの種類および Unified Service Desk ログ ファイルの場所の構成:

1. UnifiedServiceDesk.exe.config ファイルを開いて編集します。 Unified Service Desk クライアントを既定の場所にインストールした場合、このファイルは通常 C:\Program Files\Microsoft Dynamics 365 Customer Engagement USD\USD で利用可能です。

2. ファイル内の <switches> セクションに移動します。

   <switches>  
   <!--   
        Possible values for switches: Off, Error, Warning, Information, Verbose  
           Verbose:      includes Error, Warning, Info, Trace levels  
           Information:  includes Error, Warning, Info levels  
           Warning:      includes Error, Warning levels  
           Error:        includes Error level  
    -->  
       <add name="EventTopicSwitch" value="Error"/>  
       <add name="Microsoft.Uii.Common.Logging" value="Error"/>  
       <add name="Microsoft.Xrm.Tooling.CrmConnectControl" value="Error"/>  
       <add name="Microsoft.Xrm.Tooling.Connector.CrmServiceClient" value="Error"/>  
       <add name="Microsoft.Xrm.Tooling.WebResourceUtility" value="Error"/>  
       <add name="Microsoft.Crm.UnifiedServiceDesk" value="Error"/>  
       <add name="Microsoft.Crm.UnifiedServiceDesk.Dynamics" value="Error"/>  
       <add name="Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager" value="Error"/>  
       <add name="UnifiedServiceDesk.KPIControl" value="Error"/>  
   </switches>  
   
   

3. <switches> セクションで、ログ ソース (EventTopicSwitch など) を指定し、次にログ レベルの値 (Error など) を指定します。 <switches>セクションは、さまざまなソースのログ レベルをコントロールします。 既定では、エラー ログはすべてのスイッチで有効です。

   • 使用可能なログ ソースの詳細は、このトピックの後半の「使用可能なログ ソース」を参照してください。

   • ログ ソースごとに指定できる値の詳細は、このトピックの後半の「ログのレベル」を参照してください。

4. ログファイルの場所、最大ファイル サイズ、およびロールオーバー動作を設定するには、ファイルの [<shareListeners>] セクションに移動します。

   <sharedListeners>  
      <add name="fileListener"  
         type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"  
       BaseFileName="UnifiedServiceDesk"  
       Location="LocalUserApplicationDirectory" MaxFileSize ="52428800" MaxFileCount="10"/>  
      <add name="USDDebugListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.UsdTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" />  
      <add name="ADALListener"  
       type="Microsoft.Xrm.Tooling.Connector.DynamicsFileLogTraceListener, Microsoft.Xrm.Tooling.Connector"  
       BaseFileName="ADAL"  
        Location="LocalUserApplicationDirectory" MaxFileSize ="52428800" MaxFileCount="10"/>  
   </sharedListeners>  
   

   <sharelisteners> セクションは、Unified Service Desk のために生成されるログの場所と種類をコントロールします。 既定では、fileListener は UnifiedServiceDesk.log という名前のファイルを c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> ディレクトリに作成し、USDDebugListener はイベントをデバッガーのホストされたコントロールの デバッグ出力タブ に作成します。

5. UnifiedServiceDesk.log ファイルの場所を変更する場合、Location パラメーターの値を変更します。

6. 既定では、現在のログ ファイルのファイル サイズが 52.42 MB を超えると、新しい Unified Service Desk ログが作成されます。 既定では、最も古いログ ファイルが削除される前に、最大 10 個のログ ファイルが一度に保持されます。

   • Unified Service Desk でのログ ファイルの最大サイズを変更するには、MaxFileSize パラメータの値をバイト単位で変更します。

   • 最も古いログが削除される前に保持されるログの数を変更するには、MaxFileCount パラメーターの値を変更します。 ゼロ (0) を使用すると、ロールオーバー ロギングが無効になり、作成されたすべての Unified Service Desk クライアント ログが保存されます。

7. 既定では、すべてのソースでファイルおよびデバッガーのログが有効です。 診断ソースに対してリスナーを追加または削除する場合、必要なソースを <sources> セクションに配置し、次に目的のリスナーを含めるようにソースの <listeners> セクションを変更します。

   たとえば、Unified Service Desk のイベント ログを追加するには、イベント ログ リスナーを Microsoft.Crm.UnifiedServiceDesk ソースに追加します。

   <source name="Microsoft.Crm.UnifiedServiceDesk" switchName="Microsoft.Crm.UnifiedServiceDesk" switchType="System.Diagnostics.SourceSwitch">  
       <listeners>  
           <add name="fileListener"/>  
           <add name="USDDebugListener" />  
           <add name="eventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="USD"/>  
       </listeners>  
   </source>  
   

   これにより、ファイルとデバッガーに加え、イベントが "USD" のタグ付きで Windows イベント ログにレポートされます。 診断リスナーの詳細については、このトピックの後半の「診断ログ リスナー」を参照してください。

診断ログのソース

一般的なトラブルシューティングのログ ソースは、次の表に記載されています。

これらのログ ソースを個別に切り替え、トラブルシューティング、問題または Unified Service Desk 内の情報の分離をサポートできます。

診断ログのレベル

いくつかの個別のログ レベルが使用可能です。 ただし、ログのレベルを大きくすると、より多くのデータが生成されてログ ファイルに格納されます。

診断ログ リスナー

診断ログ リスナーは、ファイル、イベント ログ、または他のソースに出力する診断ログを対象として使用します。 既定では、すべての診断ソースはデフォルト (デバッガー) とファイル (テキスト) のリスナーを結びます。 Unified Service Desk の診断ログで使用する追加のログ リスナーを構成できます。 .NET の既定のリスナーの詳細については、以下を参照してください。

• MSDN:DefaultTraceListener

• MSDN:EventLogTraceListener

• MSDN:TextWriterTraceListener

  診断ログを選択した任意の場所に送信する、カスタム リスナーを作成することもできます。 カスタム リスナーは、クラスを MSDN:TraceListener 抽象クラスから派生して作成されます。 そのプロセスのチュートリアルは、CodeGuru.com にあります。

診断ログ ファイルの表示

既定では、診断ログが有効になっているのは Unified Service Desk クライアント アプリケーションです。 ログ ファイル UnifiedServiceDesk-<date>.log は、クライアント コンピューターの c:\Users\<UserName>\\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<Version> にあり、クライアント アプリケーションの操作エラーを記録します。 ログ ファイルは、最初にクライアント アプリケーションでエラーが発生したときに作成されます。

ホストされたコントロールでエラーが発生した場合、ログ ファイルに記録された情報で、例外の詳細とともに例外が発生した元となっているホストされたコントロールなどの例外に関する詳細情報を確認できます。 例外が発生した JavaScript コードのすべてが記録されないことに注意してください。 例外の説明とともに欠陥のあるコードのみ記録されます。

記録されるサンプル例外の詳細を示します。

Microsoft.Crm.UnifiedServiceDesk.Dynamics   Error   2   12/27/2016 11:54:15 AM  Origin:AppdomianUnhandledException, IsFatal:True  
Source: DemoControl  
Target: Void throwExceptionMethod()  
Exception: Exception in custom control  
StackTrace:   at DemoControl.USDControl.throwExceptionMethod()  
   at System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)  
   at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx)  
   at System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state)  
   at System.Threading.ThreadHelper.ThreadStart()  

Unified Service Desk 監視プロセス

Unified Service Desk 監視プロセス (usdmp.exe) は、Unified Service Desk の正常性を監視し続け、既定では、5 秒後に応答がなく Unified Service Desk が応答しなくなるブラウザー プロセス インスタンスを終了します。 ブラウザー プロセス インスタンスが応答しなくても、Unified Service Desk が応答する場合、ブラウザー プロセス インスタンスは終了しません。 ProcessTerminationThreshold グローバル オプションのブラウザー プロセス終了時間を変更する方法の詳細については、「Unified Service Desk のオプションを管理する」を参照してください。

エラー診断レポート

コンポーネント、アプリケーション、またはシステム フォルト中に発生する詳細で包括的なロギングとレポート作成により、いつどのような障害が発生したかを特定できます。 エラー診断レポートは、標準の診断ログに加えて、Unified Service Desk クライアントに例外が発生した場合にシステムとアプリケーションの状態情報を記録します。 例外の詳細については、「Unified Service Desk がアプリケーションとシステムのエラーを処理する方法」を参照してください。

例外時に作成されたフォルダとファイル

例外の場合、エラー診断レポートはフォームの year-month-date_time にある DiagnosticLogs_20170322_173643 などの DiagnosticsLogs日時 という名前のローカル コンピュータ上にフォルダを作成します。 DiagnosticsLogs フォルダ内には、以下のフォルダとファイルが作成されます。

エラー診断レポートの構成

1. Unified Service Desk 管理者にサインインします。

2. 監査と診断 の配下にある 高度な設定を選択します。

3. + 新規 を選択し、続いて DiagnosticsConfiguration を選択します。

4. 追跡、終了監視、診断ログ フォルダの場所など、必要な値を選択または入力します。 詳細情報: 分析

5. 保存して閉じる を選択します。

参照

Unified Service Desk で監査と診断を構成する

Unified Service Desk の問題をトラブルシューティングするためのデバッグ サポート

Unified Service Desk の問題をデバッグする