如何在 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
- 登入您 Microsoft Dynamics CRM 伺服器上的系統管理員帳戶。
- 在 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
設定追蹤設定
- 輸入命令:
$setting = Get-CrmSetting TraceSettings
。 - 輸入命令以啟用追蹤:
$setting.Enabled=$True
。 - 輸入命令以設定追蹤設定:
Set-CrmSetting $setting
。 - 輸入 命令以取得追蹤設定的目前清單:
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
記錄類別中具有 ErrorApplication.*
層級的所有訊息。Platform.*:Warning
注意事項
組合會
Platform.*:Warning
記錄類別的所有警告或錯誤Platform.*
層級的訊息。
選擇性登錄值的預設數據值
- TraceCategories: *:Error
- TraceCallStack:0
- TraceFileSizeLimit:5
Microsoft Dynamics CRM 電子郵件路由器服務追蹤
如需詳細資訊,請參閱如何啟用 Microsoft Dynamics CRM 電子郵件路由器的追蹤。
如何啟用 Microsoft Dynamics CRM Server 的排程追蹤
如需詳細資訊,請參閱如何啟用 Microsoft Dynamics CRM 的排程追蹤。