Dynamics 365 启用跟踪及读取跟踪文件工具

微软动态CRM专家罗勇 ，回复315或者20190313可方便获取本文，同时可以在第一间得到我发布的最新博文信息，follow me！我的网站是 www.luoyong.me 。

当根据错误提示排查问题有困难时候，便可以考虑启用Dynamics 365的跟踪(tracing)，启用跟踪的方法可以参考官方的这篇文章：How to enable tracing in Microsoft Dynamics CRM 。

启用跟踪有两种方法，下面分别讲述：

首先介绍使用注册表的方法。使用 regedit 命令打开注册表后，导航到 HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\MSCRM ，必须要添加的注册表项目如下：

名称	是否必须	类型	值	备注
TraceEnabled	是	DWORD	0 或者 1	0代表禁用跟踪 1代表启用跟踪
TraceDirectory	CRM 3.0必须，否则非必须	String	跟踪文件存入目录	一般会被忽略，默认是 CRM安装磁盘(比如D盘)下面的\Program Files\Microsoft Dynamics CRM\Trace 。 请确保应用程序池CRMAppPool的运行账号对改目录有修改权限
TraceRefresh	是	DWORD	0到99之间的数字	当其他注册表项目值有变化时，请更改此注册表项目值以便使其生效
TraceCategories	否	String 或者 Multi-String	Category.Feature:TraceLevel	两个的组合，一般可以用如下的某个，如果没有设置默认值时 *:Error *:Off *:Error *:Warning *:Info *:Verbose
TraceCallStack	否	DWORD	0 或者 1	0代表跟踪文件内容不包括CallStack 1代表跟踪文件内容包括CallStack 默认值为0
TraceFileSizeLimit	否	DWORD	1到100之间的数字	单位是M(兆)，就是一个跟踪文件达到这么大以后，新的跟踪内容写如新的跟踪文件，默认为 5兆

再介绍使用PowerShell的方法。使用具有管理员权限的用户登录到部署管理器所在的服务器，以管理员身份打开PowerShell。

查看当前跟踪设置请使用如下命令：

Add-PSSnapin Microsoft.Crm.PowerShell
Get-CrmSetting TraceSettings

我这里以做个启用Error级别日志的例子：

Add-PSSnapin Microsoft.Crm.PowerShell
$setting = Get-CrmSetting TraceSettings
$setting.Enabled = $True
$setting.CallStack = $True
$setting.Categories = "*:Error"
$setting.FileSize = 10
$setting.Directory = "C:\Program Files\Dynamics 365\Trace"
Set-CrmSetting $setting
Get-CrmSetting TraceSettings

下面是禁用的例子：

Add-PSSnapin Microsoft.Crm.PowerShell
$setting = Get-CrmSetting TraceSettings
$setting.Enabled = $False
$setting.CallStack = $False
Set-CrmSetting $setting
Get-CrmSetting TraceSettings

读者可能会有疑问，如果既使用注册表来设置，又使用PowerShell来设置，听谁的？

• PowerShell设置启用跟踪，注册表设置禁用跟踪，结果是以PowerShell设置的为准，也就是启用跟踪；
• PowerShell和注册表都设置为启用跟踪，以注册表的设置为准，跟踪文件存放在 CRM安装磁盘(比如D盘)下面的\Program Files\Microsoft Dynamics CRM\Trace；
• 如果PowerShell设置为禁用跟踪，而注册表设置启用跟踪，那么只有注册表设置的服务器时启用跟踪，跟踪文件存放在 CRM安装磁盘(比如D盘)下面的\Program Files\Microsoft Dynamics CRM\Trace。

还有就是产生的跟踪文件可有工具可以辅助看嘛？这里主要介绍两款工具：

• PFECRMTraceTool，下载网址是 https://pfecrmtracetool.codeplex.com/ ，有问题看 PFE CRM Trace Log File Reader 。
• Trace Reader for Microsoft Dynamics CRM，下载网址是 http://crmtracereader.codeplex.com/  。