安装或启用 Analytics 服务

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

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

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

注意

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

Analytics 支持访问项目集合中定义的所有项目的 Analytics 小组件。 若要了解详细信息,请参阅 什么是分析?基于分析的小组件。 Analytics 中可用的数据汇总在 Analytics 提供的数据中。

先决条件

对于 2019.1 Azure DevOps Server:

对于 2019 Azure DevOps Server:

启用 Analytics

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

注意

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

  1. 在 Web 浏览器中,选择 (1) 项目集合, (2) 集合设置管理员设置,然后 (3) Analytics

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

  2. 选择 “启用分析”。

    启用 Analytics

    启用后,Analytics 过渡作业将开始填充 Analytics 数据表。 此过程可能需要一些时间,具体取决于集合的大小。 若要详细了解数据表,请参阅 分析数据模型

暂停或禁用 Analytics

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

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

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

    暂停或禁用分析

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

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

恢复分析

对于 2019.1 Azure DevOps Server,可以在暂停分析项目集合后恢复分析。 恢复服务将重新启用暂存作业,这将更新数据表并使它们成为最新的,从暂停时间开始更新。

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

    启用 Analytics

  2. 确认要恢复服务。

    “确认恢复”对话框。

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

如果暂停或禁用 Analytics,会发生什么情况?

暂停分析或禁用分析扩展 (2019) ,将禁用以下功能:

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

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

禁用或删除 Analytics 后,将执行以下操作:

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

注意

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

若要详细了解数据表,请参阅 分析数据模型

安装 Analytics 扩展

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

提示

Azure DevOps Server的本地库中显示 Analytics 扩展,因此无需从 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. 按照安装 Analytics 扩展部分中提供的说明打开集合设置

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

  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是否处于断开连接状态。 查看浏览托管市场时,连接图标和服务器名称是否显示在顶部。

确定服务器是否已连接

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

已知问题

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

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