Docs » Integrations Guide » Integrations Reference » Mesos

../../_images/integrations_mesos.png Mesos ๐Ÿ”—


Use the Mesos plugin for collectd to monitor the following information about Mesos:

  • Cluster status: number of activated slaves, schedulers and tasks
  • CPU, disk and memory usage for Mesos
  • Tasks finished, lost, and failed


Built-in dashboards ๐Ÿ”—

  • Mesos Clusters: Overview of data from all Mesos clusters.


  • Mesos Cluster: Focus on a single Mesos cluster.


  • Mesos Master: Focus further on a single Mesos master.


  • Mesos Slave: Focus further on a single Mesos slave.



This plugin requires:

  • collectd 4.9+
  • Python plugin for collectd (included with SignalFx collectd agent)
  • Python 2.3+ (2.7.5+ for DC/OS strict mode)
  • Mesos 0.19.0 or greater


  1. Download the three Python modules for Mesos from the following URL: Place them in a convenient spot (e.g. in /usr/share/collectd/mesos-collectd-plugin)
  2. Download SignalFxโ€™s sample configuration files for a Mesos master or a Mesos slave to /etc/collectd/managed_config.
  3. Modify the configuration file to contain values that make sense for your environment, as described below.
  4. Restart collectd.
  5. OPTIONAL: This step needs to be followed when the Mesos cluster being monitored is running under a DC/OS cluster operating in strict mode.
    • Make a new user on DC/OS.
    • Give the new user the following permission strings:
      • dcos:mesos:agent:endpoint:path:/metrics/snapshot read
      • dcos:mesos:master:endpoint:path:/metrics/snapshot read
    • Configure the plugin with the required options. See below.

Note: The /system/health/v1 endpoint on port 1050 for DC/OS is not available if operating in strict mode.


Using the example configuration files 10-mesos-master.conf or 10-mesos-slave.conf as a guide, provide values for the configuration options listed below that make sense for your environment and allow you to connect to the Mesos instance to be monitored.

configuration option definition default value
ModulePath Path on disk where collectd can find the Mesos python modules. "/usr/share/collectd/mesos-collectd-plugin"
Cluster The name of the cluster to which the Mesos instance belongs. Appears in the dimension cluster. "cluster-0"
Instance The name of this Mesos master/slave instance. Appears in the dimension plugin_instance. "master-0" / "slave-0"
Path The location of the mesos-master/mesos-slave binary. "/usr/sbin"
scheme Scheme the plugin needs to use to fetch metrics. It is either "http" or "https". "http"
Host The hostname or IP address of the Mesos instance to be monitored. "%%%MASTER_IP%%%"
Port The port on which the Mesos instance is listening for connections. %%%MASTER_PORT%%%
Verbose Enable verbose logging from this plugin to collectd's log file false
IncludeSystemHealth Enable the sending of DC/OS System Service Health Metrics (this option is only applicable for a DC/OS master) false
ca_file_path Path to CA file required for server verification. If not provided, verification is skipped (this option is only applicable if ssl is enabled) "path/to/file"
dcos_sfx_username New DC/OS username created for the plugin (this option is only applicable for DC/OS in strict mode) sfx-collectd
dcos_sfx_password Password of the above username (this option is only applicable for DC/OS in strict mode) signalfx
dcos_url The DC/OS authentication endpoint (this is an optional config and is only applicable for DC/OS in strict mode) "https://leader.mesos/acs/api/v1/auth/login"

Note: (Applicable if operating DC/OS in strict mode) The default dcos_url makes use of the leader.mesos hostname provided by DC/OS. If the hostname does not exist, dcos_url can be set by the user. See below example.

Below is an example configuration:

<LoadPlugin "python">
  Globals true

<Plugin "python">
  ModulePath "/opt/collectd-mesos"

  Import "mesos-master"

  <Module "mesos-master">
    Cluster "cluster-0"
    Instance "master-0"
    Path "/usr/sbin"
    scheme "https"
    Host ""
    Port 5050
    Verbose false
    IncludeSystemHealth false
    dcos_sfx_username "test-collectd"
    dcos_sfx_password "1234"
    # Note that is
    # base URL of the DC/OS UI and /acs/api/v1/auth/login is the authentication endpoint the plugin
    # uses to obtain token for subsequent requests. By default dcos_url takes -
    # https://leader.mesos/acs/api/v1/auth/login
    dcos_url ""


Below are screen captures of dashboards created for this plugin by SignalFx, illustrating the metrics emitted by this plugin.

Monitoring Mesos clusters ๐Ÿ”—

../../_images/task_monitoring.pngtask monitoring

Itโ€™s important to keep track of the status of tasks in the cluster. An increase in failed tasks for a master or slave can indicate a problem with a framework.

../../_images/hosts_and_slaves.pnghosts and slaves

It can be important to analyze performance per Mesos host. An increase in failed tasks for many masters and slaves on a single host may indicate a hardware problem.

../../_images/1w_task_growth.pngweek-over-week growth

Track week-over-week growth of tasks in your cluster to be informed of changing workloads.

Monitoring Mesos masters and slaves ๐Ÿ”—

../../_images/connected_slaves.pngconnected slaves

An unexpectedly low number of connected slaves on a Mesos master can indicate a network problem preventing them from connecting. To verify this, check to see if thereโ€™s an unexpectedly high number of dropped messages in counter.master_dropped_messages.

../../_images/connected_frameworks.pngconnected frameworks and task detail

On the Mesos master dashboard, you can view in detail the number of tasks that are finished, failed, lost or errored out. Monitoring connected and active frameworks can help you determine the health of your Mesos scheduler.

For additional information on how to monitor Mesos, check out Apacheโ€™s guide here.