如何在 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 中的其他問題進行疑難解答時,追蹤檔案會很有説明。

您可以建立 Unmanaged 追蹤檔案和受控追蹤檔案。 Unmanaged 和 Managed 追蹤檔案中的資訊是由您手動建立的必要和選擇性登錄專案所決定。 安裝 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 啟用追蹤設定一節。

必要的登錄專案

以下是必要的登錄專案。 如需這些登錄專案位置的詳細資訊,請參閱 登錄專案位置一 節。

名稱 類型 數據值 附註
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 介於零到99之間的數位 當數據變更時,會套用其他追蹤登錄專案中的追蹤設定。

選擇性登錄專案

以下是選擇性的登錄專案。

名稱 類型 數據值 附註
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 數據表。

註冊 Cmdlet

  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。目錄 =“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 中建立追蹤時,會忽略追蹤目錄登錄機碼。 若要追蹤 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 資料連接器追蹤登錄項目位於下列登入子機碼中:

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 的有效追蹤層級值完整清單

  • 關閉
  • 錯誤
  • 警告
  • Info
  • 詳細資訊

注意事項

只有在類別目錄的追蹤層級等於或大於訊息層級時,才會記錄訊息。 例如,警告的追蹤層級會記錄層級為 Warning 和 Error 的訊息。 信息的追蹤層級會記錄資訊層級、警告和錯誤層級的訊息。 詳細信息的追蹤層級會記錄所有訊息。 您應該只在短期間內使用詳細資訊的追蹤層級。

範例類別和追蹤層級組合

  • *:Verbose

    注意事項

    組合會 *:Verbose 記錄所有類別中的所有訊息。 您應該只在短期間內使用 *:Verbose 組合。

  • Application.*:Error

    注意事項

    組合會 Application.*:Error 記錄類別中具有 Error Application.* 層級的所有訊息。

  • Platform.*:Warning

    注意事項

    組合會 Platform.*:Warning 記錄類別的所有警告或錯誤 Platform.* 層級的訊息。

選擇性登錄值的預設數據值

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

Microsoft Dynamics CRM 電子郵件路由器服務追蹤

如需詳細資訊,請參閱如何啟用 Microsoft Dynamics CRM 電子郵件路由器的追蹤

如何啟用 Microsoft Dynamics CRM Server 的排程追蹤

如需詳細資訊,請參閱如何啟用 Microsoft Dynamics CRM 的排程追蹤

如何啟用 Outlook 用戶端 Microsoft Dynamics CRM 追蹤

如需詳細資訊,請參閱如何啟用 Outlook 用戶端 Microsoft Dynamics CRM 追蹤