Sending DC/OS Metrics to Datadog

The Datadog metrics plugin supports sending metrics from the DC/OS metrics service directly to DatadogHQ. The plugin includes the function of the Datadog agent. You must install a plugin on each node in your cluster. This plugin works with DC/OS 1.9.4 and higher.

Prerequisite:

  • You must have the DC/OS CLI installed and be logged in as a superuser via the dcos auth login command.

Install the DC/OS Datadog metrics plugin

For each node in your cluster, transfer your plugin binary and then add a systemd unit to manage the service. This unit differs slightly between master and agent nodes.

  1. On every node in your cluster:

    1. Download the latest Datadog plugin binary from downloads.mesosphere.io: datadog-plugin
    2. Rename the plugin to dcos-metrics-datadog and move to /opt/mesosphere/bin.
    3. Assign permissions to the plugin: chmod 0755 /opt/mesosphere/bin/dcos-metrics-datadog.
  2. On every master node:

    1. Download the plugin systemd service file from downloads.mesosphere.io: datadog-plugin.service

    2. Copy the service file to /etc/systemd/system/dcos-metrics-datadog.service. Edit it, ensure that the role flag is set to ‘master’, and fill in your Datadog API key

      [Unit]
      Description=DC/OS Metrics Datadog Plugin
      
      [Service]
      ExecStart=/opt/mesosphere/bin/dcos-metrics-datadog -dcos-role master -datadog-key <Datadog_API_key>
      
    3. Reload the systemd state by running sudo systemctl daemon-reload.

    4. Start the systemd service with sudo systemctl start dcos-metrics-datadog.

    5. View the system logs and verify the plugin is running with sudo journalctl -u dcos-metrics-datadog.

  3. On every agent node:

    1. Download the plugin systemd service file from downloads.mesosphere.io: datadog-plugin.service

    2. Copy the service file to /etc/systemd/system/dcos-metrics-datadog.service. Edit it, ensure that the role flag is set to ‘agent’, and fill in your Datadog API key

      [Unit]
      Description=DC/OS Metrics Datadog Plugin
      
      [Service]
      ExecStart=/opt/mesosphere/bin/dcos-metrics-datadog -dcos-role agent -datadog-key  <Datadog_API_key> 
      
    3. Reload the systemd state by running sudo systemctl daemon-reload.

    4. Start the systemd service with sudo systemctl start dcos-metrics-datadog.

    5. View the system logs and verify the plugin is running with sudo journalctl -u dcos-metrics-datadog.