Insights

Table of contents

Note

Insights requires a Docker Business subscription and administrators must enforce sign-in to ensure that users sign in with an account associated with their organization.

Insights helps administrators visualize and understand how Docker is used within their organizations. With Insights, administrators can ensure their teams are fully equipped to utilize Docker to its fullest potential, leading to improved productivity and efficiency across the organization.

Key benefits include:

  • Uniform working environment. Establish and maintain standardized configurations across teams.
  • Best practices. Promote and enforce usage guidelines to ensure optimal performance.
  • Increased visibility. Monitor and drive adoption of organizational configurations and policies.
  • Optimized license use. Ensure that developers have access to advanced features provided by a Docker subscription.

View Insights for organization users

  1. Go to the Admin Console and sign in to an account that is an organization owner.
  2. In the Admin Console, select your organization from the drop-down in the left navigation.
  3. Select Insights.
  4. On the Insights page, select the period of time for the data.

Note

Insights data is not real-time and is updated daily. At the top-right of the Insights page, view the Last updated date to understand when the data was last updated.

You can view data in the following charts:

Docker Desktop users

Track active Docker Desktop users in your domain, differentiated by license status. This chart helps you understand the engagement levels within your organization, providing insights into how many users are actively using Docker Desktop. Note that users who opt out of analytics aren't included in the active counts.

The chart contains the following data.

Data Description
Total active users The number of users that have actively used Docker Desktop and either signed in with a Docker account that has a license in your organization or signed in to a Docker account with an email address from a domain associated with your organization.

Users who don’t sign in to an account associated with your organization are not represented in the data. To ensure users sign in with an account associated with your organization, you can enforce sign-in.
Active with license The number of users that have actively used Docker Desktop and have signed in to a Docker account with a license in your organization.
Active without license The number of users that have actively used Docker Desktop, are linked to a Docker account with an email address from a domain associated with your organization, and don’t have a license assigned to their account.

Users without a license don’t receive the benefits of your subscription. You can use domain audit to identify users without a license. You can also use Just-in-Time provisioning or SCIM to help automatically provision users with a license. Note that when SSO is configured and enforced, active without license will be 0.
Users opted out of analytics The number of users that are a member of your organization that have opted out of sending analytics.

When users opt out of sending analytics, you won't see any of their data in Insights. To ensure that the data includes all users, you can use Settings Management to set analyticsEnabled for all your users.
Active users (graph) The view over time for total active users.

Builds

Monitor development efficiency and the time your team invests in builds with this chart. It provides a clear view of the build activity, helping you identify patterns, optimize build times, and enhance overall development productivity.

The chart contains the following data.

Data Description
Average build per user The average number of builds per active user. A build includes any time a user runs one of the following commands:
  • docker build
  • docker buildx b
  • docker buildx bake
  • docker buildx build
  • docker buildx f
  • docker builder b
  • docker builder bake
  • docker builder build
  • docker builder f
  • docker compose build
  • docker compose up --build
  • docker image build
Average build time The average build time per build.
Build success rate The percentage of builds that were successful out of the total number of builds. A successful build includes any build that exits normally.
Total builds (graph) The total number of builds separated into successful builds and failed builds. A successful build includes any build that exits normally. A failed build includes any build that exits abnormally.

Containers

View the total and average number of containers run by users with this chart. It lets you gauge container usage across your organization, helping you understand usage trends and manage resources effectively.

The chart contains the following data.

Data Description
Total containers run The total number of containers run by active users. Containers run include those run using the Docker Desktop graphical user interface, docker run, or docker compose.
Average number of containers run The average number of containers run per active user.
Containers run by active users (graph) The number of containers run over time by active users.

Docker Desktop usage

Explore Docker Desktop usage patterns with this chart to optimize your team's workflows and ensure compatibility. It provides valuable insights into how Docker Desktop is being utilized, enabling you to streamline processes and improve efficiency.

The chart contains the following data.

Data Description
Most used version The most used version of Docker Desktop by users in your organization.
Most used OS The most used operating system by users.
Versions by active users (graph) The number of active users using each version of Docker Desktop.

To learn more about each version and release dates, see the Docker Desktop release notes.
Interface by active users (graph) The number of active users grouped into the type of interface they used to interact with Docker Desktop.

A CLI user is any active user who has run a docker command. A GUI user is any active user who has interacted with the Docker Desktop graphical user interface.

Docker Hub images

Analyze image distribution activity with this chart and view the most utilized Docker Hub images within your domain. This information helps you manage image usage, ensuring that the most critical resources are readily available and efficiently used.

Note

Data for images is only for Docker Hub. Data for third-party registries and mirrors aren't included.

The chart contains the following data.

Data Description
Total pulled images The total number of images pulled by users from Docker Hub.
Total pushed images The total number of images pushed by users to Docker Hub.
Top 10 pulled images A list of the top 10 images pulled by users from Docker Hub and the number of times each image has been pulled.

Extensions

Monitor extension installation activity with this chart. It provides visibility into the Docker Desktop extensions your team are using, letting you track adoption and identify popular tools that enhance productivity.

The chart contains the following data.

Data Description
Percentage of org with extensions installed The percentage of users in your organization with at least one Docker Desktop extension installed.
Top 5 extensions installed in the organization A list of the top 5 Docker Desktop extensions installed by users in your organization and the number of users who have installed each extension.

Troubleshoot Insights

If you’re experiencing issues with data in Insights, consider the following solutions to resolve common problems.

  • Update users to the latest version of Docker Desktop.

    Data is not shown for users using versions 4.16 or lower of Docker Desktop. In addition, older versions may not provide all data. Ensure all users have installed the latest version of Docker Desktop.

  • Enable Send usage statistics in Docker Desktop for all your users.

    If users have opted out of sending usage statistics for Docker Desktop, then their usage data will not be a part of Insights. To manage the setting at scale for all your users, you can use Settings Management and enable the analyticsEnabled setting.

  • Ensure that users are using Docker Desktop and aren't using the standalone version of Docker Engine.

    Only Docker Desktop can provide data for Insights. If a user installs and uses Docker Engine outside of Docker Desktop, Docker Engine won't provide data for that user.

  • Ensure that users are signing in to an account associated with your organization.

    Users who don’t sign in to an account associated with your organization are not represented in the data. To ensure users sign in with an account associated with your organization, you can enforce sign-in.