生成性能数据日志(性能数据收集)

通过性能数据收集,可以将 Unified Service Desk 客户端应用程序中有关作事件的数据收集到日志文件,这些文件用于识别和排查性能问题。

可以生成性能数据日志,以便:

  • 从客户端应用程序启动时分析 Unified Service Desk 的端到端性能。
  • 分析代理在统一服务台客户端应用程序中执行的作的性能。

可以通过两种方式生成性能数据日志:

  • 使用应用程序配置文件(UnifiedServiceDesk.exe.config)为端到端客户端应用程序生成数据日志,包括通过关闭客户端应用程序启动。
  • 使用键盘快捷方式为作生成数据日志。

注释

如果遇到统一服务台的性能问题,客户支持可能会要求你收集性能数据,并发送日志文件来帮助解决问题。

使用应用程序配置文件(UnifiedServiceDesk.exe.config)生成性能数据日志

使用应用程序配置文件(UnifiedServiceDesk.exe.config)生成(收集)启动性能数据日志。

如果在启动 Unified Service Desk 时遇到问题,可以手动修改应用程序配置文件(UnifiedServiceDesk.exe.config),开始将性能数据收集到日志文件。

若要开始收集启动性能数据日志,请将应用程序配置文件中的值从 Off 更改为 XML 节点中的 详细 值。

<add name="Microsoft.Uii.Common.Performance" value="Verbose"/>

详细信息: 诊断详细级别

使用键盘快捷方式生成性能数据日志

使用客户端应用程序并想要分析所执行作的性能时,需要生成性能日志,以便生成特定于这些作的性能报告。

使用键盘快捷方式启动性能数据收集

  1. Ctrl+Alt+Q 或配置的键盘快捷方式开始收集性能数据。 统一服务台显示一个窗口,询问 - 是否开始收集性能数据?

    是否开始收集性能数据。

    注释

    按键盘快捷方式并且 Unified Service Desk 未显示性能数据收集起始窗口时,请确保键盘焦点不在 Internet Explorer 网页中。 按 Alt+0 将键盘焦点置于 Internet Explorer 网页之外,然后按键盘快捷方式启动性能数据收集。 详细信息: 管理统一服务台的选项

  2. 选择 “是 ”开始收集性能数据。

注释

如果在开始收集会话的性能数据后按 Ctrl+Alt+Q,统一服务台将显示一个带有消息的窗口 - 性能数据收集已启动。PerfSessionId - XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。 性能数据收集已启动。

使用键盘快捷方式停止性能数据收集

  1. Ctrl+Alt+P 或配置的键盘快捷方式停止收集性能数据。
    统一服务台显示一个带有消息的窗口 - 是否停止收集性能数据?PerfSessionId - XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。

    是否停止收集性能数据。

  2. 选择 “是 ”以停止收集性能数据。

注释

如果在停止收集会话的性能数据后按 Ctrl+Alt+P ,统一服务台将显示一个窗口 性能数据收集已停止性能数据收集已停止。

性能数据文件的位置

开始收集性能数据时,会在客户端计算机上生成具有唯一性能会话 ID(GUID)的日志文件。

客户端计算机上维护日志文件的默认路径:

%APPDATA%\Roaming\Microsoft\Microsoft Dynamics 365 Unified Service Desk\<version>\USDPerformanceData_<hhmmssfff>_<yyyy-mm-dd>

可以从应用程序配置文件更改日志文件的默认路径。 在应用程序配置文件的 XML 节点中,更改以下属性的值。

Attribute 默认值 “新值”
位置 LocalUserApplicationDirectory 自定义
CustomLocation - <\客户端计算机中的 \New 文件夹路径>
示例:C:\UnifiedServiceDesk\Logs

应用程序配置文件中的默认 XML 节点:

<add name="RollingPerfTraceListener" type="Microsoft.Crm.UnifiedServiceDesk.Dynamics.Utilities.Performance.RollingPerfTraceListener, Microsoft.Crm.UnifiedServiceDesk.Dynamics" BaseFileName="USDPerformanceData" Location="LocalUserApplicationDirectory" MaxFileSize ="52428800" MaxFileCount="10"/>

在应用程序配置文件中设置新路径的示例:

<add name="RollingPerfTraceListener" type="Microsoft.Uii.Common.Performance.RollingPerfTraceListener, Microsoft.Uii.Common" BaseFileName="USDPerformanceData" Location="Custom" CustomLocation="C:\UnifiedServiceDesk\Logs" MaxFileSize ="52428800" MaxFileCount="10"/>

MaxFileSize 是统一服务台在客户端计算机的默认或配置路径中维护的一个性能日志文件的最大大小(以字节为单位)。 当性能日志文件的大小等于 MaxFileSize 值时,Unified Service Desk 会在默认或配置的路径中生成一个新文件,并继续收集性能数据。

示例:配置 MaxFileSize=“520000000”。 当性能日志文件的大小为 52,000,000 字节(52 MB)时,Unified Service Desk 会在默认或配置路径中生成新的性能日志文件,并继续收集性能数据。

MaxFileCount 是统一服务台在客户端计算机的默认或配置路径上维护的文件计数。 当性能日志文件计数等于 MaxFileCount 值时,Unified Service Desk 将删除最早的性能日志文件,以在默认或配置的路径中生成新的性能日志文件。

示例:配置 MaxFileCount=“10”。 Unified Service Desk 在默认或配置的路径中生成 10 个性能日志文件。 若要生成新的性能日志文件,Unified Service Desk 将删除最早的性能日志文件并生成新的性能日志文件。 始终不能超过 MaxFileCount 的性能日志文件计数。

注释

每次开始收集性能数据时,Unified Service Desk 都会创建一个具有性能会话 ID 的新文件,该文件在客户端计算机上维护。

配置性能数据收集键盘快捷方式

在客户端计算机上运行的代理可以使用键盘快捷方式启动和停止收集统一服务台性能数据。 默认情况下,启动性能数据收集的键盘快捷方式为 Ctrl+Alt+Q ,停止性能数据收集的键盘快捷方式为 Ctrl+Alt+P

若要更改默认键盘快捷方式,系统管理员需要配置新的键盘快捷方式,以启动和停止收集统一服务台性能数据。

若要配置新的性能数据收集键盘快捷方式,

  1. 登录到 Dynamics 365 实例。

  2. 选择 Dynamics 365 旁边的向下箭头。

  3. 选择 统一服务台管理员

  4. 在站点地图中的“高级设置”下选择“审核和诊断设置”。

  5. “活动审核和诊断设置” 页中选择一条记录。

    注释

    如果没有现有记录,请创建新的审核和诊断设置记录。 详细信息: 创建用于诊断的审核和诊断记录

  6. 选择“ 诊断设置” 选项卡以查看 “性能数据收集 ”部分。

  7. 在“按需开始快捷方式”和“按需结束快捷方式”字段的格式键1+key2+key3 中键入键盘快捷方式。 例如,适用于按需开始快捷方式的 Ctrl+Alt+Q 和按需端快捷方式的 Ctrl+Alt+P

  8. 选择“ 保存” 以保存更改。

另请参阅

Unified Service Desk 性能分析器概述

下载 Unified Service Desk 性能分析器

性能报告用户界面概述

在 Unified Service Desk 中配置审核和诊断

统一服务台的管理选项