docs-v2/content/telegraf/v1/input-plugins/mem/_index.md

3.4 KiB

description menu tags introduced os_support related
Telegraf plugin for collecting metrics from Memory
telegraf_v1_ref
parent name identifier
input_plugins_reference Memory input-mem
Memory
input-plugins
configuration
system
v0.1.5 freebsd, linux, macos, solaris, windows
/telegraf/v1/configure_plugins/
https://github.com/influxdata/telegraf/tree/v1.36.1/plugins/inputs/mem/README.md, Memory Plugin Source

Memory Input Plugin

This plugin collects metrics about the system memory.

[!TIP] For an explanation of the difference between used and actual_used RAM, see Linux ate my ram.

Introduced in: Telegraf v0.1.5 Tags: system OS support: all

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# Read metrics about memory usage
[[inputs.mem]]
  # no configuration

Metrics

Available fields are dependent on platform.

  • mem
    • fields:
      • active (integer, Darwin, FreeBSD, Linux, OpenBSD)
      • available (integer)
      • available_percent (float)
      • buffered (integer, FreeBSD, Linux)
      • cached (integer, FreeBSD, Linux, OpenBSD)
      • commit_limit (integer, Linux)
      • committed_as (integer, Linux)
      • dirty (integer, Linux)
      • free (integer, Darwin, FreeBSD, Linux, OpenBSD)
      • high_free (integer, Linux)
      • high_total (integer, Linux)
      • huge_pages_free (integer, Linux)
      • huge_page_size (integer, Linux)
      • huge_pages_total (integer, Linux)
      • inactive (integer, Darwin, FreeBSD, Linux, OpenBSD)
      • laundry (integer, FreeBSD)
      • low_free (integer, Linux)
      • low_total (integer, Linux)
      • mapped (integer, Linux)
      • page_tables (integer, Linux)
      • shared (integer, Linux)
      • slab (integer, Linux)
      • sreclaimable (integer, Linux)
      • sunreclaim (integer, Linux)
      • swap_cached (integer, Linux)
      • swap_free (integer, Linux)
      • swap_total (integer, Linux)
      • total (integer)
      • used (integer)
      • used_percent (float)
      • vmalloc_chunk (integer, Linux)
      • vmalloc_total (integer, Linux)
      • vmalloc_used (integer, Linux)
      • wired (integer, Darwin, FreeBSD, OpenBSD)
      • write_back (integer, Linux)
      • write_back_tmp (integer, Linux)

Example Output

mem active=9299595264i,available=16818249728i,available_percent=80.41654254645131,buffered=2383761408i,cached=13316689920i,commit_limit=14751920128i,committed_as=11781156864i,dirty=122880i,free=1877688320i,high_free=0i,high_total=0i,huge_page_size=2097152i,huge_pages_free=0i,huge_pages_total=0i,inactive=7549939712i,low_free=0i,low_total=0i,mapped=416763904i,page_tables=19787776i,shared=670679040i,slab=2081071104i,sreclaimable=1923395584i,sunreclaim=157675520i,swap_cached=1302528i,swap_free=4286128128i,swap_total=4294963200i,total=20913917952i,used=3335778304i,used_percent=15.95004011996231,vmalloc_chunk=0i,vmalloc_total=35184372087808i,vmalloc_used=0i,wired=0i,write_back=0i,write_back_tmp=0i 1574712869000000000