分析插件性能

  • 项目

 

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

Plug-in Profiler 是一个用于对插件和自定义工作流活动的执行进行探查的工具，其目的是增强 Microsoft Visual Studio 中的调试体验。 此工具可从命令提示符窗口或从Plug-in Registration工具中运行，其使得开发针对Microsoft Dynamics 365（在线或本地）的自定义代码变得更快更轻松。 另外，用户可以探查失败代码的执行，将结果发送给代码开发人员或独立软件供应商 (ISV) 以进行分析。 即使与 Microsoft Dynamics 365 服务器断开连接，开发人员也可以重播插件或自定义工作流活动的执行情况，并远程调试此代码。

该工具既可用于调试模式，也可用于重播模式。 以下各节将分别介绍这两种模式。

本主题内容

使用插件探查器调试插件

重播插件执行

独立运行插件探查器

使用插件探查器调试插件

  1. 运行 Plug-in Registration 工具。 可以在 SDK 的 Tools\PluginRegistration 文件夹中找到该工具的可执行文件。下载 Microsoft Dynamics CRM SDK 包。

  2. 单击“创建新的链接”以连接到 Microsoft Dynamics 365 服务器和组织。 有关连接到服务器和组织的详细信息，请参阅 SDK 主题：演练：使用插件注册工具注册插件。

  3. 在 Microsoft Dynamics 365 服务器上注册插件和步骤。 将调试编译插件程序集复制运行该工具的计算机上。

  4. 在目标组织的工具栏上，选择“安装探查器”。 现在，您将在列表中看到“插件探查器”节点。

  5. 选择一个插件步骤并单击工具栏中的“启动探查”开始探查。 您可以在显示的“探查器设置”对话框中选择探查器运行方式。

  6. 在 Microsoft Dynamics 365 中执行使插件运行的操作。 例如，如果将此步骤配置为客户的更新，则更新客户。

  7. 在插件引发异常，并显示“业务流程错误”对话框后，如果您在“探查器设置”对话框中选择了“异常”选项，单击“下载日志文件”并保存此文件。 或者，如果插件未引发异常，则单击“停止探查”。

  8. 在 Plug-in Registration 工具中，单击“调试”。

  9. 在“调试现有插件”对话框中的“设置”选项卡上提供请求的信息。 在“配置文件”字段中输入之前保存的日志文件的位置。 输入或选择插件程序集的位置和所执行插件的类名称。

  10. 启动 Microsoft Visual Studio，并将调试程序附加到 PluginRegistration.exe 进程。

  11. 在插件代码中设置断点。

  12. 在“调试现有插件”对话框中，单击“开始执行”。

  13. 在略微延迟后，插件将使用 Microsoft Dynamics 365 服务器传递给它的同一执行上下文执行，调试程序将在之前设置的断点位置停止执行。

  14. 继续像通常那样调试插件。 插件输出的所有跟踪内容都会显示在“调试现有插件”对话框中。

此时，可以更改插件代码，构建该代码，将调试程序重新附加到 PluginRegistration.exe 进程，然后单击“开始执行”以继续调试会话。 在执行这些操作时，不需要关闭“调试现有插件”窗体。

在修复代码问题之前，不需要将插件重新部署到 Microsoft Dynamics 365 服务器。 即使服务器上拥有优化的插件版本，正在调试的计算机上拥有插件的调试版本，此调试方案也有效。

重播插件执行

重播插件执行情况不需要连接到 Microsoft Dynamics 365 服务器和组织。 此方法的优势在于：您可以从客户那里获取插件执行探查情况，并远程调试插件。 重播功能的限制是：调试时，您不能更改调试程序中设置的调用插件代码的顺序。

重播功能会为插件提供 Microsoft Dynamics 365 服务器中的调用数据和事件执行上下文的快照。 您将从组织服务调用中获得相同的事件、GUID 等，但在调试插件时您不能在服务器上修改任何数据。 在上一节的调试过程中，插件实际上会连接到服务器，并进行实时调用。

重播插件执行

  1. 启动 Microsoft Visual Studio，并将调试程序附加到 PluginRegistration.exe 进程。

  2. 单击“重播插件执行”。

  3. 在对话框中输入日志和插件程序集的位置。

  4. 单击“开始执行”。

  5. 像通常那样调试插件。

独立运行插件探查器

可以独立于 Plug-in Registration 工具，从命令提示符窗口执行探查器。 这对从客户的 Microsoft Dynamics 365 服务器获取插件探查日志文件来调试故障插件很有用。 然后，开发人员可以使用该日志在Plug-in Registration工具中重播插件的执行，使用 Microsoft Visual Studio 调试插件。

从命令提示符运行插件探查器

  1. 打开命令提示符窗口，并将工作目录设置为 SDK 下载中的 Tools\PluginRegistration 文件夹。

  2. 键入以下命令：PluginProfiler.Debugger.exe /?。

  3. 查看支持的参数列表，并使用适当参数再次运行 PluginProfiler.Debugger.exe 程序。

另请参阅

开发人员工具包
团队开发解决方案的工具
插件开发
注册和部署插件
调试插件

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权