次の方法で共有

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

  • [アーティクル]

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 イベント ログにレポートされます。診断リスナーの詳細については、このトピックの後半の「診断ログ リスナー」を参照してください。

診断ログのソース

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

ソース名 説明

EventTopicSwitch

UII 内のメッセージング トラフィックを監視する詳細 User Interface Integration (UII) ログ ソースです。

Microsoft.Uii.Common.Logging

UII によって報告されたメッセージの全般 UII のログ ソースです。

Microsoft.Xrm.Tooling.CrmConnectControl

CRM​​ に対するサインイン プロセスのログ ソースです。このソースは、サインイン手順に関する全般または詳細な診断情報を報告します。

Microsoft.Xrm.Tooling.Connector.CrmServiceClient

すべての CRM​​ データ レベルの相互作用のためのログ ソースです。このソースは、CRM​​ とのすべての相互作用、例外とタイミングを報告します。

Microsoft.Xrm.Tooling.WebResourceUtility

CRM​​ インターフェイス リンクを介した Web リソース データの要求に対するログ ファイルです。

Microsoft.Crm.UnifiedServiceDesk

コア Unified Service Desk 機能のログ ソースです。このログ ソースは、Unified Service Desk の中核のアクションとイベントを報告します。

Microsoft.Crm.UnifiedServiceDesk.Dynamics

Unified Service Desk ブート ストラップと読み込みプロセッサのログ ファイルです。このソースは、UII と Unified Service Desk を初期化と開始の一部であるアクションとイベントを報告します。

Microsoft.Crm.UnifiedServiceDesk.CommonUtility.UserProfileManager

UserProfile システムと対話するアクションのログ ファイルで、これはキャッシュ システムの一部です。詳細 : 統合サービス デスクのクライアント キャッシュの構成

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

診断ログのレベル

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

ログ レベル 内容

オフ​​

このソースからのすべてのイベントを無効にします。

エラー

エラー イベントのみを報告します。

警告

エラーと警告イベントを報告します。

情報

エラー、警告、および情報イベントを報告します。

詳細

エラー、警告、情報、および詳細イベントを報告します。

ActivityTracing

エラー、警告、情報、詳細イベント、および活動のトレース (メソッド名) を報告します。

注意

ActivityTracingは、一部のソースでのみ使用可能です。

すべて

システムが発生させたすべてのイベントを報告します。

診断ログ リスナー

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

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

関連項目

概念

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

他のリソース

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

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