洞察和分析
洞察和分析提供 Docker Hub 上 Docker 驗證釋出商 (DVP) 和 Docker 贊助開源 (DSOS) 映象的使用情況分析。這包括對所需時間範圍內的映象和擴充套件使用指標的自助訪問。你還可以按標籤或摘要顯示映象拉取次數，並按地理位置、雲提供商、客戶端等獲取細分資料。
提示請前往Docker 驗證釋出商計劃或Docker 贊助開源頁面瞭解更多關於這些計劃的資訊。
檢視映象的分析資料
你可以在以下 URL 的洞察和分析儀表板上找到倉庫的分析資料：https://hub.docker.com/orgs/{namespace}/insights/images。該儀表板包含使用資料的視覺化以及一個可以下載 CSV 格式資料的表格。
在圖表中檢視資料
- 選擇資料粒度：每週或每月
- 選擇時間間隔：3、6 或 12 個月
- 在列表中選擇一個或多個倉庫
提示將滑鼠懸停在圖表上會顯示一個工具提示，顯示時間點的精確資料。
分享分析資料
你可以使用圖表上方的分享圖示與他人分享視覺化資料。這是與組織內其他人分享統計資料的一種便捷方式。
選擇該圖示會生成一個連結並複製到剪貼簿。該連結會保留你所做的顯示選擇。當有人點選該連結時，洞察和分析頁面會開啟，並以你建立連結時設定的相同配置顯示圖表。
擴充套件分析資料
如果你在擴充套件市場中釋出了 Docker 擴充套件，你還可以獲取有關擴充套件使用情況的分析資料，這些資料以 CSV 檔案的形式提供。你可以從以下 URL 的洞察和分析儀表板下載擴充套件 CSV 報告：https://hub.docker.com/orgs/{namespace}/insights/extensions。如果你的 Docker 名稱空間包含市場中已知的擴充套件，你將看到一個擴充套件選項卡，其中列出了你的擴充套件的 CSV 檔案。
匯出分析資料
你可以從 Web 儀表板或使用DVP 資料 API匯出分析資料。組織的所有成員都可以訪問分析資料。
資料以可下載的 CSV 檔案形式提供，格式為每週（週一至週日）或每月。每月資料從下一個日曆月的第一天開始提供。你可以將此資料匯入你自己的系統，也可以手動將其作為電子表格進行分析。
匯出資料
按照以下步驟使用 Docker Hub 網站匯出你組織映象的使用資料
登入 Docker Hub 並選擇我的 Hub。
選擇你的組織並選擇分析。
設定要匯出分析資料的時間跨度。
摘要和原始資料的可下載 CSV 檔案會顯示在右側。
使用 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 方法，詳情請參閱登錄檔 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 | 不適用 | 版本檢查 | 使用者本地機器上已存在所有層 | 這類似於使用者本地已存在所有映象層時的按標籤拉取用例，但它區分了使用者意圖並進行了相應分類。 |
| GET | tag | 不適用 | 按標籤拉取 | 使用者本地機器上已存在所有層和/或映象為單架構 | |
| GET | tag | 按不同摘要獲取 | 按標籤拉取 | 映象為多架構 | 第二次按摘要 GET 必須與第一次不同。 |
| HEAD | tag | 按相同摘要 GET | 按標籤拉取 | 映象為多架構，但部分或所有映象層已存在於本地機器上 | 按標籤的 HEAD 會發送最新的摘要，後續的 GET 必須是相同的摘要。如果映象為多架構，可能會發生額外的 GET（請參閱此表中的下一行）。如果使用者不想要最新的摘要，則使用者會執行按摘要的 HEAD。 |
| HEAD | tag | 按相同摘要 GET，然後按不同摘要進行第二次 GET | 按標籤拉取 | 映象為多架構 | 按標籤的 HEAD 傳送最新的摘要，後續的 GET 必須是相同的摘要。由於映象為多架構，因此會按不同的摘要進行第二次 GET。如果使用者不想要最新的摘要，則使用者會執行按摘要的 HEAD。 |
| HEAD | tag | 按相同摘要 GET，然後按不同摘要進行第二次 GET | 按標籤拉取 | 映象為多架構 | 按標籤的 HEAD 傳送最新的摘要，後續的 GET 必須是相同的摘要。由於映象為多架構，因此會按不同的摘要進行第二次 GET。如果使用者不想要最新的摘要，則使用者會執行按摘要的 HEAD。 |
| GET | 摘要 | 不適用 | 按摘要拉取 | 使用者本地機器上已存在所有層和/或映象為單架構 | |
| HEAD | 摘要 | 不適用 | 按摘要拉取 | 使用者本地機器上已存在所有層 | |
| GET | 摘要 | 按不同摘要獲取 | 按摘要拉取 | 映象為多架構 | 第二次按摘要 GET 必須與第一次不同。 |
| HEAD | 摘要 | 按相同摘要 GET | 按摘要拉取 | 映象為單架構和/或映象為多架構但部分映象已存在於本地機器上 | |
| 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 型別（這因釋出商和映象而異）。