# pcp-zoneinfo

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


* * *