1PCP-ZONEINFO(1)             General Commands Manual            PCP-ZONEINFO(1)
2
3
4

NAME

6       pcp-zoneinfo - Report statistics for System Zoneinfo.
7

SYNOPSIS

9       pcp  [pcp options]  zoneinfo  [-s samples] [-a archive] [-S start_time]
10       [-T end_time] [-Z timezone]
11

DESCRIPTION

13       The pcp-zoneinfo command is used for viewing  the  different  kinds  of
14       stats  related to numa nodes.  Using various options it helps a user to
15       analyze useful information related to the zone availability for differ‐
16       ent  numa nodes.This file display information about memory zones.  This
17       is useful for analyzing virtual memory behavior.By default pcp-zoneinfo
18       reports live data for the local host.
19
20       The statistics shown are as follows:
21
22
23       HEADER                  DESCRIPTION
24       _                       _
25
26       Per node stats (for each zone for each NUMA node)
27
28       nr_inactive_anon        zone inactive anonymous pages
29       nr_active_anon          active anonymous memory pages
30       nr_inactive_file        inactive file memory pages
31       nr_active_file          active file memory memory pages
32       nr_unevictable          unevictable pages
33       nr_slab_reclaimable     reclaimable slab pages
34       nr_slab_unreclaimable   unreclaimable slab pages
35       nr_isolated_anon        isolated anonymous memory pages
36       nr_isolated_file        isolated file memory pages
37       nr_anon_pages           anonymous mapped pagecache pages
38       nr_mapped               mapped pagecache pages
39       nr_file_pages           file pagecache pages
40       nr_dirty                pages dirty state
41       nr_writeback            pages writeback state
42       nr_writeback_temp       temporary writeback pages
43       nr_shmem                shared memory pages
44       nr_shmem_hugepages      shared memory huge pages
45       nr_shmem_pmdmapped      shared memory PMD mappings
46       nr_file_hugepages       file-backed huge pages
47       nr_file_pmdmapped       file-backed PMD mappings
48       nr_anon_transparent_hugepages
49                               anonymous transparent huge pages
50       nr_unstable             pages in unstable state in each zone
51       nr_vmscan_write         pages written from the LRU by the VM scanner
52                               The VM is supposed to minimise the number of
53                               pages which get written from the LRU (for IO
54                               scheduling efficiency and reclaim success).
55       nr_vmscan_immediate_reclaim
56                               prioritise for reclaim when writeback ends
57       nr_dirtied              pages entering dirty state
58       nr_written              pages written out in each zone
59       nr_kernel_misc_reclaimable
60                               miscellaneous reclaimable kernel pages
61
62       Per zone stats (in each zone for each NUMA node)
63
64       pages free              free space
65             min               min space
66
67             low               low space
68             high              high space
69             spanned           spanned space
70             present           present space
71             managed           managed space
72             protection        protection space
73       nr_free_pages           number of free pages
74       nr_zone_inactive_anon   zone inactive anonymous pages
75       nr_zone_active_anon     zone active anonymous pages
76       nr_zone_inactive_file   zone inactive file-backed pages
77       nr_zone_active_file     zone active file-backed pages
78       nr_zone_unevictable     zone unevictable pages
79       nr_zone_write_pending   zone write-pending pages
80       nr_mlock                pages under mlock
81       nr_page_table_pages     page table pages
82       nr_kernel_stack         pages of kernel stack
83       nr_bounce               bounce buffer pages
84       nr_zspages              zsmalloc memory allocator pages
85       nr_free_cma             free Contiguous Memory Allocator pages
86       numa_hit                successful allocations from preferred
87                               NUMA zone
88       numa_miss               unsuccessful allocations from preferred
89                               NUMA zone
90       numa_foreign            foreign NUMA zone allocations
91       numa_interleave         interleaved NUMA allocations
92       numa_local              successful allocations from local
93                               NUMA zone
94       numa_other              unsuccessful allocations from local
95                               NUMA zone
96
97

OPTIONS

99       -a file, --archive=file
100              Fetch /proc/zoneinfo for a specified archive file
101
102       -s count, --samples=count
103              Get  the  zoneinfo  statistics  for  specified number of samples
104              count
105
106       -S, --start=time
107              Filter the samples from the archive from the given time
108
109       -T, --finish=time
110              Filter the samples from the archive until the given time
111
112       -V, --version
113              Display version number and exit.
114
115       -z, --hostzone
116              Use the local timezone of the host that is  the  source  of  the
117              performance  metrics,  as  identified by either the -h or the -a
118              options.  The default is to use the timezone of the local host.
119
120       -Z timezone, --timezone=timezone
121              Use timezone for the date and time.  Timezone is in  the  format
122              of the environment variable TZ as described in environ(7).
123
124       -?, --help
125              Display usage message and exit.
126

NOTES

128       pcp-zoneinfo  collects  information  from /proc/zoneinfo and aims to be
129       command line and output compatible with it.
130

PCP ENVIRONMENT

132       Environment variables with the prefix PCP_ are used to parameterize the
133       file  and  directory names used by PCP.  On each installation, the file
134       /etc/pcp.conf contains the  local  values  for  these  variables.   The
135       $PCP_CONF  variable may be used to specify an alternative configuration
136       file, as described in pcp.conf(5).
137
138       For environment variables affecting PCP tools, see pmGetOptions(3).
139

SEE ALSO

141       PCPIntro(1), pcp(1), pmParseInterval(3) and environ(7).
142
143
144
145
146Performance Co-Pilot                  PCP                      PCP-ZONEINFO(1)
Impressum