Docs » Integrations Guide » Use the Smart Agent » Monitors » collectd/memcached

collectd/memcached 🔗

Monitor Type: collectd/memcached (Source)

Accepts Endpoints: Yes

Multiple Instances Allowed: Yes

Overview 🔗

Monitors an instance of memcached using the collectd memcached plugin. Requires Memcached 1.1 or later.

The monitor collects the following information from Memcached nodes:

  • request information (including hits, misses & evictions)
  • current connections
  • net input/output bytes
  • number of items cached

Documentation for Memcached can be found at https://github.com/memcached/memcached/wiki.

Configuration 🔗

To activate this monitor in the Smart Agent, add the following to your agent config:

monitors:  # All monitor config goes under this key
 - type: collectd/memcached
   ...  # Additional config

For a list of monitor options that are common to all monitors, see Common Configuration.

Config option Required Type Description
host yes string
port yes integer
name no string
reportHost no bool (default: false)

Metrics 🔗

These are the metrics available for this monitor. Metrics that are categorized as container/host (default) are in bold and italics in the list below.

  • connections.opened (cumulative)
    Number of connections opened since server began running
  • df.cache.free (gauge)
    Unused storage bytes
  • df.cache.used (gauge)
    Current number of bytes used to store items
  • memcached_command.flush (cumulative)
    Number of flush requests
  • memcached_command.get (cumulative)
    Number of retrieval requests
  • memcached_command.meta (cumulative)
    Number of meta requests
  • memcached_command.set (cumulative)
    Number of storage requests
  • memcached_command.touch (cumulative)
    Number of touch requests
  • memcached_connections.current (gauge)
    Current number of open connections
  • memcached_items.current (gauge)
    Current number of items stored by this instance
  • memcached_octets.rx (cumulative)
    Total network bytes read by this server
  • memcached_octets.tx (cumulative)
    Total network bytes written by this server
  • memcached_ops.decr_hits (cumulative)
    Number of successful Decr requests
  • memcached_ops.decr_misses (cumulative)
    Number of decr requests against missing keys
  • memcached_ops.delete_hits (cumulative)
    Number of successful delete requests
  • memcached_ops.delete_misses (cumulative)
    Number of delete requests against missing keys
  • memcached_ops.evictions (cumulative)
    Number of valid items removed from cache
  • memcached_ops.hits (cumulative)
    Number of keys that have been requested and found present
  • memcached_ops.incr_hits (cumulative)
    Number of successful incr requests
  • memcached_ops.incr_misses (cumulative)
    Number of incr requests against missing keys
  • memcached_ops.misses (cumulative)
    Number of items that have been requested and not found
  • ps_count.threads (gauge)
    Number of worker threads requested
  • ps_cputime.syst (cumulative)
    Total system time for this instance
  • ps_cputime.user (cumulative)
    Total user time for this instance
  • total_events.listen_disabled (cumulative)
    Number of times connection limit has been exceeded

Non-default metrics (version 4.7.0+) 🔗

To emit metrics that are not default, you can add those metrics in the generic monitor-level extraMetrics config option. Metrics that are derived from specific configuration options that do not appear in the above list of metrics do not need to be added to extraMetrics.

To see a list of metrics that will be emitted you can run agent-status monitors after configuring this monitor in a running agent instance.