洞察和分析
洞察和分析提供 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 型別(這因釋出商和映象而異)。