XRM ツール用トレースの構成

[アーティクル]
03/04/2017

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

オペレーションコール、警告、例外、および他の重要なイベントなどの、XRM ツールのすべてのコンポーネントにおいて、プロセスのマイルストーンに関連するレコードデータのトレースを有効にできます。この情報では、Windows クライアントアプリケーションにおける、操作上およびパフォーマンス上の問題のトラブルシュートに使用できます。 XRM ツールのトレースは、System.Tracing の最上部に構築されます。アセンブリまたはコンポーネント、たとえば Microsoft.Xrm.Tooling.Connector のトレースを有効にするには、コードまたはアプリケーション構成ファイル (<AppName>) 内の各コンポーネントに、次の 3 つを定義する必要があります。

トレースのソース
トレースのリスナー
オフ以外のトレースレベル。エラー、警告、情報、詳細は指定できる他の値です。

XRM ツールのコンポーネントのトレースを有効にするための構成を以下に示します。たとえば、次の構成は、Microsoft.Xrm.Tooling.CrmConnectControl コンポーネントのトレースのみを有効にできます。

</configuration>
  <system.diagnostics>
    <trace autoflush="true" />
    <sources>
      <source name="DynamicsCrm.CrmConnectControl"
        switchName="DynamicsCrm.CrmConnectControl"
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" type="System.Diagnostics.DefaultTraceListener" />
          <remove name="Default"/>
          <add name ="fileListener"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <!-- 
            Possible values for switches: Off, Error, Warning, Info, Verbose
                Verbose:    includes Error, Warning, Info, Trace levels
                Info:       includes Error, Warning, Info levels
                Warning:    includes Error, Warning levels
                Error:      includes Error level
        -->
      <add name="DynamicsCrm.CrmConnectControl" value="Verbose"/>
    </switches>
    <sharedListeners>
      <add name="fileListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="XRMLoginControl.log"/>
      <add name="eventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="XRMLogin"/>
    </sharedListeners>
  </system.diagnostics>
</configuration>

XRM ツールのすべてのコンポーネントに対してトレースを有効にしたい場合、それも可能です。以下の構成は、XRM ツールの 3 つすべてのコンポーネントの組み合わせトレースです。

<configuration>
  <system.diagnostics>
    <trace autoflush="true" />
    <sources>
      <source name="Microsoft.Xrm.Tooling.Connector.CrmServiceClient"
              switchName="Microsoft.Xrm.Tooling.Connector.CrmServiceClient"
              switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" type="System.Diagnostics.DefaultTraceListener" />
          <remove name="Default"/>
          <add name ="fileListener"/>
        </listeners>
      </source>

      <source name="Microsoft.Xrm.Tooling.CrmConnectControl"
              switchName="Microsoft.Xrm.Tooling.CrmConnectControl"
              switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" type="System.Diagnostics.DefaultTraceListener" />
          <remove name="Default"/>
          <add name ="fileListener"/>
        </listeners>
      </source>

      <source name="Microsoft.Xrm.Tooling.WebResourceUtility"
        switchName="Microsoft.Xrm.Tooling.WebResourceUtility"
        switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="console" type="System.Diagnostics.DefaultTraceListener" />
          <remove name="Default"/>
          <add name ="fileListener"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <!-- 
            Possible values for switches: Off, Error, Warning, Info, Verbose
                Verbose:    includes Error, Warning, Info, Trace levels
                Info:       includes Error, Warning, Info levels
                Warning:    includes Error, Warning levels
                Error:      includes Error level
        -->
      <add name="Microsoft.Xrm.Tooling.Connector.CrmServiceClient" value="Verbose" />
      <add name="Microsoft.Xrm.Tooling.CrmConnectControl" value="Verbose"/>
      <add name="Microsoft.Xrm.Tooling.WebResourceUtility" value="Verbose" />

    </switches>
    <sharedListeners>
      <add name="fileListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="XRMToolingLogs.log"/>      
      <add name="eventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="XRMTooling" />
    </sharedListeners>

  </system.diagnostics>
</configuration>

XRM ツール用トレースの構成

関連項目

その他のリソース