Microsoft Dynamics CRM 2013 および 2011 でトレースを有効にする方法

  • [アーティクル]

この記事では、Microsoft Dynamics CRMでトレースを有効にする方法について説明します。

適用対象: Microsoft Dynamics CRM 2011、Microsoft Dynamics CRM 2013
元の KB 番号: 907490

重要

このセクション、方法、またはタスクには、レジストリの編集方法が記載されています。 レジストリを誤って変更すると、深刻な問題が発生することがあります。 レジストリを変更する際には十分に注意してください。 保護を強化するため、レジストリを変更する前にレジストリをバックアップします。 こうしておけば、問題が発生した場合にレジストリを復元できます。 レジストリをバックアップおよび復元する方法の詳細については、「Windows でレジストリをバックアップおよび復元する方法」を参照してください。

Microsoft Dynamics CRMでは、Microsoft Dynamics CRMによって実行されるアクションを監視するトレース ファイルを作成できます。 トレース ファイルは、Microsoft Dynamics CRMでエラー メッセージやその他の問題のトラブルシューティングを行う必要がある場合に役立ちます。

アンマネージド トレース ファイルとマネージド トレース ファイルを作成できます。 アンマネージド トレース ファイルとマネージド トレース ファイル内の情報は、手動で作成する必要なレジストリ エントリとオプションのレジストリ エントリによって決まります。 これらのレジストリ エントリは、Microsoft Dynamics CRMまたはMicrosoft Dynamics CRMをインストールした後、Microsoft Dynamics CRM サーバーまたは Microsoft Office Outlook 用のMicrosoft Dynamics CRM クライアントを実行しているコンピューターに作成します。Outlook 用クライアント。

Microsoft Dynamics CRM 2011 および 2013 では、Windows PowerShell アプレットを使用してトレースを有効にすることもできます。 詳細については、「Windows PowerShellを使用してトレース設定を有効にする」セクションを参照してください。

必要なレジストリ エントリ

必要なレジストリ エントリを次に示します。 これらのレジストリ エントリの場所の詳細については、「レジストリ エントリの場所 」セクションを参照してください。

名前 型 データ値 Notes (メモ)
TraceEnabled DWORD 値 0 または 1 値 0 を使用すると、トレースは無効になります。 値 1 を使用すると、トレースが有効になります。
TraceDirectory String C:\CRMTrace TraceDirectory レジストリ エントリは、トレース ログ ファイルのディレクトリを指定します。 ディレクトリが存在する必要があり、Microsoft CRMAppPool を起動するユーザーは、このディレクトリを完全に制御する必要があります。 Microsoft Dynamics CRMをインストールすると、既定のユーザーは NT AUTHORITY\NETWORK SERVICE になります。 このエントリは、Microsoft Dynamics CRM 3.0 にのみ必要です。 以降のバージョンの場合、トレース ディレクトリは、Microsoft Dynamics CRM プログラム ファイルのインストール場所 C:\Program Files\Microsoft Dynamics CRM\Trace に設定されます。
TraceRefresh DWORD 0 から 99 までの数値 データが変更されると、他のトレース レジストリ エントリのトレース設定が適用されます。

省略可能なレジストリ エントリ

省略可能なレジストリ エントリを次に示します。

名前 型 データ値 Notes (メモ)
TraceCategories String Category.Feature:TraceLevel TraceCategories レジストリ エントリは、カテゴリ、機能、トレース レベルの組み合わせです。 複数のカテゴリ、機能、トレース レベルを指定できます。 セミコロンを使用して、それぞれの組み合わせを区切ります。 カテゴリ、機能、トレース レベルの一覧、および有効なサンプルの組み合わせについては、「 トレース レベルの値 」セクションを参照してください。
TraceCallStack DWORD 値 0 または 1 値 0 を使用する場合、呼び出し履歴はトレース ファイルに含まれません。 値 1 を使用すると、呼び出し履歴がトレース ファイルに含まれます。
TraceFileSizeLimit DWORD 1 MB ~ 100 MB のサイズ TraceFileSizeLimit レジストリ エントリは、トレース ファイルの最大サイズを指定します。 上限に達すると、新しいファイルが作成されます。

省略可能なレジストリ エントリを作成しない場合は、既定のデータ値が使用されます。 既定のデータ値の詳細については、「 省略可能なレジストリ エントリの既定のデータ値 」セクションを参照してください。 レジストリ エントリを作成しても、レジストリ エントリのデータ値を指定しない場合、トレースは機能しません。

Windows PowerShellを使用してトレース設定を有効にする

注:

Windows PowerShellで行われたこれらの変更は、レジストリを更新しません。 これらの変更により、MSCRM_CONFIG データベース内の DeploymentProperties テーブルと ServerSettingsProperties テーブルが更新されます。

コマンドレットを登録する

  1. Microsoft Dynamics CRM サーバーの管理者アカウントにサインインします。
  2. Windows PowerShell ウィンドウで、 コマンドを入力します。 Add-PSSnapin Microsoft.Crm.PowerShell

このコマンドは、Microsoft Dynamics CRM Windows PowerShell スナップインを現在のセッションに追加します。 スナップインは、Microsoft Dynamics CRM サーバーのインストールとセットアップ中に登録されます。

現在の設定の一覧を取得するには、 コマンドを入力します。 Get-CrmSetting TraceSettings

出力は次のようになります。

CallStack : True カテゴリ : *:Error Directory : c:\crmdrop\logs Enabled : False FileSize : 10 ExtensionData : System.Runtime.Serialization.ExtensionDataObject

トレース設定を設定する

  1. コマンドを入力します。 $setting = Get-CrmSetting TraceSettings
  2. トレースを有効にするコマンドを入力します。 $setting.Enabled=$True
  3. トレース設定を設定するには、 コマンドを入力します。 Set-CrmSetting $setting
  4. コマンドを入力して、トレース設定の現在の一覧を取得します。 Get-CrmSetting TraceSettings

Windows PowerShellトレースを無効にするには、手順 2: $setting.Enabled=$Falseの コマンドを使用する以外は、次の同じ手順に従います。

注:

各値のコマンド例の形式は次のとおりです。

  • $setting。Enabled= $EnabledValue ($True または $False)
  • $setting。CallStack= $StackValue ($True または $False)
  • $setting。Categories ="*:Verbose"
  • $setting。Directory ="C:\Program Files\Microsoft Dynamics CRM\Trace"
  • $setting。FileSize= 10

出力は次のようになります。

CallStack : True Categories : *:Error Directory : c:\crmdrop\logs Enabled : True FileSize : 10 ExtensionData : System.Runtime.Serialization.ExtensionDataObject

Microsoft Dynamics CRM 2011 および 2013 トレース ログ ファイルの場所

Microsoft Dynamics CRMでトレースを作成すると、Trace Directory レジストリ キーは無視されます。 Microsoft Dynamics CRMでトレースを行う場合、トレース ログ ファイルは次のフォルダーに作成されます。

ドライブ:\Program Files\Microsoft Dynamics CRM\Trace

Microsoft Office Outlook 用の Microsoft Dynamics CRM 2011 または 2013 クライアントでトレースする場合、更新プログラムロールアップ 7 以降の累積的な更新プログラムがインストールされている場合、トレース ログ ファイルは次のフォルダーに作成されます。

DriveName:\ InstallingUser \Local Settings\Application Data\Microsoft\MSCRM\Traces

レジストリ エントリの場所

Microsoft Dynamics CRM サーバー トレース レジストリ エントリは、次のレジストリ サブキーにあります。

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRM

Outlook トレース レジストリ エントリのMicrosoft Dynamics CRM クライアントは、次のレジストリ サブキーにあります。

HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\MSCRMClient

Microsoft Dynamics CRM SSRS Data Connector トレース レジストリ エントリは、次のレジストリ サブキーにあります。

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRMBidsExtensions

Microsoft Dynamics CRM Data Migration Manager トレース レジストリ エントリは、次のレジストリ サブキーにあります。

HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\DATA MIGRATION WIZARD

TraceCategories レジストリ エントリのカテゴリ値の完全な一覧

Microsoft Dynamics CRM 2011 年と 2013 年

  • ADUtility
  • アプリケーション
  • Application.Outlook
  • DataMigration
  • 展開
  • Deployment.Provisioning
  • Deployment.Sdk
  • Exception
  • Etm
  • ライブ
  • Live.AggregationDataExport
  • Live.PartnerInteraction
  • Live.Platform
  • Live.Portal
  • Live.Provisioning
  • Live.Support
  • Live.SyncDaemon
  • 監視
  • NewOrgUtility
  • ObjectModel
  • ParameterFilter
  • プラットフォーム
  • Platform.Async
  • Platform.ImportExportPublish
  • Platform.Import
  • Platform.Metadata
  • Platform.Sdk
  • Platform.Soap
  • Platform.Sql
  • Platform.Workflow
  • レポート
  • サンドボックス
  • Sandbox.AssemblyCache
  • Sandbox.LoadBalancer
  • Sandbox.CallReturn
  • Sandbox.EnterExit
  • Sandbox.StartStop
  • Sandbox.Performance
  • Sandbox.Monitoring
  • SchedulingEngine
  • ServiceBus
  • 共有
  • SharePointCollaboration
  • ソリューション
  • Unmanaged.Outlook
  • Unmanaged.Platform
  • Unmanaged.Sql
  • 視覚 エフェクト

トレース レベルの値

TraceLevel の有効なトレース レベル値の完全な一覧

  • Off
  • Error
  • 警告
  • 情報
  • 詳細

注:

メッセージは、カテゴリのトレース レベルがメッセージのレベル以上の場合にのみログに記録されます。 たとえば、トレース レベルの警告では、警告レベルとエラーレベルのメッセージがログに記録されます。 情報のトレース レベルは、情報、警告、およびエラーのレベルを持つメッセージをログに記録します。 [詳細] のトレース レベルでは、すべてのメッセージがログに記録されます。 トレース レベルの Verbose は、短時間のみ使用する必要があります。

サンプル カテゴリとトレース レベルの組み合わせ

  • *:Verbose

    注:

    この組み合わせでは *:Verbose 、すべてのカテゴリのすべてのメッセージがログに記録されます。 この組み合わせは短い期間のみ使用 *:Verbose する必要があります。

  • Application.*:Error

    注:

    この組み合わせでは Application.*:Error 、カテゴリのエラー レベルを持つすべてのメッセージがログに Application.* 記録されます。

  • Platform.*:Warning

    注:

    この組み合わせでは Platform.*:Warning 、カテゴリの警告またはエラーのレベルを持つすべてのメッセージがログに Platform.* 記録されます。

省略可能なレジストリ値の既定のデータ値

  • TraceCategories: *:Error
  • TraceCallStack: 0
  • TraceFileSizeLimit: 5

Microsoft Dynamics CRM電子メール ルーター サービス トレース

詳細については、「Microsoft Dynamics CRM 電子メール ルーターのトレースを有効にする方法」を参照してください。

Microsoft Dynamics CRM サーバーのスケジュールされたトレースを有効にする方法

詳細については、「Microsoft Dynamics CRMのスケジュールされたトレースを有効にする方法」を参照してください。

Outlook クライアントのMicrosoft Dynamics CRMのトレースを有効にする方法

詳細については、「Outlook クライアントのMicrosoft Dynamics CRMのトレースを有効にする方法」を参照してください。