Skip to content

Commit a6a3c4f

Browse files
sarahsanders-dockersarahsanders-docker
authored
Merge pull request #22919 from sarahsanders-docker/insights-export
admin: add export section to insights docs
1 parent 1da5f51 commit a6a3c4f

File tree

2 files changed

+54
-15
lines changed

2 files changed

+54
-15
lines changed

‎content/manuals/admin/organization/insights.md‎

Lines changed: 51 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -34,11 +34,12 @@ To access Insights, you must contact your Customer Success Manager to have the
3434
feature enabled. Once the feature is enabled, access Insights using the following
3535
steps:
3636

37-
1. Go to the [Admin Console](https://app.docker.com/admin/) and sign in to an
38-
account that is an organization owner.
39-
2. Select your company on the **Choose profile** page.
40-
3. Select **Insights**.
41-
4. On the **Insights** page, select the period of time for the data.
37+
1. Open [Docker Home](https://app.docker.com/) and select your organization
38+
on the **Choose profile** page.
39+
1. Select **Admin Console** in the left-hand navigation menu.
40+
1. Select **Desktop insights**.
41+
1. Choose a timeframe for your insights data: **1 Week**, **1 Month**, or
42+
**3 Months**.
4243

4344
> [!NOTE]
4445
>
@@ -63,7 +64,7 @@ organization, providing insights into how many users are actively using Docker
6364
Desktop. Note that users who opt out of analytics aren't included in the active
6465
counts.
6566

66-
The chart contains the following data.
67+
The chart contains the following data:
6768

6869
| Data | Description |
6970
|:-----------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -79,7 +80,7 @@ Monitor development efficiency and the time your team invests in builds with
7980
this chart. It provides a clear view of the build activity, helping you identify
8081
patterns, optimize build times, and enhance overall development productivity.
8182

82-
The chart contains the following data.
83+
The chart contains the following data:
8384

8485
| Data | Description |
8586
|:-----------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -94,7 +95,7 @@ View the total and average number of containers run by users with this chart. It
9495
lets you gauge container usage across your organization, helping you understand
9596
usage trends and manage resources effectively.
9697

97-
The chart contains the following data.
98+
The chart contains the following data:
9899

99100
| Data | Description |
100101
|:---------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -109,7 +110,7 @@ workflows and ensure compatibility. It provides valuable insights into how
109110
Docker Desktop is being utilized, enabling you to streamline processes and
110111
improve efficiency.
111112

112-
The chart contains the following data.
113+
The chart contains the following data:
113114

114115
| Data | Description |
115116
|:----------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -126,10 +127,11 @@ usage, ensuring that the most critical resources are readily available and
126127
efficiently used.
127128

128129
> [!NOTE]
130+
>
129131
> Data for images is only for Docker Hub. Data for third-party
130132
> registries and mirrors aren't included.
131133
132-
The chart contains the following data.
134+
The chart contains the following data:
133135

134136
| Data | Description |
135137
|:---------------------|:----------------------------------------------------------------------------------------------------------------|
@@ -143,41 +145,75 @@ Monitor extension installation activity with this chart. It provides visibility
143145
into the Docker Desktop extensions your team are using, letting you track
144146
adoption and identify popular tools that enhance productivity.
145147

146-
The chart contains the following data.
148+
The chart contains the following data:
147149

148150
| Data | Description |
149151
|:-----------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------|
150152
| Percentage of org with extensions installed | The percentage of users in your organization with at least one Docker Desktop extension installed. |
151153
| 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. |
152154

155+
## Export Docker Desktop user data
156+
157+
You can export Docker Desktop user data as a CSV file:
158+
159+
1. Open [Docker Home](https://app.docker.com) and select your organization
160+
on the **Choose profile** page.
161+
1. Select **Admin Console** in the left-hand navigation menu.
162+
1. Select **Desktop insights**.
163+
1. Choose a timeframe for your insights data: **1 Week**, **1 Month**, or
164+
**3 Months**.
165+
1. Select **Export** and choose **Docker Desktop users** from the drop-down.
166+
167+
Your export will automatically download. Open the file to view
168+
the export data.
169+
170+
### Understanding export data
171+
172+
A Docker Desktop user export file contains the following data points:
173+
174+
- Name: User's name
175+
- Username: User's Docker ID
176+
- Email: User's email address associated with their Docker ID
177+
- Type: User type
178+
- Role: User [role](/manuals/security/for-admins/roles-and-permissions.md)
179+
- Teams: Team(s) within your organization the user is a
180+
member of
181+
- Date Joined: The date the user joined your organization
182+
- Last Logged-In Date: The last date the user logged into Docker using
183+
their web browser (this include Docker Hub and Docker Home)
184+
- Docker Desktop Version: The version of Docker Desktop the user has
185+
installed
186+
- Last Seen Date: The last date the user used the Docker Desktop application
187+
- Opted Out Analytics: Whether the user has opted out of the
188+
[Send usage statistics](/manuals/security/for-admins/hardened-desktop/settings-management/settings-reference.md#send-usage-statistics) setting in Docker Desktop
153189

154190
## Troubleshoot Insights
155191

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

159-
* Update users to the latest version of Docker Desktop.
195+
- Update users to the latest version of Docker Desktop.
160196

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

165-
* Enable **Send usage statistics** in Docker Desktop for all your users.
201+
- Enable **Send usage statistics** in Docker Desktop for all your users.
166202

167203
If users have opted out of sending usage statistics for Docker Desktop, then
168204
their usage data will not be a part of Insights. To manage the setting at
169205
scale for all your users, you can use [Settings
170206
Management](/desktop/hardened-desktop/settings-management/) and enable the
171207
`analyticsEnabled` setting.
172208

173-
* Ensure that users are using Docker Desktop and aren't using the standalone
209+
- Ensure that users are using Docker Desktop and aren't using the standalone
174210
version of Docker Engine.
175211

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

180-
* Ensure that users are signing in to an account associated with your
216+
- Ensure that users are signing in to an account associated with your
181217
organization.
182218

183219
Users who don’t sign in to an account associated with your organization are

‎hugo_stats.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -313,6 +313,7 @@
313313
"h-2",
314314
"h-32",
315315
"h-48",
316+
"h-5",
316317
"h-6",
317318
"h-8",
318319
"h-[calc(100vh-64px)]",
@@ -542,6 +543,7 @@
542543
"text-gray-400",
543544
"text-gray-500",
544545
"text-gray-600",
546+
"text-gray-800",
545547
"text-left",
546548
"text-lg",
547549
"text-magenta-light",
@@ -564,6 +566,7 @@
564566
"truncate",
565567
"underline-offset-2",
566568
"w-2",
569+
"w-5",
567570
"w-56",
568571
"w-8",
569572
"w-[1200px]",

0 commit comments

Comments
 (0)