Insights and analytics

All members of an organization have access to the analytics data. Members can access analytics data in the Docker Hub web interface or by using the DVP Data API. The following covers the web interface.

Available reports

The following reports may be available for download as CSV files:

• Summary
• Trends
• Technographic
• Technographic companies
• Tracked companies

The reports available for download may vary based on your organization's subscription. Contact your Docker sales representative or Docker for more information.

Summary report

The summary report provides high-level usage metrics aggregated across all your Docker Hub content, organized by namespace and repository. This report gives you a comprehensive overview of your image portfolio performance, helping you understand which repositories, tags, and specific image versions are most popular with your users.

You can use this report to answer questions like:

• Which of my repositories are getting the most usage?
• How do different image tags compare in terms of adoption?
• What's the ratio of actual downloads versus version checks across my portfolio?
• Which specific image digests are being pulled most frequently?
• How has overall usage changed over time for my entire image collection?

To access the report:

1. Sign in to Docker Hub.
2. Select My Hub in the top navigation.
3. Select your organization in the left navigation.
4. Select Analytics > Overview in the left navigation.
5. Download the report by doing one of the following:
   • Select Download Weekly Summary.
   • Select the Download Monthly Summary.
   • Expand the Summary reports for the year drop-down and then select Download report for the desired week or month.

The summary report is a CSV file that contains the following data points:

Trends report

The trends report helps you understand how adoption of your container images evolves over time. It provides visibility into pull activity across repositories and tags, enabling you to identify adoption patterns, version migration trends, and usage environments (e.g., local development, CI/CD, production).

You can use this report to answer questions like:

• Which versions are gaining or losing traction?
• Is a new release being adopted?
• How does usage vary across cloud providers?

To access the report:

1. Sign in to Docker Hub.
2. Select My Hub in the top navigation.
3. Select your organization in the left navigation.
4. Select Analytics > Trends in the left navigation.
5. Select DATA BY WEEK or DATA BY MONTH to choose the data granularity.
6. Select Download report for the desired week or month.

The trends report is a CSV file that contains the following data points:

Technographic report

The technographic report provides insights into how your Docker Verified Publisher (DVP) images are used alongside other container images in real-world technology stacks. This report helps you understand the technical ecosystem where your images operate and identify co-usage patterns with other images.

You can use this report to answer questions like:

• Which other images are commonly used together with your images?
• What percentage of your user base also uses specific complementary technologies?
• How many companies in your ecosystem use both your image and other popular images?
• What technology stacks are most popular among your users?

To access the report:

1. Sign in to Docker Hub.
2. Select My Hub in the top navigation.
3. Select your organization in the left navigation.
4. Select Analytics > Technographic in the left navigation.
5. Select DATA BY WEEK or DATA BY MONTH to choose the data granularity.
6. Select Download report for the desired week or month.

The technographic report is a CSV file that contains the following data points:

メモ

To protect user privacy and ensure statistical significance, the technographic report only includes image pairings that have at least 10 unique users. Personal, disposable, and university email domains are excluded from the company domain analysis.

Technographic companies report

The technographic companies report provides a detailed view of which specific companies (identified by their domains) are using your Docker Verified Publisher (DVP) images together with other container images. This report gives you visibility into the actual organizations adopting your technology stack combinations, enabling targeted business development and partnership opportunities.

You can use this report to answer questions like:

• Which companies are using my image alongside specific complementary technologies?
• What technology stacks are adopted by enterprise customers in my target market?
• Which organizations might be good candidates for partnership discussions?
• How can I identify potential customers who are already using related technologies?

To access the report:

1. Sign in to Docker Hub.
2. Select My Hub in the top navigation.
3. Select your organization in the left navigation.
4. Select Analytics > Technographic in the left navigation.
5. Select DATA BY WEEK or DATA BY MONTH to choose the data granularity.
6. Select Download report for the desired week or month.

The technographic companies report is a CSV file that contains the following data points:

Each row represents a unique combination of a company domain, your DVP image, and another image that were used together during the specified time period.

メモ

To protect privacy and ensure data quality, this report excludes personal email domains, disposable email services, and university domains. Only business and organizational domains are included in the analysis.

Tracked companies report

The tracked companies report provides detailed insights into how specific companies are using your Docker Verified Publisher (DVP) images. This report helps you understand usage patterns, deployment environments, and adoption trends across your customer base and potential prospects.

You can use this report to answer questions like:

• How are specific companies using my images across different environments?
• What deployment patterns do I see across local development, CI/CD, and production?
• Which companies are heavy users of my images?
• How does usage vary by geography and cloud providers for tracked companies?

To access the report:

1. Sign in to Docker Hub.
2. Select My Hub in the top navigation.
3. Select your organization in the left navigation.
4. Select Analytics > Tracked Companies in the left navigation.
5. Select DATA BY WEEK or DATA BY MONTH to choose the data granularity.
6. Select Download report for the desired week or month.

The tracked companies report is a CSV file that contains the following data points:

メモ

Use case inference is determined by analyzing user agent patterns and cloud service provider usage. Local development tools used on cloud infrastructure are reclassified as CI/CD, and CI/CD tools used on cloud infrastructure are reclassified as production to better reflect actual deployment patterns.

重要

The Legacy DVP program applies to existing customers who have not yet renewed to DVP Core. The DVP Legacy program is deprecated and will be retired. Contact your Docker sales representative or Docker for more information.

View the image's analytics data

You can find analytics data for your repositories on the Insights and analytics dashboard at the following URL: https://hub.docker.com/orgs/{namespace}/insights/images. The dashboard contains a visualization of the usage data and 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

情報

Hovering your cursor over the chart displays a tooltip, showing precise data for points in time.

Share analytics data

You can share the visualization with others using the Share icon at the top of the chart. This is a convenient way to share statistics with others in your organization.

Selecting the icon generates a link that's copied to your clipboard. The link preserves the display selections you made. When someone follows 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.

Extension analytics data

If you have published Docker Extensions in the Extension marketplace, you can also get analytics about your extension usage, available as CSV files. You can download extension CSV reports from the Insights and analytics dashboard at the following URL: https://hub.docker.com/orgs/{namespace}/insights/extensions. If your Docker namespace contains extensions known in the marketplace, you will see an Extensions tab listing CSV files for your extension(s).

Exporting analytics data

You can export the analytics data either from the web dashboard, or using the DVP Data API. 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 Sunday) or monthly format. Monthly data is available from the first day of the following calendar month. You can import this data into your own systems, or you can analyze it manually as a spreadsheet.

Export data

Export usage data for your organization's images using the Docker Hub website by following these steps:

1. Sign in to Docker Hub and select My Hub.

2. Choose your organization and select Analytics.

3. Set the time span for which you want to export analytics data.

   The downloadable CSV files for summary and raw data appear on the right-hand side.

   

Export data using the API

The HTTP API endpoints are available at: https://hub.docker.com/api/publisher/analytics/v1. Learn how to export data using the API in the DVP Data API documentation.

Data points

Export data in either raw or summary format. Each format contains different data points and with different structure.

The following sections describe the available data points for each format. The Date added column shows when the field was first introduced.

Image pulls raw data

The raw data format contains the following data points. Each row in the CSV file represents an image pull.

Image pulls summary data

There are two levels of summary data available:

• Repository-level, a summary of every namespace and repository
• Tag- or digest-level, a summary of every namespace, repository, and reference (tag or digest)

The summary data formats contain the following data points for the selected time span:

Image pulls action classification rules

An action represents the multiple request events associated with a docker pull. Pulls are grouped by category to make the data more meaningful for understanding user behavior and intent. The categories are:

• Version check
• Pull by tag
• Pull by digest

Automated systems frequently check for new versions of your images. Being able to distinguish between "version checks" in CI versus actual image pulls by a user grants you more insight into your users' behavior.

The following table describes the rules applied for determining intent behind pulls. To provide feedback or ask questions about these rules, fill out the Google Form.

Extension Summary data

There are two levels of extension summary data available:

• Core summary, with basic extension usage information: number of extension installs, uninstalls, and total install all times

The core-summary-data file contains the following data points for the selected time span:

• Premium summary, with advanced extension usage information: installs, uninstalls by unique users, extension opening by unique users.

The core-summary-data file contains the following data points for the selected time span:

Changes in data over time

The insights and analytics service is continuously improved to increase the value it brings to publishers. Some changes might include adding new data points, or improving existing data to make it more useful.

Changes in the dataset, such as added or removed fields, generally only apply from the date of when the field was first introduced, and going forward.

Refer to the tables in the Data points section to see from which date a given data point is available.