PCP-ZONEINFO(1)

💖 PCP-ZONEINFO 💖

okay bestie, welcome to pcp-zoneinfo(1) — it's a General Commands Manual page and it's literally all about peeking at your NUMA zone stats. sit down, grab a boba, we're doing this 🧋✨

---

✨ 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 🦋

So pcp-zoneinfo is the tool you use to look at all the different kinds of stats related to NUMA nodes. With the various options it helps a user analyze useful information related to the zone availability for different NUMA nodes — and that is genuinely useful for analyzing virtual memory behavior. iykyk 💅

By default, pcp-zoneinfo reports live data for the local host. no cap.

The statistics shown are as follows:

🌈 Per node stats (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
• 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. that's the source, periodt. 🍓

---

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

---

lowkey the whole vibe here is: NUMA zones, live by default, /proc/zoneinfo under the hood. go read the see-also list, bestie, it's giving ✨required reading✨

k bye, ily, go check your zones 🫶

this has been Performance Co-Pilot, the PCP collection, page PCP-ZONEINFO(1) — mwah 💅🎀