table of contents
PCP-ZONEINFO(1) | General Commands Manual | PCP-ZONEINFO(1) |
NAME¶
pcp-zoneinfo - Report statistics for System Zoneinfo.
SYNOPSIS¶
pcp [pcp options] zoneinfo [-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 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:
HEADER DESCRIPTION |
_ _ |
Per node stats (for each zone for each NUMA node) |
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) |
pages free free space |
min min space |
low low space |
high high space |
spanned spanned space |
present present space |
managed managed space |
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 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¶
PCP | Performance Co-Pilot |