通过

安装或启用 Analytics 服务

  • 项目

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

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

Analytics 为 Azure DevOps Server 2019 提供预览版。 对于 Azure DevOps Server 2019，需要 从本地市场安装 Analytics 扩展 ，以便使用 Analytics 的每个项目集合。 对于 Azure DevOps Server 2019.1，可为 要使用的分析的每个项目集合启用 Analytics 。 分析支持

注意

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

Analytics 支持访问项目集合中定义的所有项目的 Analytics 小组件。 有关详细信息，请参阅“什么是分析”和“基于分析”的小组件。 Analytics 中提供的数据汇总为 Analytics 提供的数据。

先决条件

对于 Azure DevOps Server 2019.1：

对于 Azure DevOps Server 2019：

启用分析

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

注意

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

  1. 在 Web 浏览器中，选择项目集合（1）、（2）集合设置或管理员设置，然后选择（3） 分析。

    打开集合>管理员设置>分析

  2. 选择“ 启用分析”。

    启用分析

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

暂停或禁用分析

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

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

  1. 在“分析设置”页中，选择“暂停分析”或“禁用分析”。

    暂停或禁用分析

  2. 确认要暂停或禁用服务。

    确认“暂停”对话框。 确认禁用

恢复分析

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

  1. 在“分析设置”页中，选择“恢复分析”。

    启用分析

  2. 确认要恢复服务。

    确认“恢复”对话框。

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

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

暂停分析或禁用 Analytics 扩展（2019），禁用以下功能：

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

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

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

  • 不会运行任何暂存作业，并且 Analytics 表不会包含更新的信息。
  • 删除表数据，如果重新启用 Analytics，则必须从头开始重新填充所有数据。

注意

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

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

安装 Analytics 扩展

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

提示

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

  1. 在 Web 浏览器中，选择项目集合（1）、（2） 管理设置，然后选择（3） 扩展。

    打开集合>管理员设置>扩展

  2. 选择“ 浏览本地扩展”。

    浏览本地市场

    注意

    从本地市场安装扩展与从托管市场安装相同。 唯一的区别是托管市场显示扩展分级和用户评论。

  3. 本地市场将在新的浏览器选项卡中打开。选择 Analytics 扩展卡。

    分析扩展卡

  4. 选择“免费获取”。

    分析市场扩展的屏幕截图，选择“免费获取”。

  5. 选择项目集合，然后选择“ 安装”。

    选择项目集合

  6. 安装完成后，会看到如下所示的映像。 选择 “继续到集合 ”以返回到集合的 Web 门户。

    已安装 Analytics Marketplace 扩展的屏幕截图，继续收集。

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

禁用或卸载 Analytics 扩展

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

  1. 打开扩展菜单，然后选择“ 管理扩展”。

    “管理扩展”选项卡的屏幕截图。

  2. 在“ 管理 ”选项卡中，打开扩展的快捷菜单。

  3. 根据需要选择“禁用”或“卸载”。

从部署中删除时还原 Analytics 扩展

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

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

    选择“扩展”，然后选择“浏览本地扩展”。

  2. 滚动到页面底部，然后选择“ 管理扩展”。

    管理扩展

  3. 选择“ 上传扩展 ”，然后选择 “单击以上传”。 浏览到包含 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 是否处于断开连接状态。 查看浏览托管市场时连接的图标和服务器名称是否显示在顶部。

确定服务器是否已连接

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

已知问题

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

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