在客户端上使用跟踪 (SharePoint Server 2010)

 

适用于: SharePoint Server 2010

上一次修改主题: 2016-11-30

对于基于 Microsoft Business Connectivity Services 的解决方案,诊断日志记录会发生在运行 Microsoft Office 2010 的客户端上。日志有两种类型:事件日志和跟踪日志。这两种日志都记录 Microsoft Business Connectivity Services 生成的诊断信息。事件日志记录错误消息。跟踪日志包含更深入的信息,如堆栈跟踪和信息性消息。通常,跟踪日志比事件日志提供更多的详细信息。

备注

诊断日志记录还会发生在运行 SharePoint Server 2010 的服务器上。有关详细信息,请参阅Business Connectivity Services 中的诊断日志记录概述 (SharePoint Server 2010)

默认情况下,客户端计算机上已禁用跟踪日志记录以帮助改进性能。仅在遇到需要诊断的问题时,才应该在客户端计算机上启用跟踪日志记录。例如,如果事件日志条目指示错误可能是由与 Microsoft Business Connectivity Services 相关的活动引起的,则应该启用跟踪日志记录以在下次出现该事件时收集更多数据。

本文介绍如何在运行 Windows 7 或 Windows Vista 的客户端计算机上使用“性能监视器”实用工具来启用跟踪以捕获 Microsoft Business Connectivity Services 事件。

备注

在运行 Windows XP 或更早版本的计算机上,可通过运行使用 logman 命令的脚本来启用跟踪。有关示例脚本,请参阅 Business Connectivity Services 中的诊断日志记录概述 (SharePoint Server 2010)

提示

默认情况下,客户端上已启用 Microsoft Business Connectivity Services 的事件日志记录。但为了提高性能,仅记录严重错误,并且无法更改此设置。Windows 客户端计算机包含可用于查看事件日志的事件查看器。有关如何在特定版本的 Windows 中查看事件日志的信息,请参阅产品文档。

本文内容:

  • 启用 Business Connectivity Services 跟踪

  • 运行 Business Connectivity Services 跟踪

  • 查看 Business Connectivity Services 跟踪的结果

启用 Business Connectivity Services 跟踪

若要启用 Microsoft Business Connectivity Services 跟踪,请创建自定义数据收集器集,指定与 Microsoft Business Connectivity Services 相关的跟踪提供程序,并提供用于保存跟踪日志的位置。

备注

以下过程适用于 Windows Vista 和 Windows 7 客户端计算机。

启用 Business Connectivity Services 跟踪

  1. 验证您是否拥有以下管理凭据:

    • 若要在客户端计算机上启用 Microsoft Business Connectivity Services 跟踪,您必须是该计算机上的管理员或 Administrators 组的成员。
  2. 在“开始”菜单上,单击“运行”,键入 perfmon,然后单击“确定”。

    这将启动性能监视器实用工具。

  3. 在左窗格中,展开“数据收集器集”,右键单击“用户定义”,指向“新建”,然后单击“数据收集器集”。

  4. 在“新的数据收集器集”向导的“名称”框中,键入数据收集器集的名称,选择“手动创建(高级)”,然后单击“下一步”。

  5. 在“您希望包括何种类型的数据?”页上,选中“事件跟踪数据”复选框,然后单击“下一步”。

  6. 在“您希望启用哪个事件跟踪提供程序?”页上,单击“添加”。

  7. 在“事件跟踪提供程序”列表中,单击“Microsoft Office Business Connectivity Services”,然后单击“确定”。

  8. 在“属性”对话框中的“自动”部分,选择所有类别,单击“确定”,然后单击“下一步”。

  9. 在“您希望将数据保存在什么位置?”页上,添加要保存数据的路径或者选择默认设置,然后单击“完成”。

运行 Business Connectivity Services 跟踪

启用 Microsoft Business Connectivity Services 跟踪后,可以运行将捕获 Microsoft Business Connectivity Services 事件的跟踪。建议仅在解决方案开发过程中或者为最终用户部署解决方案过程中您怀疑存在问题时,才运行跟踪。若要在客户端计算机上运行 Microsoft Business Connectivity Services 跟踪,您必须是该计算机上的管理员。

提示

运行跟踪的目的是捕获在出现可重现问题期间的事件。在执行此过程之前,请首先确保已经在客户端计算机上设置了正确的条件以重现您需要相关跟踪日志数据的行为。

运行 Business Connectivity Services 跟踪

  1. 验证您是否拥有以下管理凭据:

    • 若要在客户端计算机上运行 Microsoft Business Connectivity Services 跟踪,您必须是该计算机上的管理员或 Administrators 组的成员。
  2. 在“开始”菜单上,单击“运行”,键入 perfmon,然后单击“确定”。

    这将启动性能监视器实用工具。

  3. 在左窗格中,展开“数据收集器集”,然后展开“用户定义”以找到您的用户定义的数据收集器集。

    有关创建数据收集器集的步骤,请参阅启用 Business Connectivity Services 跟踪。

  4. 右键单击您的数据收集器集,然后单击“启动”。

  5. 跟踪运行时,在客户端计算机上执行与 Microsoft Business Connectivity Services 相关的、您希望对其捕获跟踪数据的活动。

  6. 若要停止跟踪,请再次找到您的用户定义的数据收集器集,右键单击它,然后单击“停止”。

查看 Business Connectivity Services 跟踪的结果

可以使用 Windows 7 和 Windows Vista 客户端计算机上的“事件查看器”实用工具查看客户端计算机上 Microsoft Business Connectivity Services 跟踪的结果。

查看 Business Connectivity Services 跟踪的结果

  1. 验证您是否拥有以下管理凭据:

    • 若要查看客户端计算机上 Microsoft Business Connectivity Services 跟踪的结果,您必须是该计算机上的管理员或 Administrators 组的成员。
  2. 在 Windows 控制面板中,双击“管理工具”。

  3. 双击“事件查看器”。

  4. 在“操作”菜单上,单击“打开保存的日志”。

  5. 找到包含跟踪日志的文件夹。

    您在启用 Business Connectivity Services 跟踪过程中提供了此目标位置。

  6. 找到最新的跟踪文件,它具有“.etl”文件扩展名,然后将其打开。

    在服务器和 Office 客户端上,对基于 Microsoft Business Connectivity Services 的解决方案中的外部数据执行的任何创建、更新或删除操作都会生成唯一活动 ID 值。与跟踪日志中记录的操作相关的任何内容都包含其活动 ID 值。根据视图的配置方式,事件查看器最初可能不显示 Microsoft Business Connectivity Services 日志的活动 ID。

    显示每个项目的活动 ID:

    1. 在事件查看器的“查看”菜单中,单击“添加/删除列”。

    2. 在“添加/删除列”对话框中,如果“活动 ID”未在“显示列”部分列出,请在“可用列”部分单击“活动 ID”,单击“添加”,然后单击“确定”。