PCP-ZONEINFO(1)

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

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