mem

package
v1.39.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 8, 2026 License: MIT Imports: 8 Imported by: 19

README

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.

⭐ Telegraf v0.1.5 🏷️ system 💻 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]]
  ## Collect extended memory statistics from /proc/meminfo (Linux)
  ## or from performance counters (Windows).
  # collect_extended = false

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)
Extended fields (collect_extended = true)

These fields are only collected when collect_extended is set to true.

Linux
  • mem
    • fields:
      • active_anon (integer)
      • active_file (integer)
      • inactive_anon (integer)
      • inactive_file (integer)
      • percpu (integer)
      • unevictable (integer)
Windows
  • mem
    • fields:
      • commit_limit (integer)
      • commit_total (integer)
      • page_file_avail (integer)
      • page_file_total (integer)
      • phys_avail (integer)
      • phys_total (integer)
      • virtual_avail (integer)
      • virtual_total (integer)

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,write_back=0i,write_back_tmp=0i 1574712869000000000

With collect_extended = true on Linux:

mem active=9299595264i,active_anon=5765169152i,active_file=3534426112i,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,inactive_anon=1081245696i,inactive_file=6468694016i,low_free=0i,low_total=0i,mapped=416763904i,page_tables=19787776i,percpu=5765120i,shared=670679040i,slab=2081071104i,sreclaimable=1923395584i,sunreclaim=157675520i,swap_cached=1302528i,swap_free=4286128128i,swap_total=4294963200i,total=20913917952i,unevictable=143360i,used=3335778304i,used_percent=15.95004011996231,vmalloc_chunk=0i,vmalloc_total=35184372087808i,vmalloc_used=0i,write_back=0i,write_back_tmp=0i 1574712869000000000

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Mem added in v1.32.3 

type Mem struct {
	CollectExtended bool            `toml:"collect_extended"`
	Log             telegraf.Logger `toml:"-"`
	// contains filtered or unexported fields
}

func (*Mem) Gather added in v1.32.3 

func (ms *Mem) Gather(acc telegraf.Accumulator) error

func (*Mem) Init added in v1.32.3 

func (ms *Mem) Init() error

func (*Mem) SampleConfig added in v1.32.3 

func (*Mem) SampleConfig() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.