本文說明如何在 Microsoft Dynamics CRM 中啟用追蹤。
重要 這個章節、方法或工作包含修改登錄的步驟。然而,如果您不當修改登錄,可能會發生嚴重的問題。因此,請務必小心執行這些步驟。為加強保護,修改登錄之前,請務必將它備份起來。以後您就可以在發生問題時還原登錄。如需有關如何備份和還原登錄的詳細資訊,請按一下下面的文件編號,檢視「Microsoft 知識庫」中的文件:
322756
(http://support.microsoft.com/kb/322756/
)
如何在 Windows XP 和 Windows Server 2003 中備份、編輯及還原登錄
Microsoft Dynamics CRM 可讓您建立追蹤檔案,該檔案可監控 Microsoft CRM 所執行的動作。當您必須在 Microsoft CRM 中疑難排解錯誤訊息或其他問題時,追蹤檔案會很有幫助。
您可以建立不受管理的追蹤檔案及受管理的追蹤檔案。您手動建立的必要及選用登錄項目將決定不受管理之追蹤檔案與受管理之追蹤檔案的資訊。安裝 Microsoft CRM 或 Microsoft CRM client for Outlook 後,您在 Microsoft CRM 伺服器或執行 Microsoft CRM client for Microsoft Office Outlook 的電腦上建立這些登錄項目。
必要的登錄項目
下列為必要的登錄項目。如需有關這些登錄項目位置的詳細資訊,請參閱<登錄項目位置>一節。
摺疊此表格展開此表格
| 名稱 | 類型 | 資料值 | 注意 |
|---|
| TraceEnabled | DWORD | 值為 0 或 1 | 如果使用的值為 0,追蹤會停用。如果使用的值為 1,追蹤會啟用。 |
| TraceDirectory | 字串 | C:\CRMTrace | TraceDirectory 登錄項目會指定追蹤記錄檔的目錄。該目錄必須存在,而且啟動 Microsoft CRMAppPool 的使用者必須擁有此目錄的完全控制權。安裝 Microsoft CRM 時,預設的使用者是 NT AUTHORITY\NETWORK SERVICE。 |
| TraceRefresh | DWORD | 介於 0 到 99 之間的數字 | 變更該資料時,會套用其他追蹤登錄項目中的追蹤設定。 |
選用的登錄項目
下列為選用的登錄項目。
摺疊此表格展開此表格
| 名稱 | 類型 | 資料值 | 注意 |
|---|
| TraceCategories | 字串或多字串 | Category.Feature:TraceLevel | TraceCategories 登錄項目是類別、功能與追蹤層級的組合。您可以指定多個類別、功能與追蹤層級。各個組合之間必須以分號分隔。如需類別、功能與追蹤層級的清單以及有效的組合範例,請參閱<追蹤層級值>一節。 |
| TraceCallStack | DWORD | 值為 0 或 1 | 如果使用的值為 0,呼叫堆疊不會包含在追蹤檔案中。如果使用的值為 1,呼叫堆疊會包含在追蹤檔案中。 |
| TraceFileSizeLimit | DWORD | 介於 1 到 100 MB 之間的容量 | TraceFileSizeLimit 登錄項目會指定追蹤檔案的最大容量上限。達到該限制時,便會建立新的檔案。 |
如果不建立選用的登錄項目,則會使用預設的資料值。如需有關預設資料值的詳細資訊,請參閱<選用登錄項目的預設資料值>一節。如果建立登錄項目,卻未指定登錄項目的資料值,則追蹤無法運作。
Microsoft Dynamics CRM 4.0 追蹤記錄檔位置
在 Microsoft Dynamics CRM 4.0 中建立追蹤時,會略過 TraceDirectory 登錄機碼。Microsoft Dynamics CRM 4.0 伺服器上的追蹤,其追蹤記錄檔會建立在下列資料夾:
Drive:\Program Files\Microsoft Dynamics CRM\Trace
Microsoft Dynamics CRM 4.0 client for Microsoft Office Outlook 上的追蹤,或是 Microsoft Dynamics CRM 4.0 Data Migration Manager 上的追蹤,其追蹤記錄檔會建立在下列資料夾:
DriveName:\Documents and Settings\ InstallingUser \Application Data\Microsoft\MSCRM\Traces
登錄項目位置
Microsoft CRM 伺服器追蹤登錄項目位於下列登錄子機碼中:
HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRM
Microsoft CRM client for Outlook 追蹤登錄項目位於下列登錄子機碼中:
HKEY_CURRENT_USER\SOFTWARE\MICROSOFT\MSCRMClient
Microsoft CRM Data Migration Manager 追蹤登錄項目位於下列登錄子機碼中:
HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\DATA MIGRATION WIZARD
TraceCategories 登錄項目類別值的完整清單
- *
- Application.*
Application.* 類別包括下列項目: - Exception
- ObjectModel
- ParameterFilter
- Platform.*
Platform.* 類別包括下列項目:- Platform.ImportExportPublish
- Platform.Sdk
- Platform.Metadata
- Platform.Sql
- Platform.Workflow
- Platform.Soap
- SchedulingEngine.*
- Unmanaged.*
Unmanaged.* 類別包括下列項目:- Unmanaged.Outlook
- Unmanaged.Platform
- Unmanaged.Sql
追蹤層級值
TraceCategories 有效追蹤層級值的完整清單
注意 只有在類別的追蹤層級等於或大於訊息的層級時,才會記錄訊息。例如,「警告」追蹤層級會記錄層級為「警告」及「錯誤」的訊息。「資訊」追蹤層級則會記錄層級為「資訊」、「警告」及「錯誤」的訊息。而「詳細資訊」追蹤層級會記錄所有訊息。您只應在短時間內使用「詳細資訊」追蹤層級。
類別與追蹤層級組合範例
- *:Verbose
注意 *:Verbose 組合會記錄每個類別的所有訊息。您只應在短時間內使用 *:Verbose 組合。 - Application.*:Error
注意 Application.*:Error 組合會記錄具有 Application.* 類別之「錯誤」層級的所有訊息。 - Platform.*:Warning
注意 Platform.*:Warning 組合會記錄具有 Platform.* 類別之「警告」或「錯誤」層級的所有訊息。
選用登錄值的預設資料值
- TraceCategories:*:Error
- TraceCallStack:0
- TraceFileSizeLimit:5
Microsoft Dynamics CRM 4.0 電子郵件路由器
您可以更新 Microsoft Dynamics CRM 電子郵件路由器以啟用追蹤。如果要執行這項操作,您必須修改登錄及 XML 服務組態。
若要啟用詳細資訊操作登錄層級,您必須更新登錄以手動更新組態。如果要執行這項操作,請依照下列步驟執行:
- 使用本機系統管理員的權限登入已安裝 Microsoft CRM 電子郵件路由器的伺服器。
- 按一下 [開始],按一下 [執行],輸入 regedit,然後按一下 [確定]。
- 找出並按一下下列登錄子機碼:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSCRMEmail
- 用滑鼠右鍵按一下 LogLevel 登錄項目、按一下 [修改],然後將值變更為 3。根據預設,此值設為 1。
- 更新電子郵件路由器服務的 Microsoft.Crm.Tools.EmailAgent.xml 組態檔。如果要執行這項操作,請依照下列步驟執行:
- 在 Windows 檔案總管中,找出 Microsoft.Crm.Tools.EmailAgent.xml 檔案。根據預設,這個檔案位於下列資料夾中:
SystemDrive:\Program Files\Microsoft CRM Email\Service
- 使用「記事本」或其他文字編輯程式開啟該檔案。
- 檢查檔案中的 <SystemConfiguration> 節點,然後向下捲動文字直到檔案的結尾,以找出下列陳述式:
<LogLevel>1</LogLevel>
根據預設,此值設為 1 (一)。修改此陳述式以讓其變成如下所示:<LogLevel>3</LogLevel>
- 儲存檔案。
- 重新啟動電子郵件路由器服務。您會找到名稱為 MSCRMEmailLog 的新事件檢視器記錄檢視。在這個事件檢視器記錄檢視中,會出現事件。
文章編號: 907490 - 上次校閱: 2009年9月24日 - 版次: 7.1
這篇文章中的資訊適用於:
- Microsoft Dynamics CRM 4.0
- Microsoft CRM 3.0
| kbcrmv3c kbmbsmigrate kbinfo KB907490 |
Microsoft及(或)其供應商不就任何在本伺服器上發表的文字資料及其相關圖表資訊的恰當性作任何承諾。所有文字資料及其相關圖表均以「現狀」供應,不負任何擔保責任。Microsoft及(或)其供應商謹此聲明,不負任何對與此資訊有關之擔保責任,包括關於適售性、適用於某一特定用途、權利或不侵權的明示或默示擔保責任。Microsoft及(或)其供應商無論如何不對因或與使用本伺服器上資訊或與資訊的實行有關而引起的契約、過失或其他侵權行為之訴訟中的特別的、間接的、衍生性的損害或任何因使用而喪失所導致的之損害、資料或利潤負任何責任。