安裝或啟用分析服務

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

針對 Azure DevOps Server 2020 和更新版本,分析服務已正式推出。 系統會自動為新增至伺服器的所有新專案集合啟用。 針對從舊版升級的專案集合,您可能需要 手動加以啟用。 您可以針對要為其產生分析報表的每個專案集合啟用 Analytics。

分析目前為 Azure DevOps Server 2019 預覽版。 針對 Azure DevOps Server 2019,您可以從本機市集安裝 Analytics 擴充功能,以取得您想要使用 Analytics 的每個專案集合。 針對 Azure DevOps Server 2019.1,您可以針對您想要使用 Analytics 的每個專案集合啟用 Analytics。 分析支援

注意

TFS 2018 或舊版 不支援 分析 Marketplace 擴充功能和分析。

分析支援存取專案集合中定義之所有專案的 Analytics 小工具。 若要深入瞭解,請參閱 什麼是分析?以分析為基礎的小工具。 Analytics 中可用的資料摘要說明 從 Analytics 取得的資料

先決條件

針對 Azure DevOps Server 2019.1:

針對 Azure DevOps Server 2019:

啟用分析

如果您已升級至 Azure DevOps Server 2019.1,您可以使用下列步驟為專案集合啟用 Analytics。 否則,如需 Azure DevOps Server 2019,請參閱安裝分析

注意

系統會自動為所有新建立的專案集合啟用分析。

  1. 從網頁瀏覽器中,選取 (1) 專案集合, (2) 集合設定管理員設定,然後 (3) Analytics

    開啟集合 > 管理員設定 > 分析

  2. 選取 [啟用分析]。

    啟用分析

    啟用之後,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,則必須從頭重新填入所有資料。

注意

在 Azure DevOps Server 2019.1 中停用 Analytics 與卸載 Azure DevOps Server 2019 的 Analytics 擴充功能相同。

若要深入瞭解資料表,請參閱 分析資料模型

安裝 Analytics 擴充功能

如果您尚未升級至 Azure DevOps Server 2019.1,您可以安裝 Analytics 擴充功能來存取專案集合的分析小工具與報表。 Analytics 擴充功能隨附于內部部署安裝程式內。 安裝擴充功能只會啟用功能。 不需要手動下載擴充功能檔案以安裝。

秘訣

Analytics 擴充功能會出現在本機資源庫中,Azure DevOps Server,因此不需要從 Azure DevOps Marketplace 下載。

  1. 從網頁瀏覽器中,選取 (1) 專案集合, (2) 管理員 設定,然後 (3) Extensions

    開啟集合 > 管理員設定 > 延伸模組

  2. 選取 [流覽本機擴充功能]。

    流覽本機市集

    注意

    從本機市集安裝擴充功能與從託管的市集安裝相同。 唯一的差異在於託管的市集會顯示延伸模組評等和使用者批註。

  3. 本機 Marketplace 會在新的瀏覽器索引標籤中開啟。選取 [分析擴充功能] 卡片。

    分析擴充功能卡片

  4. 選取 [免費取得]。

    分析 Marketplace 延伸模組的螢幕擷取畫面,選取 [免費取得]。

  5. 選取專案集合,然後選取 [ 安裝]。

    選取專案集合

  6. 安裝完成後,您會看到類似下面的映射。 選取 [繼續至集合 ] 以返回集合的入口網站。

    已安裝分析 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

    上傳擴充功能會將它還原至本機市集。 您可以從該處將它安裝到集合。

如何判斷您的伺服器是否已中斷連線?

如果您的伺服器與網際網路中斷連線,您必須從本機市集安裝 Analytics。

您可以判斷您的Azure DevOps Server是否處於中斷線上狀態。 查看流覽託管市集時,連線的圖示和伺服器名稱是否出現在頂端。

判斷伺服器是否已連線

當您從內部部署伺服器流覽至 Marketplace 時,如果未連線,就不會顯示錯誤。 它只會切換至雲端服務內容。

已知問題

如果您使用公用 URL 來安裝延伸模組,例如 https://OnPrem.MyCompany.com ,您可能會收到回呼錯誤,例如 TLS/SSL 錯誤。

若要解決此問題,您可以從裝載應用層的電腦安裝擴充功能,並指向本機電腦 URL,例如 https://myMachineName