Marathon Integration

Overview

The Agent's Marathon check lets you:

• Track the state and health of every application: see configured memory, disk, cpu, and instances; monitor the number of healthy and unhealthy tasks
• Monitor the number of queued applications and the number of deployments

Setup

Installation

The Marathon check is included in the Datadog Agent package, so you don't need to install anything else on your Marathon master.

Configuration

1. Edit the marathon.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory. See the sample marathon.d/conf.yaml for all available configuration options:

       init_config:
   
       instances:
         - url: https://<server>:<port> # the API endpoint of your Marathon master; required
       #   acs_url: https://<server>:<port> # if your Marathon master requires ACS auth
           user: <username> # the user for marathon API or ACS token authentication
           password: <password> # the password for marathon API or ACS token authentication

   The function of user and password depends on whether or not you configure acs_url; If you do, the Agent uses them to request an authentication token from ACS, which it then uses to authenticate to the Marathon API. Otherwise, the Agent uses user and password to directly authenticate to the Marathon API.

2. Restart the Agent to begin sending Marathon metrics to Datadog.

Validation

Run the Agent's status subcommand and look for marathon under the Checks section.

Data Collected

Metrics

See metadata.csv for a list of metrics provided by this integration.

Events

The Marathon check does not include any events at this time.

Service Checks

marathon.can_connect:

Returns CRITICAL if the Agent cannot connect to the Marathon API to collect metrics, otherwise OK.

Troubleshooting

Need help? Contact Datadog Support.