Telemetry

Telemetry

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 collected by the Signal component is separated into these categories: Diagnostics, Mesos, and Package service.

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”
event This is the category that appears in Segment. Possible values are package_list (Package service), 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 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 DC/OS Mesos Master component.

Type Description
agents_activeNumber of active agents. For example:
“agents_active”: 2,
agents_connectedNumber of connected agents. For example:
“agents_connected”: 2,
cpu_totalNumber of CPUs available. For example:
“cpu_total”: 8,
cpu_usedNumber of allocated CPUs. For example:
“cpu_used”: 0,
disk_totalDisk space available in MB. For example:
“disk_total”: 71154,
disk_usedAllocated disk space in MB. For example:
“disk_used”: 0,
framework_countNumber of installed DC/OS services. For example:
“framework_count”: 2,
frameworksWhich DC/OS services are installed. For example:
“frameworks”: [
                {
                    “name”: “marathon”
                },
                {
                    “name”: “metronome”
                }
            ],
mem_totalMemory available in MB. For example:
“mem_total”: 28036,
mem_usedMemory allocated in MB. For example:
“mem_used”: 0,
task_countNumber of tasks. For example:
“task_count”: 0,

Package service

This information is collected from the DC/OS Package service 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-minuteman-service-total": 3,
            "health-unit-dcos-minuteman-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.