From 5385b563679d7f564be0e9ff2932a233fa134cc0 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Tue, 24 Jun 2025 14:42:52 -0400 Subject: [PATCH 1/2] admin: add export section to insights docs --- .../manuals/admin/organization/insights.md | 66 ++++++++++++++----- hugo_stats.json | 3 + 2 files changed, 54 insertions(+), 15 deletions(-) diff --git a/content/manuals/admin/organization/insights.md b/content/manuals/admin/organization/insights.md index 187f0c57e404..21ce30fa3d4c 100644 --- a/content/manuals/admin/organization/insights.md +++ b/content/manuals/admin/organization/insights.md @@ -34,11 +34,12 @@ To access Insights, you must contact your Customer Success Manager to have the feature enabled. Once the feature is enabled, access Insights using the following steps: -1. Go to the [Admin Console](https://app.docker.com/admin/) and sign in to an - account that is an organization owner. -2. Select your company on the **Choose profile** page. -3. Select **Insights**. -4. On the **Insights** page, select the period of time for the data. +1. Open [Docker Home](https://app.docker.com/) and select your organization +on the **Choose profile** page. +1. Select **Admin Console** in the left-hand navigation menu. +1. Select **Desktop insights**. +1. Choose a timeframe for your insights data: **1 Week**, **1 Month**, or +**3 Months**. > [!NOTE] > @@ -63,7 +64,7 @@ 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. +The chart contains the following data: | Data | Description | |:-----------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -79,7 +80,7 @@ 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. +The chart contains the following data: | Data | Description | |:-----------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -94,7 +95,7 @@ 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. +The chart contains the following data: | Data | Description | |:---------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -109,7 +110,7 @@ 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. +The chart contains the following data: | Data | Description | |:----------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| @@ -126,10 +127,11 @@ 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. +The chart contains the following data: | Data | Description | |:---------------------|:----------------------------------------------------------------------------------------------------------------| @@ -143,26 +145,60 @@ 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. +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. | +## Export Docker Desktop user data + +You can export Docker Desktop user data as a CSV file: + +1. Open [Docker Home](https://app.docker.com) and select your organization +on the **Choose profile** page. +1. Select **Admin Console** in the left-hand navigation menu. +1. Select **Desktop insights**. +1. Choose a timeframe for your insights data: **1 Week**, **1 Month**, or +**3 Months**. +1. Select **Export** and choose **Docker Desktop users** from the drop-down. + +Your export will automatically download. Open the file to view +the export data. + +### Understanding export data + +A Docker Desktop user export file contains the following data points: + +- **Name**: User's name +- **Username**: User's Docker ID +- **Email**: User's email address associated with their Docker ID +- **Type**: User type +- **Role**: User [role](/manuals/security/for-admins/roles-and-permissions.md) +- **Teams**: Team(s) within your organization the user is a +member of +- **Date Joined**: The date the user joined your organization +- **Last Logged-In Date**: The last date the user logged into Docker using +their web browser (this include Docker Hub and Docker Home) +- **Docker Desktop Version**: The version of Docker Desktop the user has +installed +- **Last Seen Date**: The last date the user used the Docker Desktop application +- **Opted Out Analytics**: Whether the user has opted out of the +[**Send usage statistics**](/manuals/security/for-admins/hardened-desktop/settings-management/settings-reference.md#send-usage-statistics) setting in Docker Desktop ## 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. +- 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. +- 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 @@ -170,14 +206,14 @@ solutions to resolve common problems. Management](/desktop/hardened-desktop/settings-management/) and enable the `analyticsEnabled` setting. -* Ensure that users are using Docker Desktop and aren't using the standalone +- 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 +- 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 diff --git a/hugo_stats.json b/hugo_stats.json index 08222bd6438c..9748c47ca59c 100644 --- a/hugo_stats.json +++ b/hugo_stats.json @@ -313,6 +313,7 @@ "h-2", "h-32", "h-48", + "h-5", "h-6", "h-8", "h-[calc(100vh-64px)]", @@ -542,6 +543,7 @@ "text-gray-400", "text-gray-500", "text-gray-600", + "text-gray-800", "text-left", "text-lg", "text-magenta-light", @@ -564,6 +566,7 @@ "truncate", "underline-offset-2", "w-2", + "w-5", "w-56", "w-8", "w-[1200px]", From ca4033279b652593b8e3371ba1bc037ce276c2c6 Mon Sep 17 00:00:00 2001 From: sarahsanders-docker Date: Fri, 27 Jun 2025 14:34:04 -0400 Subject: [PATCH 2/2] fix bolding on unordered list --- .../manuals/admin/organization/insights.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/content/manuals/admin/organization/insights.md b/content/manuals/admin/organization/insights.md index 21ce30fa3d4c..f06a0a5fb52b 100644 --- a/content/manuals/admin/organization/insights.md +++ b/content/manuals/admin/organization/insights.md @@ -171,21 +171,21 @@ the export data. A Docker Desktop user export file contains the following data points: -- **Name**: User's name -- **Username**: User's Docker ID -- **Email**: User's email address associated with their Docker ID -- **Type**: User type -- **Role**: User [role](/manuals/security/for-admins/roles-and-permissions.md) -- **Teams**: Team(s) within your organization the user is a +- Name: User's name +- Username: User's Docker ID +- Email: User's email address associated with their Docker ID +- Type: User type +- Role: User [role](/manuals/security/for-admins/roles-and-permissions.md) +- Teams: Team(s) within your organization the user is a member of -- **Date Joined**: The date the user joined your organization -- **Last Logged-In Date**: The last date the user logged into Docker using +- Date Joined: The date the user joined your organization +- Last Logged-In Date: The last date the user logged into Docker using their web browser (this include Docker Hub and Docker Home) -- **Docker Desktop Version**: The version of Docker Desktop the user has +- Docker Desktop Version: The version of Docker Desktop the user has installed -- **Last Seen Date**: The last date the user used the Docker Desktop application -- **Opted Out Analytics**: Whether the user has opted out of the -[**Send usage statistics**](/manuals/security/for-admins/hardened-desktop/settings-management/settings-reference.md#send-usage-statistics) setting in Docker Desktop +- Last Seen Date: The last date the user used the Docker Desktop application +- Opted Out Analytics: Whether the user has opted out of the +[Send usage statistics](/manuals/security/for-admins/hardened-desktop/settings-management/settings-reference.md#send-usage-statistics) setting in Docker Desktop ## Troubleshoot Insights