}}

Telemetry

Enterprise DC/OS Updated: October 17, 2016

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"
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 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_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 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