分析和分析資料

目錄

分析和分析資料提供 Docker Hub 上 Docker 驗證發佈者 (DVP) 和 Docker 贊助的開放原始碼 (DSOS) 映像檔的使用情況分析。這包括自助存取所需時間範圍內的映像檔和擴充功能使用情況指標。您也可以顯示按標籤或摘要提取映像檔的次數，並按地理位置、雲端提供商、用戶端等進行細分。

提示

前往 Docker 驗證發佈者計畫Docker 贊助的開放原始碼檢視映像檔的分析資料

您可以在以下 URL 的「分析和分析資料」儀表板中找到儲存庫的分析資料：https://hub.docker.com/orgs/{namespace}/insights/images。儀表板包含使用情況資料的可視化圖表和一個表格，您可以在其中將資料下載為 CSV 檔案。

若要檢視圖表中的資料

Insights and analytics chart visualization

提示

將游標懸停在圖表上會顯示工具提示，顯示時間點的精確資料。

分享分析資料

您可以使用圖表上方的「分享」圖示與他人分享視覺效果。這是與組織中的其他人分享統計資料的便捷方式。

Chart share icon

選擇圖示會產生複製到剪貼簿的連結。該連結會保留您所做的顯示選項。當有人點擊該連結時，系統會開啟「分析和分析資料」頁面，並顯示與您建立連結時設定相同的圖表。

擴充功能分析資料

如果您已在擴充功能市集中發佈 Docker 擴充功能，您也可以取得有關擴充功能使用情況的分析資料，這些資料以 CSV 檔案提供。您可以從以下 URL 的「分析和分析資料」儀表板下載擴充功能 CSV 報表：https://hub.docker.com/orgs/{namespace}/insights/extensions。如果您的 Docker 命名空間包含市集中已知的擴充功能，您將會看到一個「擴充功能」索引標籤，其中列出您的擴充功能的 CSV 檔案。

匯出分析資料

您可以從網路儀表板或使用 DVP 資料 API 匯出分析資料。組織的所有成員都可以存取分析資料。

資料可以下載的 CSV 檔案形式提供，格式為每週（星期一到星期日）或每月。每月資料可從下一個月的第一天開始提供。您可以將這些資料匯入您自己的系統，也可以手動將其作為試算表進行分析。

匯出資料

請按照下列步驟，使用 Docker Hub 網站匯出組織映像檔的使用情況資料

  1. 登入 Docker HubOrganization overview page, with the Insights and Analytics tab

  2. 設定您要匯出分析資料的時間範圍。

    摘要和原始資料的可下載 CSV 檔案會顯示在右側。

    Filtering options and download links for analytics data

使用 API 匯出資料

HTTP API 端點位於：https://hub.docker.com/api/publisher/analytics/v1。在 DVP 資料 API 文件 中瞭解如何使用 API 匯出資料。

資料點

以原始或摘要格式匯出資料。每種格式都包含不同的資料點和不同的結構。

以下章節說明每種格式的可用數據點。「新增日期」欄顯示欄位首次引入的時間。

映像檔提取原始資料

原始數據格式包含以下數據點。CSV 檔案中的每一行代表一次映像檔提取。

數據點說明新增日期
動作請求類型，請參閱動作分類規則。其中之一：pull_by_tag、pull_by_digest、version_check。2022 年 1 月 1 日
動作日期時間戳記的日期部分：YYYY-MM-DD。2022 年 1 月 1 日
國家/地區請求來源國家/地區。2022 年 1 月 1 日
摘要映像檔摘要。2022 年 1 月 1 日
HTTP 方法請求中使用的 HTTP 方法，詳情請參閱registry API 文件。2022 年 1 月 1 日
主機事件中使用的雲端服務供應商。2022 年 1 月 1 日
命名空間Docker 組織（映像檔命名空間）。2022 年 1 月 1 日
參考請求中使用的映像檔摘要或標籤。2022 年 1 月 1 日
儲存庫Docker 儲存庫（映像檔名稱）。2022 年 1 月 1 日
標籤（如有提供）僅在請求參考標籤時才可用的標籤名稱。2022 年 1 月 1 日
時間戳記請求的日期和時間：YYYY-MM-DD 00:00:00。2022 年 1 月 1 日
類型事件來源的產業。其中之一：business、isp、hosting、education、null。2022 年 1 月 1 日
使用者代理程式工具使用者用於提取映像檔的應用程式（例如，docker 或 containerd）。2022 年 1 月 1 日
使用者代理程式版本用於提取映像檔的應用程式版本。2022 年 1 月 1 日
網域請求來源網域，請參閱隱私權。2022 年 10 月 11 日
擁有者擁有儲存庫的組織名稱。2022 年 12 月 19 日

映像檔提取摘要資料

有兩個層級的摘要數據可用

  • 儲存庫層級，每個命名空間和儲存庫的摘要
  • 標籤或摘要層級，每個命名空間、儲存庫和參考（標籤或摘要）的摘要

摘要數據格式包含所選時間範圍內的以下數據點

數據點說明新增日期
唯一 IP 位址唯一 IP 位址的數量，請參閱隱私權。2022 年 1 月 1 日
依標籤提取依摘要或依標籤的 GET 請求。2022 年 1 月 1 日
依摘要提取依摘要的 GET 或 HEAD 請求，或依摘要的 HEAD 請求。2022 年 1 月 1 日
版本檢查依標籤的 HEAD 請求，後面未接著 GET 請求2022 年 1 月 1 日
擁有者擁有儲存庫的組織名稱。2022 年 12 月 19 日

映像檔提取動作分類規則

一個動作代表與 docker pull 相關聯的多個請求事件。提取會依類別分組，讓數據更有意義，以便了解使用者行為和意圖。類別如下：

  • 版本檢查
  • 依標籤提取
  • 依摘要提取

自動化系統會頻繁檢查映像檔的新版本。能夠區分 CI 中的「版本檢查」與使用者實際提取映像檔，讓您更深入地了解使用者的行為。

下表說明用於判斷提取背後意圖的規則。要提供意見回饋或詢問有關這些規則的問題，請填寫 Google 表單。

起始事件參考後接結果動作使用案例備註
HEAD標籤無版本檢查版本檢查使用者本地機器上已存在所有層
GET標籤無依標籤提取標籤
GET標籤依標籤提取依標籤提取使用者本地機器上已存在所有層，及/或影像是單架構依不同摘要取得
HEAD標籤依摘要提取依標籤提取影像是多架構第二次依摘要的 GET 請求必須與第一次不同。
HEAD標籤依相同摘要取得依標籤提取使用者本地機器上已存在所有層，及/或影像是單架構依摘要提取
HEAD標籤影像是多架構，但本地機器上已存在部分或所有影像層依標籤提取使用者本地機器上已存在所有層，及/或影像是單架構依標籤的 HEAD 請求會傳送最新的摘要，後續的 GET 請求必須使用相同的摘要。如果影像是多架構，可能會發生額外的 GET 請求（請參閱此表中的下一行）。如果使用者不想要最新的摘要，則使用者會執行依摘要的 HEAD 請求。
GET依相同摘要取得，然後第二次依不同摘要取得無依摘要提取標籤
HEAD依相同摘要取得，然後第二次依不同摘要取得無依摘要提取依摘要提取
GET依相同摘要取得，然後第二次依不同摘要取得依標籤的 HEAD 請求會傳送最新的摘要，後續的 GET 請求必須使用相同的摘要。由於影像是多架構，因此會第二次依不同摘要取得。如果使用者不想要最新的摘要，則使用者會執行依摘要的 HEAD 請求。依摘要提取使用者本地機器上已存在所有層，及/或影像是單架構HEAD
HEAD依相同摘要取得，然後第二次依不同摘要取得依摘要提取依摘要提取摘要
HEAD依相同摘要取得，然後第二次依不同摘要取得影像是多架構，但本地機器上已存在部分或所有影像層無使用者本地機器上已存在所有層，及/或影像是單架構

擴充功能摘要資料

版本檢查

  • 使用者本地機器上已存在所有層

GET

數據點說明新增日期
摘要依不同摘要取得依摘要提取
第二次依摘要的 GET 請求必須與第一次不同。依相同摘要取得依摘要提取
依摘要提取影像是單架構及/或影像是多架構，但本地機器上已存在部分影像依摘要提取
有兩個層級的擴充功能摘要數據可用核心摘要，包含基本的擴充功能使用資訊：擴充功能安裝次數、解除安裝次數和總安裝次數依摘要提取
核心摘要數據檔案包含所選時間範圍內的以下數據點安裝次數依摘要提取
  • 擴充功能的安裝次數

GET

數據點說明新增日期
摘要依不同摘要取得依摘要提取
2024 年 2 月 1 日總安裝次數依摘要提取
依摘要提取影像是單架構及/或影像是多架構，但本地機器上已存在部分影像依摘要提取
擴充功能的總安裝次數解除安裝次數依摘要提取
用法擴充功能的解除安裝次數依摘要提取
總解除安裝次數擴充功能的總解除安裝次數依摘要提取

資料隨時間的變化

洞察分析服務會持續改進，以提高其為發布者帶來的價值。某些變更可能包括新增數據點，或改進現有數據以使其更有用。

數據集的變更（例如新增或移除的欄位）通常僅適用於欄位首次引入的日期及之後。

請參閱數據點章節中的表格，以查看特定數據點可用的日期。

隱私權

本章節包含有關隱私保護措施的資訊，可確保 Docker Hub 上內容的消費者完全匿名。

重要

Docker 永遠不會將任何個人識別資訊 (PII) 作為分析數據的一部分進行分享。

映像檔提取摘要數據集包含唯一 IP 位址計數。此數據點僅包含請求映像檔的不同唯一 IP 位址的數量。個別 IP 位址永遠不會被分享。

映像檔提取原始數據集包含使用者 IP 網域作為數據點。這是與用於提取映像檔的 IP 位址相關聯的網域名稱。如果 IP 類型為 business，則網域代表與該 IP 位址關聯的公司或組織（例如，docker.com）。對於任何其他非 business 的 IP 類型，網域代表用於發出請求的網際網路服務供應商或代管服務供應商。平均而言，只有大約 30% 的提取被歸類為 business IP 類型（這在發布者和映像檔之間有所不同）。