如何在 Microsoft Dynamics CRM 2013 和 2011 中启用跟踪
本文介绍如何在 Microsoft Dynamics CRM 中启用跟踪。
适用于:2011 Microsoft Dynamics CRM、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启用跟踪设置部分。
必需的注册表项
以下是所需的注册表项。 有关这些注册表项的位置的详细信息,请参阅 注册表项位置 部分。
名称 | 类型 | 数据值 | 注意 |
---|---|---|---|
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 之间的数字 | 更改数据时,将应用其他跟踪注册表项中的跟踪设置。 |
可选注册表项
下面是可选的注册表项。
名称 | 类型 | 数据值 | 注意 |
---|---|---|---|
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 Categories : *: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。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 中创建跟踪时,将忽略跟踪目录注册表项。 对于Microsoft Dynamics CRM的跟踪,会在以下文件夹中创建跟踪日志文件:
Drive:\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
SSRS 数据连接器跟踪注册表项Microsoft Dynamics CRM位于以下注册表子项中:
HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRMBidsExtensions
Microsoft Dynamics CRM数据迁移管理器跟踪注册表项位于以下注册表子项中:
HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\DATA MIGRATION WIZARD
TraceCategories 注册表项的类别值的完整列表
Microsoft Dynamics CRM 2011 和 2013
- ADUtility
- 应用程序
- Application.Outlook
- DataMigration
- 部署
- Deployment.Provisioning
- Deployment.Sdk
- 异常
- 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 的有效跟踪级别值的完整列表
- 关闭
- 错误
- 警告
- 信息
- 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跟踪。