---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from Mcrouter
url: https://docs.influxdata.com/telegraf/v1/input-plugins/mcrouter/
estimated_tokens: 1594
product: Telegraf
version: v1
---

-   Telegraf v1.7.0+

# Mcrouter Input Plugin

This plugin gathers statistics data from [Mcrouter](https://github.com/facebook/mcrouter) instances, a protocol router, developed and maintained by Facebook, for scaling [memcached](http://memcached.org/) deployments.

**Introduced in:** Telegraf v1.7.0 **Tags:** applications, network **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
# Read metrics from one or many mcrouter servers.
[[inputs.mcrouter]]
  ## An array of address to gather stats about. Specify an ip or hostname
  ## with port. ie tcp://localhost:11211, tcp://10.0.0.1:11211, etc.
  servers = ["tcp://localhost:11211", "unix:///var/run/mcrouter.sock"]

  ## Timeout for metric collections from all servers.  Minimum timeout is "1s".
  # timeout = "5s"
```

## Metrics

The fields from this plugin are gathered in the *mcrouter* measurement.

Description of gathered fields can be found in the [project wiki](https://github.com/facebook/mcrouter/wiki/Stats-list).

Fields:

-   uptime
-   num\_servers
-   num\_servers\_new
-   num\_servers\_up
-   num\_servers\_down
-   num\_servers\_closed
-   num\_clients
-   num\_suspect\_servers
-   destination\_batches\_sum
-   destination\_requests\_sum
-   outstanding\_route\_get\_reqs\_queued
-   outstanding\_route\_update\_reqs\_queued
-   outstanding\_route\_get\_avg\_queue\_size
-   outstanding\_route\_update\_avg\_queue\_size
-   outstanding\_route\_get\_avg\_wait\_time\_sec
-   outstanding\_route\_update\_avg\_wait\_time\_sec
-   retrans\_closed\_connections
-   destination\_pending\_reqs
-   destination\_inflight\_reqs
-   destination\_batch\_size
-   asynclog\_requests
-   proxy\_reqs\_processing
-   proxy\_reqs\_waiting
-   client\_queue\_notify\_period
-   rusage\_system
-   rusage\_user
-   ps\_num\_minor\_faults
-   ps\_num\_major\_faults
-   ps\_user\_time\_sec
-   ps\_system\_time\_sec
-   ps\_vsize
-   ps\_rss
-   fibers\_allocated
-   fibers\_pool\_size
-   fibers\_stack\_high\_watermark
-   successful\_client\_connections
-   duration\_us
-   destination\_max\_pending\_reqs
-   destination\_max\_inflight\_reqs
-   retrans\_per\_kbyte\_max
-   cmd\_get\_count
-   cmd\_delete\_out
-   cmd\_lease\_get
-   cmd\_set
-   cmd\_get\_out\_all
-   cmd\_get\_out
-   cmd\_lease\_set\_count
-   cmd\_other\_out\_all
-   cmd\_lease\_get\_out
-   cmd\_set\_count
-   cmd\_lease\_set\_out
-   cmd\_delete\_count
-   cmd\_other
-   cmd\_delete
-   cmd\_get
-   cmd\_lease\_set
-   cmd\_set\_out
-   cmd\_lease\_get\_count
-   cmd\_other\_out
-   cmd\_lease\_get\_out\_all
-   cmd\_set\_out\_all
-   cmd\_other\_count
-   cmd\_delete\_out\_all
-   cmd\_lease\_set\_out\_all

## Tags

-   Mcrouter measurements have the following tags:
    -   server (the host name from which metrics are gathered)

## Example Output

```text
mcrouter,server=localhost:11211 uptime=166,num_servers=1,num_servers_new=1,num_servers_up=0,num_servers_down=0,num_servers_closed=0,num_clients=1,num_suspect_servers=0,destination_batches_sum=0,destination_requests_sum=0,outstanding_route_get_reqs_queued=0,outstanding_route_update_reqs_queued=0,outstanding_route_get_avg_queue_size=0,outstanding_route_update_avg_queue_size=0,outstanding_route_get_avg_wait_time_sec=0,outstanding_route_update_avg_wait_time_sec=0,retrans_closed_connections=0,destination_pending_reqs=0,destination_inflight_reqs=0,destination_batch_size=0,asynclog_requests=0,proxy_reqs_processing=1,proxy_reqs_waiting=0,client_queue_notify_period=0,rusage_system=0.040966,rusage_user=0.020483,ps_num_minor_faults=2490,ps_num_major_faults=11,ps_user_time_sec=0.02,ps_system_time_sec=0.04,ps_vsize=697741312,ps_rss=10563584,fibers_allocated=0,fibers_pool_size=0,fibers_stack_high_watermark=0,successful_client_connections=18,duration_us=0,destination_max_pending_reqs=0,destination_max_inflight_reqs=0,retrans_per_kbyte_max=0,cmd_get_count=0,cmd_delete_out=0,cmd_lease_get=0,cmd_set=0,cmd_get_out_all=0,cmd_get_out=0,cmd_lease_set_count=0,cmd_other_out_all=0,cmd_lease_get_out=0,cmd_set_count=0,cmd_lease_set_out=0,cmd_delete_count=0,cmd_other=0,cmd_delete=0,cmd_get=0,cmd_lease_set=0,cmd_set_out=0,cmd_lease_get_count=0,cmd_other_out=0,cmd_lease_get_out_all=0,cmd_set_out_all=0,cmd_other_count=0,cmd_delete_out_all=0,cmd_lease_set_out_all=0 1453831884664956455
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [Mcrouter Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/mcrouter/README.md)