Skip to content

admin: add export section to insights docs #22919

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jun 30, 2025
Merged

admin: add export section to insights docs #22919

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5385b56
admin: add export section to insights docs
sarahsanders-docker Jun 24, 2025
ca40332
fix bolding on unordered list
sarahsanders-docker Jun 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
66 changes: 51 additions & 15 deletions content/manuals/admin/organization/insights.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,12 @@
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

Check failure on line 41 in content/manuals/admin/organization/insights.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'timeframe'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'timeframe'?", "location": {"path": "content/manuals/admin/organization/insights.md", "range": {"start": {"line": 41, "column": 13}}}, "severity": "ERROR"}
**3 Months**.

> [!NOTE]
>
Expand All @@ -63,7 +64,7 @@
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 |
|:-----------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
Expand All @@ -79,7 +80,7 @@
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 |
|:-----------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
Expand All @@ -94,7 +95,7 @@
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 |
|:---------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
Expand All @@ -109,7 +110,7 @@
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 |
|:----------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
Expand All @@ -126,10 +127,11 @@
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 |
|:---------------------|:----------------------------------------------------------------------------------------------------------------|
Expand All @@ -143,41 +145,75 @@
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

Check failure on line 163 in content/manuals/admin/organization/insights.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'timeframe'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'timeframe'?", "location": {"path": "content/manuals/admin/organization/insights.md", "range": {"start": {"line": 163, "column": 13}}}, "severity": "ERROR"}
**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
scale for all your users, you can use [Settings
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
Expand Down
3 changes: 3 additions & 0 deletions hugo_stats.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -313,6 +313,7 @@
"h-2",
"h-32",
"h-48",
"h-5",
"h-6",
"h-8",
"h-[calc(100vh-64px)]",
Expand Down Expand Up @@ -542,6 +543,7 @@
"text-gray-400",
"text-gray-500",
"text-gray-600",
"text-gray-800",
"text-left",
"text-lg",
"text-magenta-light",
Expand All @@ -564,6 +566,7 @@
"truncate",
"underline-offset-2",
"w-2",
"w-5",
"w-56",
"w-8",
"w-[1200px]",
Expand Down