}}

To continuously improve the DC/OS experience, a telemetry component is included that reports anonymous usage data to Mesosphere. This data is used to monitor the reliability of core DC/OS components, installations, user interface, and to find out which features are most popular.

Core telemetry

The DC/OS Signal component queries the diagnostics service /system/health/v1/report endpoint on the leading master and sends this data to Segment which Mesosphere then uses to track usage metrics and customer support.

The information reported by DC/OS Signal comes from several components: DC/OS Diagnostics (3DT), Apache Mesos, and DC/OS Package Manager (Cosmos).

For each category this data is collected:

Type Description
anonymousId This is an anonymous ID that is created for every cluster at startup. This ID persists across your cluster. For example:

"anonymousId": "70b28f00-e38f-41b2-a723-aab344f535b9
clusterId This is the anonymousID value that is created for every cluster at startup. This ID persists across your cluster. For example:

"clusterId": "70b28f00-e38f-41b2-a723-aab344f535b9"
customerKey (Enterprise DC/OS) This is the Enterprise DC/OS customer key. Customer keys are delivered via email to the Authorized Support Contact. For example:

"customerKey": "ab1c23de-45f6-7g8h-9012-i345j6k7lm8n",
event This is the category that appears in Segment. Possible values are package_list (Package Manager), health (Diagnostics), and mesos_track (Mesos). For example:

"event": "package_list"
environmentVersion This is the version of DC/OS. For example, if you are using DC/OS 1.8:

"environmentVersion": "1.8",
provider This is the platform that DC/OS is running on. Possible values are aws, on-prem, and azure. For example, if you are running on AWS:

"provider": "aws",
source This is a hard-coded setting that indicates a cluster. For example:

"source": "cluster",
variant This indicates whether the cluster is DC/OS or Enterprise DC/OS. For example, if you are using DC/OS:

"variant": "open"

Diagnostics

This information is collected from the DC/OS Diagnostics (3DT) component. For every systemd unit, the following information is collected, where <UNIT_NAME> is component name:

"health-unit-dcos-<UNIT_NAME>-total": 3, "health-unit-dcos-<UNIT_NAME>-unhealthy": 0,

Mesos

This information is collected from the Apache Mesos component.

Type Description
agents_active Number of active agents. For example:

"agents_active": 2,
agents_connected Number of connected agents. For example:

"agents_connected": 2,
cpu_total Number of CPUs available. For example:

"cpu_total": 8,
cpu_used Number of allocated CPUs. For example:

"cpu_used": 0,
disk_total Disk space available in MB. For example:

"disk_total": 71154,
disk_used Allocated disk space in MB. For example:

"disk_used": 0,
framework_count Number of installed DC/OS services. For example:

"framework_count": 2,
frameworks Which DC/OS services are installed. For example:

"frameworks": [
                {
                    "name": "marathon"
                },
                {
                    "name": "metronome"
                }
            ],
mem_total Memory available in MB. For example:

"mem_total": 28036,
mem_used Memory allocated in MB. For example:

"mem_used": 0,
task_count Number of tasks. For example:

"task_count": 0,

Package Manager

This information is collected from the DC/OS Package Manager (Cosmos) component.

Type Description
package_list Which packages are installed. For example, if you had Kafka and Spark:

"package_list": [
{
"name": "kafka"
},
{
"name": "spark"
}
],

Here is an example of the JSON telemetry report that is collected:

{
    "cosmos": {
        "properties": {
            "clusterId": "70b28f00-e38f-41b2-a723-aab344f535b9",
            "customerKey": "",
            "environmentVersion": "1.8",
            “package_list”: [
            {
            “name”: “kafka”
            },
            {
            “name”: “spark”
            }
            ],
            "provider": "aws",
            "source": "cluster",
            "variant": "open"
        },
        "anonymousId": "70b28f00-e38f-41b2-a723-aab344f535b9",
        "event": "package_list"
    },
    "diagnostics": {
        "properties": {
            "clusterId": "70b28f00-e38f-41b2-a723-aab344f535b9",
            "customerKey": "",
            "environmentVersion": "1.8",
            "health-unit-dcos-3dt-service-total": 3,
            "health-unit-dcos-3dt-service-unhealthy": 0,
            "health-unit-dcos-3dt-socket-total": 2,
            "health-unit-dcos-3dt-socket-unhealthy": 0,
            "health-unit-dcos-adminrouter-agent-service-total": 2,
            "health-unit-dcos-adminrouter-agent-service-unhealthy": 0,
            "health-unit-dcos-adminrouter-reload-service-total": 3,
            "health-unit-dcos-adminrouter-reload-service-unhealthy": 0,
            "health-unit-dcos-adminrouter-reload-timer-total": 3,
            "health-unit-dcos-adminrouter-reload-timer-unhealthy": 0,
            "health-unit-dcos-adminrouter-service-total": 1,
            "health-unit-dcos-adminrouter-service-unhealthy": 0,
            "health-unit-dcos-cosmos-service-total": 1,
            "health-unit-dcos-cosmos-service-unhealthy": 0,
            "health-unit-dcos-epmd-service-total": 3,
            "health-unit-dcos-epmd-service-unhealthy": 0,
            "health-unit-dcos-exhibitor-service-total": 1,
            "health-unit-dcos-exhibitor-service-unhealthy": 0,
            "health-unit-dcos-gen-resolvconf-service-total": 3,
            "health-unit-dcos-gen-resolvconf-service-unhealthy": 0,
            "health-unit-dcos-gen-resolvconf-timer-total": 3,
            "health-unit-dcos-gen-resolvconf-timer-unhealthy": 0,
            "health-unit-dcos-history-service-total": 1,
            "health-unit-dcos-history-service-unhealthy": 0,
            "health-unit-dcos-logrotate-agent-service-total": 2,
            "health-unit-dcos-logrotate-agent-service-unhealthy": 0,
            "health-unit-dcos-logrotate-agent-timer-total": 2,
            "health-unit-dcos-logrotate-agent-timer-unhealthy": 0,
            "health-unit-dcos-logrotate-master-service-total": 1,
            "health-unit-dcos-logrotate-master-service-unhealthy": 0,
            "health-unit-dcos-logrotate-master-timer-total": 1,
            "health-unit-dcos-logrotate-master-timer-unhealthy": 0,
            "health-unit-dcos-marathon-service-total": 1,
            "health-unit-dcos-marathon-service-unhealthy": 0,
            "health-unit-dcos-mesos-dns-service-total": 1,
            "health-unit-dcos-mesos-dns-service-unhealthy": 0,
            "health-unit-dcos-mesos-master-service-total": 1,
            "health-unit-dcos-mesos-master-service-unhealthy": 0,
            "health-unit-dcos-mesos-slave-public-service-total": 1,
            "health-unit-dcos-mesos-slave-public-service-unhealthy": 0,
            "health-unit-dcos-mesos-slave-service-total": 1,
            "health-unit-dcos-mesos-slave-service-unhealthy": 0,
            "health-unit-dcos-metronome-service-total": 1,
            "health-unit-dcos-metronome-service-unhealthy": 0,
            "health-unit-dcos-navstar-service-total": 3,
            "health-unit-dcos-navstar-service-unhealthy": 0,
            "health-unit-dcos-oauth-service-total": 1,
            "health-unit-dcos-oauth-service-unhealthy": 0,
            "health-unit-dcos-pkgpanda-api-service-total": 3,
            "health-unit-dcos-pkgpanda-api-service-unhealthy": 0,
            "health-unit-dcos-pkgpanda-api-socket-total": 3,
            "health-unit-dcos-pkgpanda-api-socket-unhealthy": 0,
            "health-unit-dcos-rexray-service-total": 2,
            "health-unit-dcos-rexray-service-unhealthy": 0,
            "health-unit-dcos-signal-service-total": 1,
            "health-unit-dcos-signal-service-unhealthy": 0,
            "health-unit-dcos-signal-timer-total": 3,
            "health-unit-dcos-signal-timer-unhealthy": 0,
            "health-unit-dcos-spartan-service-total": 3,
            "health-unit-dcos-spartan-service-unhealthy": 0,
            "health-unit-dcos-spartan-watchdog-service-total": 3,
            "health-unit-dcos-spartan-watchdog-service-unhealthy": 0,
            "health-unit-dcos-spartan-watchdog-timer-total": 3,
            "health-unit-dcos-spartan-watchdog-timer-unhealthy": 0,
            "health-unit-dcos-vol-discovery-priv-agent-service-total": 1,
            "health-unit-dcos-vol-discovery-priv-agent-service-unhealthy": 0,
            "health-unit-dcos-vol-discovery-pub-agent-service-total": 1,
            "health-unit-dcos-vol-discovery-pub-agent-service-unhealthy": 0,
            "provider": "aws",
            "source": "cluster",
            "variant": "open"
        },
        "anonymousId": "70b28f00-e38f-41b2-a723-aab344f535b9",
        "event": "health"
    },
    "mesos": {
        "properties": {
            "agents_active": 2,
            "agents_connected": 2,
            "clusterId": "70b28f00-e38f-41b2-a723-aab344f535b9",
            "cpu_total": 8,
            "cpu_used": 0,
            "customerKey": "",
            "disk_total": 71154,
            "disk_used": 0,
            "environmentVersion": "1.8",
            "framework_count": 2,
            "frameworks": [
                {
                    "name": "marathon"
                },
                {
                    "name": "metronome"
                }
            ],
            "mem_total": 28036,
            "mem_used": 0,
            "provider": "aws",
            "source": "cluster",
            "task_count": 0,
            "variant": "open"
        },
        "anonymousId": "70b28f00-e38f-41b2-a723-aab344f535b9",
        "event": "mesos_track"
    }
}

User interface telemetry

The DC/OS UI sends two types of notifications to Segment which Mesosphere then uses to track usage metrics and customer support:

  • Login information
  • The pages you’ve viewed while navigating the UI

Opt-Out

You can also choose to opt-out of the telemetry features. For more information, see the documentation.