pcp-zoneinfo - Man Page

Report statistics for System Zoneinfo.


pcp [pcp options] zoneinfo [-s samples] [-a archive] [-S start_time] [-T end_time] [-Z timezone]


The pcp-zoneinfo command is used for viewing the different kinds of stats related to numa nodes. Using various options it helps a user to analyze useful information related to the zone availability for different numa nodes.This file display information about memory zones. This is useful for analyzing virtual memory behavior.By default pcp-zoneinfo reports live data for the local host.

The statistics shown are as follows:

Per node stats (for each NUMA node)
nr_inactive_anonzone inactive anonymous pages
nr_active_anonactive anonymous memory pages
nr_inactive_fileinactive file memory pages
nr_active_fileactive file memory memory pages
nr_unevictableunevictable pages
nr_slab_reclaimablereclaimable slab pages
nr_slab_unreclaimableunreclaimable slab pages
nr_isolated_anonisolated anonymous memory pages
nr_isolated_fileisolated file memory pages
nr_anon_pagesanonymous mapped pagecache pages
nr_mappedmapped pagecache pages
nr_file_pagesfile pagecache pages
nr_dirtypages dirty state
nr_writebackpages writeback state
nr_writeback_temptemporary writeback pages
nr_shmemshared memory pages
nr_shmem_hugepagesshared memory huge pages
nr_shmem_pmdmappedshared memory PMD mappings
nr_file_hugepagesfile-backed huge pages
nr_file_pmdmappedfile-backed PMD mappings
nr_anon_transparent_hugepagesanonymous transparent huge pages
nr_unstablepages in unstable state in each zone
nr_vmscan_writepages written from the LRU by the VM scanner The VM is supposed to minimise the number of pages which get written from the LRU (for IO scheduling efficiency and reclaim success).
nr_vmscan_immediate_reclaimprioritise for reclaim when writeback ends
nr_dirtiedpages entering dirty state
nr_writtenpages written out in each zone
nr_kernel_misc_reclaimablemiscellaneous reclaimable kernel pages
Per zone stats (in each zone for each NUMA node)
pages freefree space
pages minmin space
pages lowlow space
pages highhigh space
pages spannedspanned space
pages presentpresent space
pages managedmanaged space
pages protectionprotection space
nr_free_pagesnumber of free pages
nr_zone_inactive_anonzone inactive anonymous pages
nr_zone_active_anonzone active anonymous pages
nr_zone_inactive_filezone inactive file-backed pages
nr_zone_active_filezone active file-backed pages
nr_zone_unevictablezone unevictable pages
nr_zone_write_pendingzone write-pending pages
nr_mlockpages under mlock
nr_page_table_pagespage table pages
nr_kernel_stackpages of kernel stack
nr_bouncebounce buffer pages
nr_zspageszsmalloc memory allocator pages
nr_free_cmafree Contiguous Memory Allocator pages
numa_hitsuccessful allocations from preferred NUMA zone
numa_missunsuccessful allocations from preferred NUMA zone
numa_foreignforeign NUMA zone allocations
numa_interleaveinterleaved NUMA allocations
numa_localsuccessful allocations from local NUMA zone
numa_otherunsuccessful allocations from local NUMA zone


-a file, --archive=file

Fetch /proc/zoneinfo for a specified archive file

-s count, --samples=count

Get the zoneinfo statistics for specified number of samples count

-S,  --start=time

Filter the samples from the archive from the given time

-T, --finish=time

Filter the samples from the archive until the given time

-V,  --version

Display version number and exit.

-z,  --hostzone

Use the local timezone of the host that is the source of the performance metrics, as identified by either the -h or the -a options. The default is to use the timezone of the local host.

-Z timezone, --timezone=timezone

Use timezone for the date and time. Timezone is in the format of the environment variable TZ as described in environ(7).

-?,  --help

Display usage message and exit.


pcp-zoneinfo collects information from /proc/zoneinfo and aims to be command line and output compatible with it.

PCP Environment

Environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. On each installation, the file /etc/pcp.conf contains the local values for these variables. The $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5).

For environment variables affecting PCP tools, see pmGetOptions(3).

See Also

PCPIntro(1), pcp(1), pmParseInterval(3) and environ(7).


PCP Performance Co-Pilot