Section 1 · User commands

pcp-zoneinfo.1

Package: pcp-doc

PCP-ZONEINFO

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
NOTES
PCP ENVIRONMENT
SEE ALSO

NAME

pcp-zoneinfo − Report NUMA zone statistics

SYNOPSIS

pcp [pcp options] zoneinfo [−Vz?] [−s samples] [−a archive] [−S start_time] [−T end_time] [−Z timezone]

DESCRIPTION

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 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)
HEADER	DESCRIPTION
nr_inactive_anon	zone inactive anonymous pages
nr_active_anon	active anonymous memory pages
nr_inactive_file	inactive file memory pages
nr_active_file	active file memory memory pages
nr_unevictable	unevictable pages
nr_slab_reclaimable	reclaimable slab pages
nr_slab_unreclaimable	unreclaimable slab pages
nr_isolated_anon	isolated anonymous memory pages
nr_isolated_file	isolated file memory pages
nr_anon_pages	anonymous mapped pagecache pages
nr_mapped	mapped pagecache pages
nr_file_pages	file pagecache pages
nr_dirty	pages dirty state
nr_writeback	pages writeback state
nr_writeback_temp	temporary writeback pages
nr_shmem	shared memory pages
nr_shmem_hugepages	shared memory huge pages
nr_shmem_pmdmapped	shared memory PMD mappings
nr_file_hugepages	file-backed huge pages
nr_file_pmdmapped	file-backed PMD mappings
nr_anon_transparent_hugepages	anonymous transparent huge pages
nr_unstable	pages in unstable state in each zone
nr_vmscan_write	pages 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_reclaim	prioritise for reclaim when writeback ends
nr_dirtied	pages entering dirty state
nr_written	pages written out in each zone
nr_kernel_misc_reclaimable	miscellaneous reclaimable kernel pages

Per zone stats (in each zone for each NUMA node)
HEADER	DESCRIPTION
pages free	free space
pages min	min space
pages low	low space
pages high	high space
pages spanned	spanned space
pages present	present space
pages managed	managed space
pages protection	protection space
nr_free_pages	number of free pages
nr_zone_inactive_anon	zone inactive anonymous pages
nr_zone_active_anon	zone active anonymous pages
nr_zone_inactive_file	zone inactive file-backed pages
nr_zone_active_file	zone active file-backed pages
nr_zone_unevictable	zone unevictable pages
nr_zone_write_pending	zone write-pending pages
nr_mlock	pages under mlock
nr_page_table_pages	page table pages
nr_kernel_stack	pages of kernel stack
nr_bounce	bounce buffer pages
nr_zspages	zsmalloc memory allocator pages
nr_free_cma	free Contiguous Memory Allocator pages
numa_hit	successful allocations from preferred NUMA zone
numa_miss	unsuccessful allocations from preferred NUMA zone
numa_foreign	foreign NUMA zone allocations
numa_interleave	interleaved NUMA allocations
numa_local	successful allocations from local NUMA zone
numa_other	unsuccessful allocations from local NUMA zone

OPTIONS

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

NOTES

pcp-zoneinfo collects information from /proc/zoneinfo.

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