統合サービス デスクで診断ログを構成

Unified Service Desk および基本サポート ライブラリでは、問題のトラブルシュートに使用できる、診断ログの複数のレイヤーが提供されます。診断ログは、 の運用展開も、常に特定の問題トラブルシューティングを行うためにも使用できます。

既定では、エラー ログが有効になっているのは Unified Service Desk クライアント アプリケーションです。ログ ファイル UnifiedServiceDesk.log は、クライアント アプリケーションの操作エラーを記録するために、クライアント コンピューターの次の場所で利用できます。c:\Users\<ユーザー名>\AppData\Roaming\Microsoft\UnifiedServiceDesk\<バージョン>。ログ ファイルは、最初にクライアント アプリケーションでエラーが発生したときに作成されます。

このトピックの内容

診断ログの構成

診断ログのソース

診断ログのレベル

診断ログ リスナー

診断ログの構成

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

1. UnifiedServiceDesk.exe.config ファイルをオープンして編集します。Unified Service Desk クライアントを既定の場所にインストールした場合、このファイルは通常 C:\Program Files\Microsoft Dynamics CRM 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"
   />
   <add name="USDDebugListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.UsdTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" />
   </sharedListeners>
   

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

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

6. 既定では、すべてのソースでファイルおよびデバッガーのログが有効です。診断ソースに対してリスナーを追加または削除する場合、必要なソースを <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 の既定のリスナーの詳細については、以下を参照してください。

• DefaultTraceListener

• EventLogTraceListener

• TextWriterTraceListener

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

関連項目

概念

統合サービス デスクの問題をデバッグする

他のリソース

デバッガーと診断ログを使用した、統合サービス デスクのトラブルシューティング

Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.