numastat

displays memory statistics for NUMA systems

TLDR

Show NUMA statistics

$ numastat

Show per-process NUMA memory

$ numastat -p [pid]

Show per-node memory info

$ numastat -m

Show compact output

$ numastat -c

Show statistics for command

$ numastat -p $(pgrep [process_name])

SYNOPSIS

numastat [options] [pattern|pid...]

numastat displays memory statistics for NUMA (Non-Uniform Memory Access) systems. It shows per-node memory allocation, hits, misses, and process memory distribution.Understanding NUMA statistics helps optimize application performance on multi-socket systems.

PARAMETERS

-p pid

Show per-process stats.

-m

Show memory info.

-c

Compact output.

-n

Show original format.

-s node

Sort by node.

-z

Skip zero values.

STATISTICS EXPLAINED

$ numa_hit - Allocation on intended node
numa_miss - Allocation on different node
numa_foreign - Other node allocations here
interleave_hit - Interleave policy success
local_node - Local allocations
other_node - Remote allocations

EXAMPLE OUTPUT

$                  node0       node1
numa_hit        1234567      987654
numa_miss           100         200
local_node      1234467      987454
other_node          100         200

INSTALL

sudo apt install numactl

sudo dnf install numactl

sudo pacman -S numactl

sudo apk add numactl-tools

sudo zypper install numactl

brew install numactl

nix profile install nixpkgs#numactl

CAVEATS

Only relevant on NUMA systems. Statistics cumulative since boot. Requires /sys/devices/system/node/.

HISTORY

numastat is part of numactl, providing NUMA statistics similar to the original SGI IRIX numastat command.