dvp: describe chart vizualization of analytics data (#16117)

Signed-off-by: David Karlsson <david.karlsson@docker.com>
This commit is contained in:
David Karlsson 2022-11-09 11:09:14 +01:00 committed by GitHub
parent d039f2e4b9
commit ffee3d5dc4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 44 additions and 9 deletions

View File

@ -1711,7 +1711,7 @@ manuals:
- path: /docker-hub/publish/ - path: /docker-hub/publish/
title: Overview title: Overview
- path: /docker-hub/publish/insights-analytics/ - path: /docker-hub/publish/insights-analytics/
title: Insights & analytics title: Insights and analytics
- path: /docker-hub/publish/publisher-center-migration/ - path: /docker-hub/publish/publisher-center-migration/
title: Migrate content from the Publisher Center title: Migrate content from the Publisher Center
- path: /docker-hub/release-notes/ - path: /docker-hub/release-notes/

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 240 KiB

View File

@ -1,5 +1,5 @@
--- ---
title: Insights & analytics title: Insights and analytics
description: Provides usage statistics of your images on Docker Hub. description: Provides usage statistics of your images on Docker Hub.
keywords: docker hub, hub, insights, analytics, api, verified publisher keywords: docker hub, hub, insights, analytics, api, verified publisher
--- ---
@ -10,17 +10,53 @@ to metrics as both raw data and summary data for a desired time span. You can
view number of image pulls by tag or by digest, and get breakdowns by view number of image pulls by tag or by digest, and get breakdowns by
geolocation, cloud provider, client, and more. geolocation, cloud provider, client, and more.
## View the analytics data
Analytics data for your repositories is available on the **Insights and
analytics** dashboard at the following URL:
`https://hub.docker.com/orgs/{namespace}/insights`. The dashboard contains a
chart visualization of the usage data, as well as a table where you can download
the data as CSV files.
To view data in the chart:
- Select the data granularity: weekly or monthly
- Select the time interval: 3, 6, or 12 months
- Select one or more repositories in the list.
You can filter the list by repository name.
![Insights and analytics chart visualization](./images/chart.png)
> **Tip**
>
> Hovering your cursor over the chart displays a tooltip, showing precise data
> for points in time.
{: .tip }
### Share
You can share the visualization chart with others using the share icon located
just above the chart:
![Chart share icon](./images/chart-share-icon.png)
Selecting the icon generates a link that gets copied to your clipboard. The link
preserves the display selections you've made. When someone uses the link, the
**Insights and analytics** page opens and displays the chart with the same
configuration as you had set up when creating the link. This is a convenient way
to quickly share statistics with others in your organization.
## Exporting analytics data ## Exporting analytics data
You can access the data either from the Docker Hub website, at You can export the analytics data either from the web dashboard, or using the
`hub.docker.com/orgs/{namespace}/insights`, or using the
[DVP Data API](/docker-hub/api/dvp/){: target="_blank" rel="noopener" [DVP Data API](/docker-hub/api/dvp/){: target="_blank" rel="noopener"
class="_"}. All members of an organization have access to the analytics data. class="_"}. All members of an organization have access to the analytics data.
The data is available as a downloadable CSV file, in a weekly (Monday through The data is available as a downloadable CSV file, in a weekly (Monday through
Sunday) or monthly format (available on the first day of the following calendar Sunday) or monthly format. Monthly data is available from the first day of the
month). You can import this data into your own systems, or you can analyze it following calendar month. You can import this data into your own systems, or you
manually as a spreadsheet. can analyze it manually as a spreadsheet.
### Export data using the website ### Export data using the website
@ -156,8 +192,7 @@ consumers of content on Docker Hub remain completely anonymous.
> **Important** > **Important**
> >
> Docker never shares any Personally Identifiable Information (PII) as part of > Docker never shares any Personally Identifiable Information (PII) as part of
> analytics data. > analytics data. {: .important }
{: .important }
The summary dataset includes Unique IP address count. This data point only The summary dataset includes Unique IP address count. This data point only
includes the number of distinct unique IP addresses that request an image. includes the number of distinct unique IP addresses that request an image.