安装或启用 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:
- 必须已安装并配置Azure DevOps Server。 有关详细信息,请参阅 在本地安装和配置 Azure DevOps。
- 必须至少添加了一个项目集合。 若要添加项目集合,请参阅 管理项目集合。
- 若要启用、暂停、禁用或恢复 Analytics,你必须是具有“编辑集合级别信息”权限的 Project 集合管理员组组的成员。
对于 2019 Azure DevOps Server:
- 必须已安装并配置Azure DevOps Server。 有关详细信息,请参阅 在本地安装和配置 Azure DevOps。
- 必须至少添加了一个项目集合。 若要添加项目集合,请参阅 管理项目集合。
- 若要安装扩展,您必须是具有“编辑集合级别信息”权限的项目集合管理员组组的成员。如果没有权限,可以改为请求扩展。
- 若要上传扩展,你必须是具有“编辑实例级信息”权限的 Azure DevOps Server 管理员组的成员。
启用 Analytics
如果已升级到 Azure DevOps Server 2019.1,则可以使用以下步骤为项目集合启用 Analytics。 否则,对于 2019 Azure DevOps Server,请参阅安装 Analytics。
注意
系统会自动为所有新创建的项目集合启用分析。
在 Web 浏览器中,选择 (1) 项目集合, (2) 集合设置或管理员设置,然后 (3) Analytics。
选择 “启用分析”。
启用后,Analytics 过渡作业将开始填充 Analytics 数据表。 此过程可能需要一些时间,具体取决于集合的大小。 若要详细了解数据表,请参阅 分析数据模型。
暂停或禁用 Analytics
如果已升级到 Azure DevOps Server 2019.1,则可以使用以下步骤暂停或禁用项目集合的 Analytics。 否则,对于 2019 Azure DevOps Server,等效的操作是禁用或卸载 Analytics 扩展。
只能暂停或禁用以前已启用的分析。
在 “分析 设置”页中,选择“ 暂停分析 ”或 “禁用分析”。
确认要暂停或禁用该服务。
恢复分析
对于 2019.1 Azure DevOps Server,可以在暂停分析项目集合后恢复分析。 恢复服务将重新启用暂存作业,这将更新数据表并使它们成为最新的,从暂停时间开始更新。
在 “分析 设置”页中,选择“ 恢复分析”。
确认要恢复服务。
启用后,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 市场下载它。
在 Web 浏览器中,选择项目集合) (1, (2 个) 管理员设置,然后 (3 个) 扩展。
选择“ 浏览本地扩展”。
注意
从本地市场安装扩展与从托管市场安装相同。 唯一的区别是托管市场显示扩展分级和用户评论。
本地市场将在新的浏览器选项卡中打开。选择 Analytics 扩展卡。
选择“免费获取”。
选择项目集合,然后选择 “安装”。
安装完成后,你将看到类似于下面的映像。 选择“ 继续收集 ”以返回到集合的 Web 门户。
(可选)如果要在其他项目集合上安装 Analytics 扩展,请选择浏览器的“后退”按钮。
禁用或卸载 Analytics 扩展
如果选择禁用 Analytics 扩展,它将停止运行任何作业。 分析数据将不同步,关联的功能将不可用。 但是,不会删除任何数据。 卸载 Analytics 扩展会从 Analytics 数据库表中删除数据。 重新安装扩展后,将从头开始重新填充数据。
打开“扩展”菜单,然后选择“ 管理扩展”。
在“ 管理 ”选项卡中,打开扩展的快捷菜单。
根据需要选择 “禁用 ”或“ 卸载 ”。
如果从部署中删除了 Analytics 扩展,请还原
如果从部署中删除 Analytics 扩展,则可以从联机市场安装该扩展以还原它。 由于服务器设置,你可能无法使用联机市场。 例如,防火墙可能会阻止某些传出连接。 即使如此,也可以使用以下步骤将其还原到本地市场。
按照安装 Analytics 扩展部分中提供的说明打开集合设置。
选择“ 扩展”,然后选择 “浏览本地扩展”。
滚动到页面底部,然后选择“ 管理扩展”。
选择“ 上传扩展 ”,然后选择 “单击以上传”。 浏览到包含 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
。
相关文章
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈