--- title: '' description: Telegraf plugin for collecting metrics from Apache Mesos url: https://docs.influxdata.com/telegraf/v1/input-plugins/mesos/ estimated_tokens: 2879 product: Telegraf Controller version: v1 publisher: InfluxData canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/mesos/ date: '2026-05-21T20:10:18+02:00' lastmod: '2026-05-21T20:10:18+02:00' --- ========== * Telegraf v0.10.3+ [Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.0/plugins/inputs/mesos/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.0/plugins/inputs/mesos/sample.conf) # Apache Mesos Input Plugin This plugin gathers metrics from [Apache Mesos](https://mesos.apache.org/) instances. For more information, please check the [Mesos Observability Metrics](http://mesos.apache.org/documentation/latest/monitoring/) page. **Introduced in:** Telegraf v0.10.3**Tags:** containers**OS support:** all ## Global configuration options Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details. ## Configuration ```toml # Telegraf plugin for gathering metrics from N Mesos masters [[inputs.mesos]] ## Timeout, in ms. timeout = 100 ## A list of Mesos masters. masters = ["http://localhost:5050"] ## Master metrics groups to be collected, by default, all enabled. master_collections = [ "resources", "master", "system", "agents", "frameworks", "framework_offers", "tasks", "messages", "evqueue", "registrar", "allocator", ] ## A list of Mesos slaves, default is [] # slaves = [] ## Slave metrics groups to be collected, by default, all enabled. # slave_collections = [ # "resources", # "agent", # "system", # "executors", # "tasks", # "messages", # ] ## Optional TLS Config # tls_ca = "/etc/telegraf/ca.pem" # tls_cert = "/etc/telegraf/cert.pem" # tls_key = "/etc/telegraf/key.pem" ## Use TLS but skip chain & host verification # insecure_skip_verify = false ``` By default this plugin is not configured to gather metrics from mesos. Since a mesos cluster can be deployed in numerous ways it does not provide any default values. User needs to specify master/slave nodes this plugin will gather metrics from. ## Metrics Mesos master metric groups * resources * master/cpus\_percent * master/cpus\_used * master/cpus\_total * master/cpus\_revocable\_percent * master/cpus\_revocable\_total * master/cpus\_revocable\_used * master/disk\_percent * master/disk\_used * master/disk\_total * master/disk\_revocable\_percent * master/disk\_revocable\_total * master/disk\_revocable\_used * master/gpus\_percent * master/gpus\_used * master/gpus\_total * master/gpus\_revocable\_percent * master/gpus\_revocable\_total * master/gpus\_revocable\_used * master/mem\_percent * master/mem\_used * master/mem\_total * master/mem\_revocable\_percent * master/mem\_revocable\_total * master/mem\_revocable\_used * master * master/elected * master/uptime\_secs * system * system/cpus\_total * system/load\_15min * system/load\_5min * system/load\_1min * system/mem\_free\_bytes * system/mem\_total\_bytes * slaves * master/slave\_registrations * master/slave\_removals * master/slave\_reregistrations * master/slave\_shutdowns\_scheduled * master/slave\_shutdowns\_canceled * master/slave\_shutdowns\_completed * master/slaves\_active * master/slaves\_connected * master/slaves\_disconnected * master/slaves\_inactive * master/slave\_unreachable\_canceled * master/slave\_unreachable\_completed * master/slave\_unreachable\_scheduled * master/slaves\_unreachable * frameworks * master/frameworks\_active * master/frameworks\_connected * master/frameworks\_disconnected * master/frameworks\_inactive * master/outstanding\_offers * framework offers * master/frameworks/subscribed * master/frameworks/calls\_total * master/frameworks/calls * master/frameworks/events\_total * master/frameworks/events * master/frameworks/operations\_total * master/frameworks/operations * master/frameworks/tasks/active * master/frameworks/tasks/terminal * master/frameworks/offers/sent * master/frameworks/offers/accepted * master/frameworks/offers/declined * master/frameworks/offers/rescinded * master/frameworks/roles/suppressed * tasks * master/tasks\_error * master/tasks\_failed * master/tasks\_finished * master/tasks\_killed * master/tasks\_lost * master/tasks\_running * master/tasks\_staging * master/tasks\_starting * master/tasks\_dropped * master/tasks\_gone * master/tasks\_gone\_by\_operator * master/tasks\_killing * master/tasks\_unreachable * messages * master/invalid\_executor\_to\_framework\_messages * master/invalid\_framework\_to\_executor\_messages * master/invalid\_status\_update\_acknowledgements * master/invalid\_status\_updates * master/dropped\_messages * master/messages\_authenticate * master/messages\_deactivate\_framework * master/messages\_decline\_offers * master/messages\_executor\_to\_framework * master/messages\_exited\_executor * master/messages\_framework\_to\_executor * master/messages\_kill\_task * master/messages\_launch\_tasks * master/messages\_reconcile\_tasks * master/messages\_register\_framework * master/messages\_register\_slave * master/messages\_reregister\_framework * master/messages\_reregister\_slave * master/messages\_resource\_request * master/messages\_revive\_offers * master/messages\_status\_update * master/messages\_status\_update\_acknowledgement * master/messages\_unregister\_framework * master/messages\_unregister\_slave * master/messages\_update\_slave * master/recovery\_slave\_removals * master/slave\_removals/reason\_registered * master/slave\_removals/reason\_unhealthy * master/slave\_removals/reason\_unregistered * master/valid\_framework\_to\_executor\_messages * master/valid\_status\_update\_acknowledgements * master/valid\_status\_updates * master/task\_lost/source\_master/reason\_invalid\_offers * master/task\_lost/source\_master/reason\_slave\_removed * master/task\_lost/source\_slave/reason\_executor\_terminated * master/valid\_executor\_to\_framework\_messages * master/invalid\_operation\_status\_update\_acknowledgements * master/messages\_operation\_status\_update\_acknowledgement * master/messages\_reconcile\_operations * master/messages\_suppress\_offers * master/valid\_operation\_status\_update\_acknowledgements * evqueue * master/event\_queue\_dispatches * master/event\_queue\_http\_requests * master/event\_queue\_messages * master/operator\_event\_stream\_subscribers * registrar * registrar/state\_fetch\_ms * registrar/state\_store\_ms * registrar/state\_store\_ms/max * registrar/state\_store\_ms/min * registrar/state\_store\_ms/p50 * registrar/state\_store\_ms/p90 * registrar/state\_store\_ms/p95 * registrar/state\_store\_ms/p99 * registrar/state\_store\_ms/p999 * registrar/state\_store\_ms/p9999 * registrar/state\_store\_ms/count * registrar/log/ensemble\_size * registrar/log/recovered * registrar/queued\_operations * registrar/registry\_size\_bytes * allocator * allocator/allocation\_run\_ms * allocator/allocation\_run\_ms/count * allocator/allocation\_run\_ms/max * allocator/allocation\_run\_ms/min * allocator/allocation\_run\_ms/p50 * allocator/allocation\_run\_ms/p90 * allocator/allocation\_run\_ms/p95 * allocator/allocation\_run\_ms/p99 * allocator/allocation\_run\_ms/p999 * allocator/allocation\_run\_ms/p9999 * allocator/allocation\_runs * allocator/allocation\_run\_latency\_ms * allocator/allocation\_run\_latency\_ms/count * allocator/allocation\_run\_latency\_ms/max * allocator/allocation\_run\_latency\_ms/min * allocator/allocation\_run\_latency\_ms/p50 * allocator/allocation\_run\_latency\_ms/p90 * allocator/allocation\_run\_latency\_ms/p95 * allocator/allocation\_run\_latency\_ms/p99 * allocator/allocation\_run\_latency\_ms/p999 * allocator/allocation\_run\_latency\_ms/p9999 * allocator/roles/shares/dominant * allocator/event\_queue\_dispatches * allocator/offer\_filters/roles/active * allocator/quota/roles/resources/offered\_or\_allocated * allocator/quota/roles/resources/guarantee * allocator/resources/cpus/offered\_or\_allocated * allocator/resources/cpus/total * allocator/resources/disk/offered\_or\_allocated * allocator/resources/disk/total * allocator/resources/mem/offered\_or\_allocated * allocator/resources/mem/total Mesos slave metric groups * resources * slave/cpus\_percent * slave/cpus\_used * slave/cpus\_total * slave/cpus\_revocable\_percent * slave/cpus\_revocable\_total * slave/cpus\_revocable\_used * slave/disk\_percent * slave/disk\_used * slave/disk\_total * slave/disk\_revocable\_percent * slave/disk\_revocable\_total * slave/disk\_revocable\_used * slave/gpus\_percent * slave/gpus\_used * slave/gpus\_total, * slave/gpus\_revocable\_percent * slave/gpus\_revocable\_total * slave/gpus\_revocable\_used * slave/mem\_percent * slave/mem\_used * slave/mem\_total * slave/mem\_revocable\_percent * slave/mem\_revocable\_total * slave/mem\_revocable\_used * agent * slave/registered * slave/uptime\_secs * system * system/cpus\_total * system/load\_15min * system/load\_5min * system/load\_1min * system/mem\_free\_bytes * system/mem\_total\_bytes * executors * containerizer/mesos/container\_destroy\_errors * slave/container\_launch\_errors * slave/executors\_preempted * slave/frameworks\_active * slave/executor\_directory\_max\_allowed\_age\_secs * slave/executors\_registering * slave/executors\_running * slave/executors\_terminated * slave/executors\_terminating * slave/recovery\_errors * tasks * slave/tasks\_failed * slave/tasks\_finished * slave/tasks\_killed * slave/tasks\_lost * slave/tasks\_running * slave/tasks\_staging * slave/tasks\_starting * messages * slave/invalid\_framework\_messages * slave/invalid\_status\_updates * slave/valid\_framework\_messages * slave/valid\_status\_updates ## Tags * All master/slave measurements have the following tags: * server (network location of server: `host:port`) * url (URL origin of server: `scheme://host:port`) * role (master/slave) * All master measurements have the extra tags: * state (leader/follower) ## Example Output ```text mesos,role=master,state=leader,host=172.17.8.102,server=172.17.8.101 allocator/event_queue_dispatches=0,master/cpus_percent=0, master/cpus_revocable_percent=0,master/cpus_revocable_total=0, master/cpus_revocable_used=0,master/cpus_total=2, master/cpus_used=0,master/disk_percent=0,master/disk_revocable_percent=0, master/disk_revocable_total=0,master/disk_revocable_used=0,master/disk_total=10823, master/disk_used=0,master/dropped_messages=2,master/elected=1, master/event_queue_dispatches=10,master/event_queue_http_requests=0, master/event_queue_messages=0,master/frameworks_active=2,master/frameworks_connected=2, master/frameworks_disconnected=0,master/frameworks_inactive=0, master/invalid_executor_to_framework_messages=0, master/invalid_framework_to_executor_messages=0, master/invalid_status_update_acknowledgements=0,master/invalid_status_updates=0,master/mem_percent=0, master/mem_revocable_percent=0,master/mem_revocable_total=0, master/mem_revocable_used=0,master/mem_total=1002, master/mem_used=0,master/messages_authenticate=0, master/messages_deactivate_framework=0 ... ```