Add info about telemetry (#209)

This commit is contained in:
Misty Stanley-Jones 2017-08-15 21:21:47 -07:00 committed by Jim Galasyn
parent eeaa8ba89c
commit 79a134f523
2 changed files with 54 additions and 0 deletions

View File

@ -1292,6 +1292,8 @@ manuals:
- path: /engine/installation/
title: Install Docker EE
nosync: true
- path: /enterprise/telemetry/
title: Manage usage data collection
- path: /enterprise/release-notes/
title: Release Notes
- path: /datacenter/install/linux/

52
enterprise/telemetry.md Normal file
View File

@ -0,0 +1,52 @@
---
name: Manage usage data collection
description: Understand and manage usage data collected by Docker EE and sent to Docker.
keywords: enterprise, telemetry, data collection
---
Docker EE 17.06 and higher include a telemetry plugin which is enabled by
default on Ubuntu. This plugin sends Docker information about your running
system so that we can improve Docker EE. For details about the telemetry plugin
and the types of data it collects, see the
[`telemetry` plugin documentation](hhttps://store.docker.com/community/images/docker/telemetry).
If your Docker instance runs in an environment with no internet connectivity,
the plugin does not collect or attempt to send any information to Docker.
## Manage data collection
If you do not wish to send any usage data to Docker, you can disable the plugin,
either using the Docker CLI or using Universal Control Plane.
### Use the Docker CLI
To disable the telemetry plugin, use the `docker plugin disable` command:
```bash
$ docker plugin disable telemetry
```
This command needs to be run on each Docker host.
To re-enable the telemetry plugin, you can use `docker plugin enable`.
```bash
$ docker plugin enable telemetry
```
### Use Universal Control Plane
If you use Universal Control Plane with Docker EE, do not use the Docker CLI to
disable the telemetry plugin. Instead, you can manage the information sent to
Docker by going to **Admin Settings** and choosing **Usage**.
![UCP admin settings Usage defaults](images/usage-defaults.png)
To disable the telemetry plugin, disable all three options and click **Save**.
Enabling either or both of the top two options will enable the telemetry plugin.
You can find out more about an individual option by clicking the **?** icon next
to it.
> **Note**: If you enable gathering of API statistics, the payloads are not
> collected, but only information about which API endpoints you use.