安装或启用 Analytics 服务

项目
07/19/2022

Azure DevOps Server 2020 |Azure DevOps Server 2019

对于 2020 Azure DevOps Server，Analytics 服务已正式发布。它会自动为添加到服务器的所有新项目集合启用。对于从以前的版本升级的项目集合，可能需要手动启用它。为要为其生成 Analytics 报表的每个项目集合启用 Analytics。

分析目前为预览版。在预览版中保留时，它是免费的。对于 Azure DevOps Server 2019，请从本地市场安装 Analytics 扩展。对于 Azure DevOps Server 2019.1，请启用 Analytics。为要为其生成 Analytics 报表的每个项目集合安装或启用 Analytics。

注意

TFS 2018 或更低版本 不支持 分析市场扩展和分析。

Analytics 支持访问项目集合中定义的所有项目的 Analytics 小组件。若要了解详细信息，请参阅“什么是分析”和 “基于分析”的小组件。

先决条件

对于 Azure DevOps Server 2019.1：

必须已安装并配置Azure DevOps Server。有关详细信息，请参阅安装和配置本地Azure DevOps。
必须至少添加一个项目集合。若要添加项目集合，请参阅 “管理项目集合”。
若要启用、暂停、禁用或恢复 Analytics，你必须是具有编辑集合级别信息权限 的Project集合管理员组组的成员。

对于 Azure DevOps Server 2019：

必须已安装并配置Azure DevOps Server。有关详细信息，请参阅安装和配置本地Azure DevOps。
必须至少添加一个项目集合。若要添加项目集合，请参阅 “管理项目集合”。
若要安装扩展，您必须是具有“编辑集合级别信息权限”的Project集合管理员组组的成员，否则可以请求扩展。
若要上传扩展，你必须是具有编辑实例级信息权限的Azure DevOps Server管理员组的成员。

启用分析

如果已升级到 Azure DevOps Server 2019.1，可以使用以下步骤为项目集合启用 Analytics。否则，对于 Azure DevOps Server 2019，请参阅“安装分析”。

注意

将自动为所有新建的项目集合启用分析。

在 Web 浏览器中，选择 (1) 项目集合， (2) 集合设置或管理员设置，然后 (3) Analytics。
选择“ 启用分析”。

启用后，Analytics 暂存作业开始填充 Analytics 数据表。此过程可能需要一些时间，具体取决于集合的大小。若要了解有关数据表的详细信息，请参阅 Analytics 数据模型。

暂停或禁用分析

如果已升级到 Azure DevOps Server 2019.1，可以使用以下步骤暂停或禁用项目集合的分析。否则，对于 Azure DevOps Server 2019，等效的操作是禁用或卸载 Analytics 扩展。

只能暂停或禁用以前启用的分析。

在 “分析 设置”页中，选择“ 暂停分析 ”或“ 禁用分析”。
确认要暂停或禁用服务。

恢复分析

对于 Azure DevOps Server 2019.1，可以在暂停项目集合后恢复 Analytics。恢复服务将重新启用暂存作业，该作业将更新数据表并使其保持最新状态，并在暂停后进行更新。

在 “分析 设置”页中，选择“ 恢复分析”。
确认要恢复服务。

启用后，Analytics 暂存作业开始填充 Analytics 数据表。此过程可能需要一些时间，具体取决于集合的大小。

如果暂停或禁用 Analytics，会发生什么情况？

暂停 Analytics 或禁用 Analytics 扩展 (2019) ，禁用以下功能：

暂停 Analytics 会保留数据，但停止暂存作业更新数据。稍后可以恢复服务，然后更新数据。

禁用 Analytics 或删除 Analytics 扩展 (2019) ，关闭所有 Analytics 暂存作业，并删除 Analytics 表中存储的分析数据。捕获历史趋势的所有 Analytics 数据都将丢失。它不会删除集合中存储的任何其他数据。不能撤消此操作。删除历史数据和趋势数据后，无法还原它。重新启用 Analytics 不会还原历史数据。

禁用或删除 Analytics 后，将执行以下操作：

不会运行过渡作业，Analytics 表不会更新信息。
删除表数据，如果重新启用 Analytics，则必须从头开始重新填充所有数据。

注意

在 Azure DevOps Server 2019.1 中禁用 Analytics 与卸载 Azure DevOps Server 2019 的 Analytics 扩展相同。

若要了解有关数据表的详细信息，请参阅 Analytics 数据模型。

安装 Analytics 扩展

如果尚未升级到 Azure DevOps Server 2019.1，可以安装 Analytics 扩展以获取对项目集合的分析小组件和报表的访问权限。 Analytics 扩展在本地安装程序中提供。安装扩展只是启用该功能。无需手动下载扩展文件才能安装。

提示

Analytics 扩展会显示在本地库中用于Azure DevOps Server，因此无需从Azure DevOps市场下载它。

在 Web 浏览器中，选择 (1) 项目集合， (2) 管理员设置，然后 (3) 扩展。
选择“ 浏览本地扩展”。

注意

从本地市场安装扩展与从托管市场安装相同。唯一的区别是托管市场显示扩展分级和用户注释。
本地市场将在新的浏览器选项卡中打开。选择 Analytics 扩展卡。
选择“Get it free”。
选择项目集合，然后选择“ 安装”。
安装完成后，你将看到类似于下面的映像。选择 “继续到集合”以 返回到集合的 Web 门户。

（可选）如果要在其他项目集合上安装 Analytics 扩展，请选择浏览器后退按钮。

禁用或卸载 Analytics 扩展

如果选择禁用 Analytics 扩展，它将停止任何作业运行。分析数据将不同步，关联的功能将不可用。但是，不会删除任何数据。卸载 Analytics 扩展会从 Analytics 数据库表中删除数据。重新安装扩展后，数据将从头开始重新填充。

打开扩展菜单，然后选择“ 管理扩展”。
在“ 管理 ”选项卡中，打开扩展的快捷菜单。
根据需要选择 “禁用 ”或 “卸载 ”。

如果从部署中删除，请还原 Analytics 扩展

如果从部署中删除 Analytics 扩展，可以从联机市场安装该扩展以还原该扩展。由于服务器设置，可能无法使用联机市场。例如，防火墙可能会阻止某些传出连接。即使出现这种情况，也可以使用以下步骤将其还原到本地市场。

按照“安装 Analytics 扩展”部分中提供的说明打开集合设置。

选择 “扩展”，然后选择 “浏览本地扩展”。
滚动到页面底部，然后选择“ 管理扩展”。
选择Upload扩展，然后选择单击以上传。浏览到包含 Microsoft.TeamFoundation.Extension.Analytics.vsix 文件的文件夹。

可以在应用程序层文件夹安装中找到 .vsix 文件，路径如下。

C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsix

上传扩展会将它还原到本地市场。可以从该集合中将其安装到集合。

如何确定服务器是否已断开连接？

如果服务器与 Internet 断开连接，则必须从本地市场安装 Analytics。

可以确定Azure DevOps Server是否处于断开连接状态。检查在浏览托管市场时连接的图标和服务器名称是否显示在顶部。

Determining if your server is connected or not

从本地服务器导航到市场时，如果未连接，则不会显示错误。它只需切换到云服务上下文。

已知问题

如果使用公共 URL 来安装扩展，例如 https://OnPrem.MyCompany.com，可能会收到回调错误，例如 TLS/SSL 错误。

若要解决此问题，可以从托管应用程序层的计算机安装扩展，并指向本地计算机 URL，例如 https://myMachineName。