洞察與分析
洞察與分析為 Docker Hub 上的 Docker 驗證發行者 (DVP) 和 Docker 贊助開源 (DSOS) 映像提供使用分析。這包括自助存取指定時間範圍內的映像和擴充功能使用指標。您還可以顯示依標籤或依摘要的映像拉取次數，並取得依地理位置、雲端供應商、用戶端等細項分析。
提示前往 Docker 驗證發行者計畫 或 Docker 贊助開源 頁面，以了解更多有關這些計畫的資訊。
檢視映像的分析資料
您可以在以下網址的洞察與分析儀表板上找到您儲存庫的分析資料：https://hub.docker.com/orgs/{namespace}/insights/images。該儀表板包含使用資料的視覺化呈現，以及一個您可以將資料下載為 CSV 檔案的表格。
在圖表中檢視資料
- 選擇資料粒度：每週或每月
- 選擇時間間隔：3、6 或 12 個月
- 在清單中選擇一個或多個儲存庫
提示將游標懸停在圖表上會顯示工具提示，顯示特定時間點的精確資料。
分享分析資料
您可以使用圖表上方的分享圖示與他人分享視覺化內容。這是一種方便的方式，可以與您組織中的其他人分享統計資料。
選擇此圖示會產生一個連結並複製到您的剪貼簿。該連結會保留您所做的顯示選擇。當有人點擊該連結時，洞察與分析頁面將會開啟，並顯示與您建立連結時設定的相同圖表組態。
擴充功能分析資料
如果您已在擴充功能市集發布 Docker 擴充功能，您還可以取得有關擴充功能使用情況的分析資料，並以 CSV 檔案形式提供。您可以從以下網址的洞察與分析儀表板下載擴充功能 CSV 報告：https://hub.docker.com/orgs/{namespace}/insights/extensions。如果您的 Docker 命名空間包含市集上已知的擴充功能，您將會看到一個擴充功能分頁，其中列出您擴充功能的 CSV 檔案。
匯出分析資料
您可以透過網路儀表板或使用 DVP 資料 API 匯出分析資料。組織的所有成員都可以存取分析資料。
資料以可下載的 CSV 檔案形式提供，格式為每週 (週一至週日) 或每月。每月資料從下一個日曆月的第一天開始提供。您可以將這些資料匯入您自己的系統，或者您可以手動將其作為試算表進行分析。
匯出資料
使用 Docker Hub 網站匯出您組織映像的使用資料，請按照以下步驟操作
登入 Docker Hub 並選擇我的 Hub。
選擇您的組織並選擇分析。
設定您要匯出分析資料的時間範圍。
摘要和原始資料的可下載 CSV 檔案會顯示在右側。
使用 API 匯出資料
HTTP API 端點位於：https://hub.docker.com/api/publisher/analytics/v1。了解如何使用 API 匯出資料，請參閱 DVP 資料 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 | tag | N/A | 版本檢查 | 使用者本機上已存在所有層 | 這類似於依標籤拉取的使用案例，當使用者本機上已存在所有映像層時，然而，它區分了使用者意圖並據此分類。 |
| GET | tag | N/A | 依標籤拉取 | 使用者本機上已存在所有層，和/或映像為單架構 | |
| GET | tag | 依不同摘要取得 | 依標籤拉取 | 映像為多架構 | 第二次依摘要的 GET 請求必須與第一次不同。 |
| HEAD | tag | 依相同摘要取得 | 依標籤拉取 | 映像為多架構，但部分或所有映像層已存在於本機上 | 依標籤的 HEAD 請求會傳送最新的摘要，後續的 GET 請求必須是該相同摘要。如果映像是多架構，可能會發生額外的 GET 請求 (請參閱此表的下一列)。如果使用者不想要最新的摘要，則使用者會執行依摘要的 HEAD 請求。 |
| HEAD | tag | 依相同摘要的 GET 請求，然後第二次依不同摘要的 GET 請求 | 依標籤拉取 | 映像為多架構 | 依標籤的 HEAD 請求會傳送最新的摘要，後續的 GET 請求必須是該相同摘要。由於映像是多架構，因此有第二次依不同摘要的 GET 請求。如果使用者不想要最新的摘要，則使用者會執行依摘要的 HEAD 請求。 |
| HEAD | tag | 依相同摘要的 GET 請求，然後第二次依不同摘要的 GET 請求 | 依標籤拉取 | 映像為多架構 | 依標籤的 HEAD 請求會傳送最新的摘要，後續的 GET 請求必須是該相同摘要。由於映像是多架構，因此有第二次依不同摘要的 GET 請求。如果使用者不想要最新的摘要，則使用者會執行依摘要的 HEAD 請求。 |
| GET | 摘要 | N/A | 依摘要拉取 | 使用者本機上已存在所有層，和/或映像為單架構 | |
| HEAD | 摘要 | N/A | 依摘要拉取 | 使用者本機上已存在所有層 | |
| GET | 摘要 | 依不同摘要取得 | 依摘要拉取 | 映像為多架構 | 第二次依摘要的 GET 請求必須與第一次不同。 |
| HEAD | 摘要 | 依相同摘要取得 | 依摘要拉取 | 映像為單架構和/或映像為多架構但部分映像已存在於本機上 | |
| HEAD | 摘要 | 依相同摘要的 GET 請求，然後第二次依不同摘要的 GET 請求 | 依摘要拉取 | 映像為多架構 |
擴充功能摘要資料
擴充功能摘要資料有兩個級別可用
- 核心摘要，包含基本擴充功能使用資訊：擴充功能安裝次數、解除安裝次數，以及總安裝次數 (所有時間)
核心摘要資料檔案包含所選時間範圍的以下資料點
| 資料點 | 描述 | 新增日期 |
|---|---|---|
| 安裝次數 | 擴充功能的安裝次數 | 2024 年 2 月 1 日 |
| 總安裝次數 | 擴充功能的所有時間總安裝次數 | 2024 年 2 月 1 日 |
| 解除安裝次數 | 擴充功能的解除安裝次數 | 2024 年 2 月 1 日 |
| 總解除安裝次數 | 擴充功能的所有時間總解除安裝次數 | 2024 年 2 月 1 日 |
| 更新 | 擴充功能的更新次數 | 2024 年 2 月 1 日 |
- 進階摘要，包含進階擴充功能使用資訊：獨立使用者安裝、解除安裝次數，獨立使用者開啟擴充功能次數。
核心摘要資料檔案包含所選時間範圍的以下資料點
| 資料點 | 描述 | 新增日期 |
|---|---|---|
| 安裝次數 | 擴充功能的安裝次數 | 2024 年 2 月 1 日 |
| 獨立安裝次數 | 安裝擴充功能的獨立使用者數量 | 2024 年 2 月 1 日 |
| 解除安裝次數 | 擴充功能的解除安裝次數 | 2024 年 2 月 1 日 |
| 獨立解除安裝次數 | 解除安裝擴充功能的獨立使用者數量 | 2024 年 2 月 1 日 |
| 使用方式 | 擴充功能分頁開啟次數 | 2024 年 2 月 1 日 |
| 獨立使用者 | 開啟擴充功能分頁的獨立使用者數量 | 2024 年 2 月 1 日 |
資料隨時間的變化
洞察與分析服務正在持續改進中，以提高其對發行者的價值。部分變更可能包括新增資料點，或改進現有資料以使其更有用。
資料集中的變更，例如新增或移除的欄位，通常僅從該欄位首次引入之日起生效，並持續向前。
請參閱 資料點部分的表格，以了解特定資料點從何時開始提供。
隱私權
本節包含有關隱私保護措施的資訊，這些措施可確保 Docker Hub 上的內容消費者保持完全匿名。
重要Docker 絕不會分享任何個人身份資訊 (PII) 作為分析資料的一部分。
映像拉取摘要資料集包含獨立 IP 位址計數。此資料點僅包含請求映像的獨立 IP 位址數量。絕不會分享個別 IP 位址。
映像拉取原始資料集包含使用者 IP 網域作為資料點。這是與用於拉取映像的 IP 位址相關聯的網域名稱。如果 IP 類型為 business，則該網域代表與該 IP 位址相關聯的公司或組織 (例如 docker.com)。對於任何非 business 的 IP 類型，該網域代表用於發出請求的網際網路服務供應商或託管供應商。平均而言，只有約 30% 的所有拉取被歸類為 business IP 類型 (此比例因發行者和映像而異)。