NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | PCP ENVIRONMENT | SEE ALSO | COLOPHON |
|
|
PCP-ZONEINFO(1) General Commands Manual PCP-ZONEINFO(1)
pcp-zoneinfo - Report NUMA zone statistics
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 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
-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.
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).
PCPIntro(1), pcp(1), pmParseInterval(3) and environ(7).
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at
⟨http://www.pcp.io/⟩. If you have a bug report for this manual
page, send it to [email protected]. This page was obtained from the
project's upstream Git repository
⟨https://github.com/performancecopilot/pcp.git⟩ on 2024-06-14.
(At that time, the date of the most recent commit that was found
in the repository was 2024-06-14.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
[email protected]
Performance Co-Pilot PCP PCP-ZONEINFO(1)