# Mesos Input Plugin This input plugin gathers metrics from Mesos. For more information, please check the [Mesos Observability Metrics](http://mesos.apache.org/documentation/latest/monitoring/) page. ### Configuration: ```toml # Telegraf plugin for gathering metrics from N Mesos masters [[inputs.mesos]] # Timeout, in ms. timeout = 100 # A list of Mesos masters, default value is []. masters = ["localhost:5050"] # Master metrics groups to be collected, by default, all enabled. master_collections = [ "resources", "master", "system", "agents", "frameworks", "tasks", "messages", "evqueue", "registrar", ] # 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", # ] # Include mesos tasks statistics, default is false # slave_tasks = true ``` By dafault this plugin is not configured to gather metrics from mesos. Since mesos cluster can be deployed in numerous ways it does not provide ane default values in that matter. User needs to specify master/slave nodes this plugin will gather metrics from. Additionally by enabling `slave_tasks` will allow agthering metrics from takss runing on specified slaves (this options is disabled by default). ### Measurements & Fields: 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 - frameworks - master/frameworks_active - master/frameworks_connected - master/frameworks_disconnected - master/frameworks_inactive - master/outstanding_offers - 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 - 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 - evqueue - master/event_queue_dispatches - master/event_queue_http_requests - master/event_queue_messages - 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 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 Mesos tasks metric groups - executor_id - executor_name - framework_id - source - statistics (all metrics below will have `statistics_` prefix included in their names - cpus_limit - cpus_system_time_secs - cpus_user_time_secs - mem_anon_bytes - mem_cache_bytes - mem_critical_pressure_counter - mem_file_bytes - mem_limit_bytes - mem_low_pressure_counter - mem_mapped_file_bytes - mem_medium_pressure_counter - mem_rss_bytes - mem_swap_bytes - mem_total_bytes - mem_total_memsw_bytes - mem_unevictable_bytes - timestamp ### Tags: - All master/slave measurements have the following tags: - server - role (master/slave) - Tasks measurements have the following tags: - server ### Example Output: ``` $ telegraf -config ~/mesos.conf -input-filter mesos -test * Plugin: mesos, Collection 1 mesos,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 ... ``` Meoso tasks metrics (if enabled): ``` mesos-tasks,host=172.17.8.102,server=172.17.8.101,task_id=hello-world.e4b5b497-2ccd-11e6-a659-0242fb222ce2 statistics_cpus_limit=0.2,statistics_cpus_system_time_secs=142.49,statistics_cpus_user_time_secs=388.14, statistics_mem_anon_bytes=359129088,statistics_mem_cache_bytes=3964928, statistics_mem_critical_pressure_counter=0,statistics_mem_file_bytes=3964928, statistics_mem_limit_bytes=767557632,statistics_mem_low_pressure_counter=0, statistics_mem_mapped_file_bytes=114688,statistics_mem_medium_pressure_counter=0, statistics_mem_rss_bytes=359129088,statistics_mem_swap_bytes=0,statistics_mem_total_bytes=363094016, statistics_mem_total_memsw_bytes=363094016,statistics_mem_unevictable_bytes=0, statistics_timestamp=1465486052.70525 1465486053052811792... ```