部署 Office 遥测仪表板

适用于:Microsoft 365 企业应用版、Office 2019 和 Office 2016

重要

本文可帮助你部署 Office 遥测仪表板的五个组件:仪表板本身、处理器、代理、数据库和共享文件夹。 在部署这些组件之前,请确保查看 规划部署 Office 遥测仪表板 的拓扑、可伸缩性和硬件指南。

重要

  • Office 遥测仪表板是一种本地工具,用于收集有关组织中使用的 Office 文档和解决方案(如加载项)的清单、使用情况和运行状况数据。 数据主要用于帮助组织进行应用程序兼容性测试。
  • 为 Office 遥测仪表板收集的数据存储在组织控制的SQL Server数据库中,收集的数据不会发送到 Microsoft。 有关详细信息,请参阅 Office 遥测仪表板代理收集的数据
  • 为 Office 遥测仪表板收集的数据不同于可发送给 Microsoft 的 Office 诊断数据。 有关 Office 诊断数据的详细信息,请参阅Microsoft 365 应用版隐私控件概述
  • 用于管理 Office 遥测仪表板的设置不会影响 Office 诊断数据,反之亦然。 有关管理 Office 诊断数据的详细信息,请参阅使用策略设置管理Microsoft 365 应用版的隐私控制

Office 遥测仪表板

Office 遥测仪表板是配置为连接到数据库的 Excel 工作簿。 Office 遥测仪表板与Microsoft 365 企业应用版、Office 专业增强版 2019、Office 专业增强版 2016和Office 标准版 2016一起安装。 若要查看 Office 遥测仪表板,必须从 Microsoft 365 企业应用版、Office 2019 或 Office 2016 安装 Excel。

安装 Office 后,可以使用下表中的过程之一启动 Office 遥测仪表板:

如何启动 Office 遥测仪表板

操作系统 如何启动 Office 遥测仪表板
Windows 10、Windows Server 2008 R2 或 Windows 7 Service Pack 1
从“开始”菜单中,依次选择“所有程序”、“Microsoft Office 2016 工具”、“Office 2016 遥测仪表板”。
Windows 8.1
在“开始”屏幕中,键入“遥测仪表板”,然后从搜索结果中选择它。
Windows Server 2012 R2 或 Windows Server 2012
从右侧向内轻扫以显示超级按钮,然后选择“搜索”以查看计算机上安装的所有应用程序。 接下来,选择"Office 2016 遥测仪表板"。

对于Microsoft 365 企业应用版和 Office 2019,请在 Microsoft Office 工具下查找 Office 遥测仪表板

注意

  • 对 Windows 7 和 Windows Server 2008 R2 的支持已于 2020 年 1 月 14 日终止。
  • 对Windows 8.1的支持已于 2023 年 1 月 10 日结束。
  • 自 2020 年 1 月 14 日起,Windows Server 2012或 Windows Server 2012 R2 不支持Microsoft 365 企业应用版。

SQL Server

必须先部署SQL Server,然后才能配置 Office 遥测仪表板。 你不必拥有现有数据库,但必须安装或有权访问以下版本的SQL Server之一:

  • SQL Server 2016 或 SQL Server 2016 Express

  • SQL Server 2014 或 SQL Server 2014 Express

  • SQL Server 2012 或 SQL Server 2012 Express

  • SQL Server 2008 R2 或 SQL Server 2008 R2 Express Edition

  • SQL Server 2008 或 SQL Server 2008 Express Edition

  • SQL Server 2005 或 SQL Server 2005 Express Edition

注意

若要检查当前支持的SQL Server版本,请转到搜索产品和服务生命周期信息页。

Office 遥测仪表板中的“入门”工作表提供了下载SQL Server 2014 Express 的链接。 如果尚未安装SQL Server,请按照下载并安装 SQL Server 2014 Express 中的步骤操作。 在安装 SQL Server 2014 Express 之前,请务必查看以下准则。

  • 确保计算机满足 SQL Server 2014 的硬件和软件要求。 如果你正在计划一体的配置进行测试,这一点尤其重要,因为SQL Server有其他要求,例如安装 Office 遥测仪表板不需要的 Windows Service Pack。 安装 SQL Server 2014 的硬件和软件要求中介绍了这些要求。

  • 对于本地安装,您必须以管理员的身份运行安装程序。 如果从远程共享文件夹安装SQL Server,则必须使用对远程共享文件夹具有读取和执行权限的域帐户。 有关详细信息,请参阅安装向导中的安装 SQL Server 2014 (安装程序)

下载并安装 SQL Server 2014 Express

  1. 在 Office 遥测仪表板的“入门”工作表上,低于 1。设置先决条件,选择链接以下载并安装 SQL Server 2014 Express with Tools。 根据需要,选择 32 位或 64 位版本。 或者使用此链接:Microsoft SQL Server 2014 Express

  2. SQL Server 2014 Express 的设置过程需要一段时间才能下载和提取文件。 接受各种提示,并等待提取完成后显示SQL Server 2014 Express 的第一页(称为 SQL Server 安装中心)。 然后,按照以下步骤操作:

    1. 在SQL Server安装中心,选择“新建SQL Server独立安装”或向现有安装添加功能

    2. 在 SQL Server 2014 安装向导中,阅读许可条款,接受这些条款,然后选择“下一步”。

    3. 在“功能选择”页面上,接受默认设置。 选择“下一步”。

    4. 在“ 实例配置 ”页上,创建命名实例 (例如,使用名称“teledash”) 。 选择“下一步”。

    5. 在“ 服务器配置” 页上,接受默认服务帐户。 选择“下一步”。

    6. 在“数据库引擎配置”页面上,接受默认身份验证模式(Windows 身份验证模式)。 用户帐户显示为SQL Server管理员。 (警告:请勿使用混合模式,因为 Office 遥测仪表板不支持SQL Server身份验证。) 选择“下一步”。

    7. 在“错误报告”页面上,如果要向 Microsoft 发送错误报告,则选中该复选框。 否则,仅选择“下一步”

    8. 等待安装过程完成,然后退出向导和SQL Server安装中心。

Office 遥测处理器

Office 遥测处理器在一台或多台计算机上运行,从共享文件夹收集清单、使用情况和运行状况数据,并将数据导入数据库。 处理器作为名为“Office 遥测处理器”的 Windows 服务安装,处理器支持传输层安全性 (TLS) 1.2。

重要

如果运行处理器和共享文件夹对的计算机以及 SQL 数据库未加入域,则必须使用 在工作组或已加入域的计算机上快速设置 Office 遥测仪表板中所述的脚本安装这些组件。

处理器在名为 dperrorlog.txt 的文件中生成错误日志。 该文件位于 %systemroot%\ServiceProfiles\NetworkService\AppData\Local\Temp 的隐藏文件夹中。

安装处理器和数据库的每台计算机还必须针对计算机上运行的 Windows 版本运行最新版本的通用 C 运行时 (CRT) 。 有关信息,请参阅 Windows 中通用 C 运行时的更新

对于运行处理器的计算机,建议使用以下操作系统:

对于生产环境: 为了获得最佳性能,我们建议使用受支持的 Windows Server 版本,例如 Windows Server 2019。

对于测试或小型生产环境:可以在测试环境和小型生产环境中使用运行Windows 10或Windows 11的计算机。 客户端操作系统的并发连接限制为 20 个,但在小型环境中,代理随机化设置应最大程度地减少一次连接超过 20 个代理的可能性。

在运行向导来设置处理器之前,请确保具有以下可用项。

  • SQL Server实例名称。 前面使用的示例是“teledash”。

  • SQL 数据库。 如果未指定现有数据库,则会创建一个新数据库。

  • 创建共享文件夹的权限,或现有共享文件夹的 UNC 路径。 设置处理器的向导可以创建共享文件夹(如果有权这样做)。 如果您指定现有共享文件夹,那么任何现有 NTFS 和共享文件夹权限都将由向导设置的权限所覆盖。

  • 创建数据库的权限(SQL Server 中的 sysadmin 角色)。 若要创建和配置新数据库,运行向导以设置处理器的帐户必须是域帐户,该帐户是SQL Server上的 sysadmin 服务器级角色的成员。 若要持续使用 Office 遥测仪表板,不需要 sysadmin 角色的成员身份,可以在创建数据库后将其删除。 您也可以使用现有数据库。

  • 至少 11 GB 的硬盘空间。 需要此磁盘空间来临时存储从用户收集的数据。

安装 Office 遥测处理器

  1. 在要安装处理器的计算机上,安装最新版本的 CRT。 有关详细信息,请参阅 Windows 中通用 C 运行时的更新

  2. 在 Office 遥测仪表板的 “入门” 工作表上,选择“2”下的安装链接 。安装遥测处理器。 选择与运行处理器的 Windows 操作系统体系结构相同的 x86 或 x64 版本。

  3. (可选)可以使用 Office 遥测仪表板中的链接将.msi文件保存到另一台计算机,并在其中运行安装程序。 如果要在单独的计算机上安装处理器,则需要执行此步骤。

  4. 选择“ 下一步 ”,然后选择“ ”接受用户帐户控制提示以安装处理器。 选择 “完成”,这将启动 Office 遥测处理器设置 向导。

  5. 选择“是”以接受提示,然后选择“下一步”

  6. 键入SQL Server实例的名称,然后选择“连接”。

  7. 键入新数据库的名称,选择“创建”,然后选择“下一步”

  8. 选择“是”以创建数据库权限和数据库角色。

  9. 在“共享文件夹”页面上执行以下操作之一:

    • 指定现有共享文件夹的 UNC 路径,然后选择“下一步”。 选择“是”以允许向导设置适当的权限。

    • 若要在本地计算机上创建新的共享文件夹,请选择“ 浏览”。 导航到要在其中创建共享文件夹的位置。 打开父文件夹的快捷菜单 (右键单击) ,指向 “新建”,然后选择“ 文件夹”。 键入新文件夹的名称,确保再次选择文件夹以将其选中,然后选择 “选择文件夹”。 选择 “下一步”,然后选择“ ”以允许向导共享文件夹并设置相应的权限。

  10. 接受默认选项以注册客户体验改善计划,或者选择相应选项,以便目前不注册该计划,然后选择“下一步”

  11. 单击“完成”,退出向导。

Office 遥测仪表板使用的数据库

Office 遥测处理器设置 向导创建的数据库已准备好配置并连接到 Office 遥测仪表板。

连接到数据库

  1. 在 Office 遥测仪表板中,在 “入门” 工作表的 “5”下。连接到数据库以查看遥测数据,选择 “连接到数据库”。

  2. 指定在安装处理器期间指定的SQL Server和 SQL 数据库的名称。

建立连接后,会将许多新工作表添加到工作簿中。 在部署并启用代理之前,它们不会包含数据。

授予其他管理员访问数据库的权限

  • 可以在运行 SQL Server 的计算机上使用遥测仪表板管理工具 (Tdadm) ,以允许其他管理员查看 Office 遥测仪表板中的数据。 如果在安装处理器时创建了数据库,则无需为自己的帐户运行此帐户。 根据需要更新 dbserver、dbname 和 domain\user 的值。

    tdadm.exe -o permission -databaseserver dbserver -databasename dbname -add domain\user
    

有关 Tdadm 的详细信息,请参阅 Tdadm wiki

有关如何在数据库中配置报告阈值以帮助保护用户隐私的详细信息,请参阅 管理受 Office 遥测仪表板监视的数据的隐私。 如果您在连接到数据库时遇到问题,请参阅解决 Office 遥测仪表板部署问题

如果数据 (,例如文件名、解决方案名称、用户名、计算机名称或标记值) 包括补充字符 (代理项对) ,请使用SQL Server中提供的以下 SC 排序规则来支持更好地处理字符。

  • 版本 90 Windows 排序规则,例如 Chinese_PRC_Stroke_90

  • 版本 100 Windows 排序规则,例如 Latin1_General_100_CI_AS_SC

有关排序规则设置的更多详细信息,请参阅所使用的SQL Server版本文档。

Office 遥测代理

以下信息和说明将帮助你详细了解如何部署和启用 Office 遥测代理。

部署代理

代理内置于 Microsoft 365 企业应用版、Office 2019、Office 2016 和 Office 2013 中,无需单独部署。 如果组织具有以下任何 Office 版本,则必须将 Office 2019 或 Office 2016 代理部署到这些客户端。

  • Office 2003

  • Office 2007

  • Office 2010

注意

不再支持 Office 2003、Office 2007 和 Office 2010。

对于运行 Office 2013 且已在计算机上安装 Office 2013 代理的计算机,还有几个其他注意事项:

  • 可以从 Office 2019 或 Office 2016 Office 遥测仪表板监视运行 Office 2013 的计算机。 为了使此功能正常工作,计算机还必须运行 Office 2013 代理。 必须将代理配置为指向 Office 2019 或 Office 2016 Office 遥测仪表板。

  • 不能将 Office 2019 或 Office 2016 代理与 Office 2013 配合使用。 Office 2019 或 Office 2016 代理将无法读取 Office 2013 安装中的事件。

  • 将计算机升级到 Office 2019 或 Office 2016 后,可以继续运行旧的 Office 2013 代理。 代理将继续向 Office 2013 Office 遥测仪表板报告数据。 同时,升级到 Office 2019 或 Office 2016 时安装的新 Office 2019 或 Office 2016 代理将向 Office 2019 或 Office 2016 Office 遥测仪表板提供相同的数据。 这可能会占用宝贵的计算机和网络带宽资源。 建议在准备好移动到 Office 2019 或 Office 2016 Office 遥测仪表板后禁用 Office 2013 代理。

  • 安装 Office 2019 或 Office 2016 代理时,它不会覆盖 Office 2013 代理。 相反,你需要禁用 Office 2013 代理。 使用 组策略 禁用代理。 有关用于禁用代理的组策略设置的详细信息,请参阅启用和配置代理

  • 建议不要在仅运行 Office 2013 的计算机上部署 Office 2019 或 Office 2016 代理。

若要运行代理,客户端计算机必须运行以下版本的 Windows (32 位或 64 位) 之一:

  • 窗口 10

  • Windows 8.1

  • Windows 7 Service Pack 1

  • Windows Server 2016

  • Windows Server 2012 R2

  • Windows Server 2012

  • Windows Server 2008 R2

  • Windows Server 2008

代理可能无法在 Microsoft 不再支持的 Windows Service Pack 上正常工作。 建议在安装代理之前,在 搜索产品和服务生命周期信息 中验证 Service Pack 是否受支持。

注意

  • 不再支持带有 Service Pack 1、Windows 8.1、Windows Server 2008 R2 和 Windows Server 2008 的 Windows 7。
  • 自 2020 年 1 月 14 日起,Windows Server 2012或 Windows Server 2012 R2 不支持Microsoft 365 企业应用版。

运行代理的计算机还必须运行最新版本的通用 C 运行时 (适用于 Windows 版本的 CRT) 。 有关信息,请参阅 Windows 中通用 C 运行时的更新

将 Office 2019 或 Office 2016 代理部署到 Office 2010、Office 2007 和 Office 2003 客户端

  1. 在 Office 遥测仪表板中,在 “入门” 工作表的 “3”下。部署遥测代理, (x86 或 x64) 选择相应的链接,将代理.msi文件保存到指定位置。

  2. 使用您偏好的方法,将 .msi 文件部署到您想要监控的客户端计算机中。 请确保将代理的 x86 或 x64 版本与客户端上运行的 Windows 操作系统的体系结构(而不是 Office 客户端体系结构)相匹配。

    要进行客户端本地安装,您必须以管理员的身份运行 .msi 文件。 您可以通过对 MSI 使用 /quiet 参数以无提示方式部署 MSI 软件包。 请参阅 MSI 帮助以获得完整的可用参数集。

    对于大规模部署,可以使用 Microsoft Configuration Manager部署遥测代理

启用和配置代理

若要启用和配置代理,可以在小型或测试环境中编辑每台受监视客户端计算机上的注册表。 对于包含成百上千客户端计算机的生产环境,您可以使用组策略管理模板。 AgentInitWait 和 AgentRandomDelay 这两个设置只能在注册表中配置。

使用注册表启用和配置代理

在单个客户端上更新注册表的最简单方法是运行 .reg 文件,该文件设置注册表值,使代理能够收集和上传数据。 可以通过将以下示例之一复制到文本文件、更新必填字段、将文件另存为 agent.reg,然后从提升的命令提示符运行该文件来创建此 .reg 文件。 在 .reg 文件中,确保指定代理将数据上传到的共享文件夹的 UNC 路径。 (可选)可以更新 TAG> 字段,<以便轻松识别组织中收集的数据,例如按部门、位置或部署组。

以下示例设置启用代理所需的默认设置。 AgentInitWait 和 AgentRandomDelay 都设置为其默认值,以适用于生产部署。

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\osm]
"CommonFileShare"="\\\\<SERVERNAME>\\<SHARENAME>"
"Tag1"="<TAG1>"
"Tag2"="<TAG2>"
"Tag3"="<TAG3>"
"Tag4"="<TAG4>"
"AgentInitWait"=dword:00000258
"Enablelogging"=dword:00000001
"EnableUpload"=dword:00000001
"EnableFileObfuscation"=dword:00000000
"AgentRandomDelay"=dword:000000F0

以下示例中的代码通过将 AgentInitWait 和 AgentRandomDelay 设置为最小值,允许 Office 遥测仪表板立即开始上传数据。 仅在测试部署中使用此示例。

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\osm]
"CommonFileShare"="\\\\<SERVERNAME>\\<SHARENAME>"
"Tag1"="<TAG1>"
"Tag2"="<TAG2>"
"Tag3"="<TAG3>"
"Tag4"="<TAG4>"
"AgentInitWait"=dword:00000001
"Enablelogging"=dword:00000001
"EnableUpload"=dword:00000001
"EnableFileObfuscation"=dword:00000000
"AgentRandomDelay"=dword:00000000

可以通过将 .reg 文件放在共享文件夹中并指示用户运行该文件,将注册表更新分发到多台客户端计算机,也可以将命令添加到用户的登录脚本,以在用户登录时自动导入 .reg 文件。 使用下面示例中的语法可从登录脚本启动 .reg 文件:

%windir%\regedit.exe /s <PATH>\<NAME>.reg

有关如何使用 .reg 文件的详细信息,请参阅如何使用注册表项 (.reg) 文件添加、修改或删除注册表子项和值

下表描述每个注册表值。

注意

如果你不是管理员,则必须在 HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\OSM 下编辑注册表。 这些更改可由位于 HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM 的策略设置覆盖。

HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM下的代理注册表设置

值名称 类型 值说明和数据 必需还是可选
enablelogging
REG_DWORD
启用运行时日志记录和静态扫描。 这允许代理收集数据。

值:

1 = 启用日志记录和代理
0 = 禁用日志记录和代理
默认值 = 0 (禁用日志记录 & 代理)
必需
enableupload
REG_DWORD
启用代理中的数据上传功能,以便代理可以定期将数据上传到 CommonFileShare 中指定的共享文件夹。

值:

0 = 不上载
1 = 上载
默认值 = 0(不上载)
必需
commonfileshare
REG_SZ
指定用于存储数据的共享文件夹的 UNC 路径。

值:

\\server\share
必需
tag1
tag2
tag3
tag4
REG_SZ
向代理发送的数据添加自定义标记。 如果启用此策略设置,则指定的自定义标记将显示在 Office 遥测仪表板中,你可以在其中按标记名称筛选收集的数据。 您可以将 tag1tag2tag3tag4 替换为自定义字符串,以分类和筛选收集到的数据(例如,将 tag1 替换为部门名称,将 tag2 替换为用户的位置等等)。

值:

tag1
tag2
tag3
tag4
可选
enablefileobfuscation
REG_DWORD
将代理配置为伪装或模糊处理数据中报告的某些文件属性。 如果启用此策略设置,代理会将 Office 文档的文件名、文件路径和标题模糊处理,然后再将数据上传到共享文件夹。 有关 Office 遥测仪表板的文件模糊处理和其他隐私设置的详细信息 ,请参阅管理 Office 遥测仪表板监视的数据的隐私

值:

0 = 不模糊化
1 = 模糊化
默认值 = 0(不模糊化)
可选
AgentInitWait
REG_DWORD
重要: 若要避免影响网络或客户端性能,请仅在测试环境中降低此值。

调整代理在扫描客户端并将数据上传到共享文件夹之前等待的时间。 如果此值不存在,则默认等待时间为 10 分钟 (600 秒) 。 在测试环境中,可以指定 1 秒,以消除使用 Service Pack 1 和更早版本的客户端测试 Windows 7 的延迟。 对于运行 Windows“8”的计算机,建议将此设置为至少 60 秒。

值:

x = 等待时间(秒)
可选
AgentRandomDelay
REG_DWORD
重要: 若要避免影响网络或客户端性能,请仅在测试环境中降低此值。

调整最大随机延迟(分钟)。 除了 AgentInitWait 值之外,代理在 0 到 AgentRandomDelay 分钟之间随机等待,然后开始扫描或上传数据。 如果此值不存在,代理将等待 0 分钟到 240 分钟。 在测试环境中,您可以指定 0 以消除测试的随机延迟。

值:

x = 随机延迟(分钟)
可选

HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM\preventedapplications下的代理注册表设置

值名称 值类型 值说明和数据 必需还是可选
accesssolution
olksolution
onenotesolution
pptsolution
projectsolution
publishersolution
visiosolution
wdsolution
xlsolution
REG_DWORD
防止将特定 Office 应用程序的数据报告到 Office 遥测仪表板。 有关此注册表设置的详细信息 ,请参阅管理 Office 遥测仪表板监视的数据的隐私

值:

1 = 阻止报告
0 = 允许报告
默认值 = 0(允许报告)
可选

HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM\preventedsolutiontypes下的代理注册表设置

值名称 值类型 值说明和数据 必需还是可选
agave
appaddins
comaddins
documentfiles
templatefiles
REG_DWORD
防止将特定解决方案的数据报告到 Office 遥测仪表板。 但是,仍然报告解决方案类型。 有关此注册表设置的详细信息 ,请参阅管理 Office 遥测仪表板监视的数据的隐私

值:

1 = 阻止报告
0 = 允许报告
默认值 = 0(允许报告)
可选

使用组策略启用和配置代理

还可以使用 组策略 来启用和配置代理。 从 Microsoft 下载中心下载适用于 Office 的管理模板文件 (ADMX/ADML) 。 下表中列出的策略设置位于 用户配置\策略\管理模板\Microsoft Office 2016\Telemetry 仪表板的路径中。

代理策略设置

设置名称 说明 必需还是可选
打开遥测数据收集
打开 Office 遥测仪表板和 Office 遥测日志使用的 Office 中的数据收集功能。 默认情况下,在 Office 中禁用数据收集。
必需
为 Office 遥测代理启用数据上传
启用代理中的数据上传功能,以便代理可以定期将数据上传到共享文件夹。 默认情况下禁用数据上载功能。
必需
指定存储 Office 遥测数据的 UNC 路径
指定代理将数据发送到的共享文件夹的统一命名约定 (UNC) 路径。
必需
指定 Office 遥测数据的自定义标签
向代理发送的数据添加自定义标记。 如果启用此策略设置,则指定的自定义标记将显示在 Office 遥测仪表板中,你可以在其中按标记名称筛选收集的数据。 您可以指定分类和筛选收集到的数据(例如,部门名称、用户职务等等)所需的任意字符串。
可选
在 Office 遥测代理中打开隐私设置
将代理配置为伪装或模糊处理数据中报告的某些文件属性。 如果启用此策略设置,代理会将 Office 文档的文件名、文件路径和标题模糊处理,然后再将数据上传到共享文件夹。

有关 Office 遥测仪表板的文件模糊处理和其他隐私设置的详细信息 ,请参阅管理 Office 遥测仪表板监视的数据的隐私
可选
要从 Office 遥测代理报告中排除的 Office 应用程序
防止将特定 Office 应用程序的数据报告到 Office 遥测仪表板。
可选
要从 Office 遥测代理报告中排除的 Office 解决方案
防止将特定 Office 解决方案的数据报告到 Office 遥测仪表板。
可选

手动触发数据收集

当用户登录到 Office 客户端时,代理将等待 10 分钟以允许完成其他登录过程,然后等待随机分钟数(最多 4 小时), (或为 AgentRandomDelay 注册表值设置的最大延迟) ,以避免客户端计算机同时将数据发送到网络。 在此初始扫描之后,代理每 8 小时扫描一次并收集数据。

如果要手动触发数据收集并看到立即上传到 Office 遥测仪表板的数据,请设置以下注册表值,如上表所述:

适用于运行具有 Service Pack 1 及更低版本的 Windows 7 的计算机

  • AgentInitWait:1

  • AgentRandomRelay:0

对于运行 Windows 8.1 及更高版本的计算机

由于用户在 Windows 8.1 及更高版本的 Microsoft Windows 中登录速度更快,因此我们建议将 AgentInitWait 设置为至少 60 秒,以确保在用户登录后网络连接准备就绪。

  • AgentInitWait:60

  • AgentRandomRelay:0

要手动触发扫描,请使用以下过程之一。

在 Windows 客户端上触发扫描和数据收集

  1. 确保计算机已连接到交流电源。

  2. 在客户端计算机的“任务计划程序”中,依次展开“任务计划程序库”、“Microsoft”,然后选择“Office”

  3. 右键单击“ OfficeTelemetryAgentLogOn”,然后选择“ 运行”。

有关 Office 遥测仪表板的常见问题

问: 如果客户端计算机断开连接一段时间,会发生什么情况?

答: 如果受监视的客户端断开连接,或者共享文件夹暂时不可用,则仍会在客户端本地收集数据。 恢复连接后,积压的信息将传递到共享文件夹。

问: 每次传输期间传输的数据量是多少?

答: 数量因使用的文件数和安装的解决方案数而异。 下面是代理为不同版本的 Office 发送的数据量估计值:

  • 早期版本的 Office 每次上传大约发送 50 KB。

  • Office 2013 及更高版本每次上传大约发送 64 KB 的数据。

当设置的时间间隔比默认值长时,或者本地计算机上的数据闲置较长时间时,传输量会更大。 请注意,不会传输实际文件内容;仅传输有关文件的元数据。

问: 安装和运行代理对性能有何影响?

答: 代理对用户是透明的,并执行影响较小的任务,例如检查 MRU 和特定本地注册表设置中的内容。 代理不会主动扫描文件。 代理负责监视电源状态和网络状态,以避免影响客户端性能。

问: 如何重新初始化代理?

答: 代理本地存储在客户端计算机上的 %localappdata%\Microsoft\Office\16.0\Telemetry。 可以删除此文件夹的内容以重新初始化计算机并启动新的发现。 请注意,这是每个用户的数据位置。

问: 数据发送到共享文件夹的频率如何?

答: 用户登录时,数据从客户端传输到共享文件夹,在用户登录时每隔 8 小时传输一次。 可以在任务计划程序中调整此间隔。

问: 收集的数据的格式是什么?

答: 收集的数据以二进制格式存储和传输,以优化存储和数据传输要求。

问: 如果在部署代理后更改自定义标签,何时会在数据库中更新新标签?

答: 只有“最近使用”列表中的文件才会在数据库中更新其标签。 代理下次发送使用情况数据时,将发生这种情况。 对于不在“最近使用”列表中的文件,它们将继续在数据库中显示旧标签,直到用户打开文件,代理上传使用情况数据。

解决 Office 遥测仪表板部署问题

下表描述了部署 Office 遥测仪表板及其组件后可能会遇到的一些症状。

解决 Office 遥测仪表板部署问题

问题 说明 解决方案
Office 遥测处理器设置 向导失败
向导失败并显示消息“遥测处理器设置向导只能在已加入域的计算机上运行。 将计算机加入域,然后再次运行向导。”
运行处理器、共享文件夹和 SQL 数据库的计算机必须加入域,以便配置相应的安全设置。 确保计算机位于受信任的域中。

可以使用博客文章在工作组或已加入域的计算机上快速设置 Office 遥测仪表板中所述的脚本,在单个 工作组计算机或已加入域的计算机上安装这些组件。
Office 遥测处理器设置 向导失败
处理器使用错误的SQL Server实例。
如果有两个或更多个SQL Server实例,请确保在处理器安装过程中使用格式 Servername\SQLServerinstance 指向正确的 SQL Server 实例。
Office 遥测仪表板未显示任何数据
代理未上传数据,并且Msoia.exe进程未在任务管理器中运行。
检查 CommonFileShare、EnableLogging 和 EnableUpload 注册表值的注册表路径和相应值。 本文前面的 启用和配置代理中介绍了这些内容。
Office 遥测仪表板未显示任何数据
代理未扫描或上传数据。 Msoia.exe 进程在任务管理器中运行了很长时间。
默认情况下,代理具有初始等待计时器和随机化功能,以避免与其他代理同时上传大量数据并影响网络带宽。 更新 AgentInitWait 和 AgentRandomDelay 注册表值可在测试环境中消除此延迟。 否则,上载过程最长可以延迟到 4 小时 10 分钟。 本文前面的 启用和配置代理中介绍了这些注册表值。 您可以在手动触发数据收集中了解如何触发扫描和上载过程。
Office 遥测仪表板未显示任何数据
代理不会上传数据。 Msoia.exe 进程在任务管理器中运行了很长时间。
验证代理与共享文件夹之间的网络连接。

验证计算机是否已加入域。 共享文件夹配置为仅允许通过域中身份验证的用户进行访问。

上传失败后,代理会继续尝试上传数据。 使用默认注册表值时,代理将继续作为进程在任务管理器中运行长达 4 小时 10 分钟, (最大) 。 若要调整注册表值,请参阅本文前面的 启用和配置代理。 您可以在手动触发数据收集中了解如何触发扫描和上载过程。
Office 遥测仪表板未显示任何数据
代理任务似乎不起作用。
检查任务计划程序中 “上次运行结果 ”列中的信息。 如果操作成功,将显示返回代码 0。 如果代理无法将数据上传到共享文件夹,“找不到网络名称”消息将显示在 “上次运行结果 ”列中。 这是代理在“ 上次运行结果 ”列中记录的唯一错误。 如果列出了其他错误,则这些错误是由其他原因引起的,或者计划的任务未运行。
Office 遥测仪表板未显示任何数据
处理器不工作。 共享文件夹中有许多文件夹和文件。
验证处理器与共享文件夹之间的网络连接。 处理器是由 Office 遥测处理器设置 向导配置的吗? 共享文件夹的权限可能会有所不同,具体取决于处理器位置和数据库。 从桌面上的快捷方式再次运行 Office 遥测处理器设置 向导。
Office 遥测仪表板未显示任何数据
处理器正在运行,但共享文件夹下的“失败”文件夹中有许多文件夹和文件。
处理器每分钟处理一次共享文件夹中的文件到数据库。 如果处理器三次无法处理文件,则会将失败的文件移动到“失败”文件夹。 有关详细信息,请参阅处理器日志 (%windows%\ServiceProfiles\NetworkService\AppData\Local\Temp\dperrorlog.txt) 。
Office 遥测仪表板未显示任何数据
由于SQL Server身份验证设置,处理器无法正常工作。
检查SQL Server的身份验证类型。 Office 遥测仪表板不支持 SQL 身份验证。 您必须使用 Windows 身份验证。
Office 遥测仪表板未显示任何数据
由于处理器和数据库之间的防火墙问题,处理器无法正常工作。
如果 Office 遥测仪表板和数据库之间有防火墙,请检查防火墙配置中是否启用了 SQL 端口。 SQL Server的默认端口为 1433。 有关详细信息 ,请参阅为数据库引擎访问配置 Windows 防火墙
Office 遥测仪表板未显示任何数据
由于处理器、数据库和 SQL Express 之间的防火墙问题,处理器无法正常工作。
如果 Office 遥测仪表板和数据库之间有防火墙,请检查防火墙配置中是否启用了 SQL 端口。 SQL Express 的默认端口不是固定值。 检查 SQL Configuration Manager中的端口号,并将端口添加到防火墙配置。 有关详细信息 ,请参阅为数据库引擎访问配置 Windows 防火墙
Office 遥测仪表板未显示任何数据
处理器不工作。
有关详细信息,请参阅处理器日志 (%windows%\ServiceProfiles\NetworkService\AppData\Local\Temp\dperrorlog.txt) 。
Office 遥测仪表板无法连接到数据库
Office 遥测仪表板显示一条错误消息,指出由于权限SQL Server,它无法连接到数据库。
检查 Office 遥测仪表板的权限角色。 使用 OSQL、SQLCMD、Enterprise Manager 或遥测仪表板管理工具 (Tdadm) 将用户添加到 td_readonly 角色。 有关详细信息,请参阅本文前面的 Office 遥测仪表板使用的数据库
Office 遥测仪表板无法连接到数据库
Office 遥测仪表板显示一条错误消息,指出它无法连接到数据库。
如果有两个或多个SQL Server实例,请确保 Office 遥测仪表板中的“数据连接设置”对话框使用格式为 Servername\SQLServerinstance 的正确SQL Server实例。
Office 遥测仪表板无法连接到数据库
Office 遥测仪表板显示一条错误消息,指出它无法连接到数据库。
如果SQL Server为 SQL Express,请确保SQL Server实例名称正确。 SQL Express 的默认实例名称不同于SQL Server,例如:Servername\SQLExpress
Office 遥测仪表板无法连接到数据库
Office 遥测仪表板显示一条错误消息,指出它无法连接到数据库。
例如,如果SQL Server默认排序规则区分大小写 (SQL Server的日语版本默认区分大小写) ,请确保在 Office 遥测仪表板的“数据连接设置”对话框中输入了区分大小写的数据库名称。