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.37.2/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

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 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