--- title: Telegraf Documentation description: Telegraf plugin for collecting metrics from Apache Mesos url: https://docs.influxdata.com/telegraf/v1/input-plugins/mesos/ estimated_tokens: 4356 product: Telegraf version: v1 --- - Telegraf v0.10.3+ # 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 ... ``` #### Related - [Configure plugins](/telegraf/v1/configure_plugins/) - [Apache Mesos Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/mesos/README.md)