numastat(8)							  Administration						       numastat(8)

numastat
       numastat - Show per-NUMA-node memory statistics for processes and the operating system

SYNTAX

       numastat

       numastat [-V]

       numastat [<PID>|<pattern>...]

       numastat [-c] [-m] [-n] [-p <PID>|<pattern>] [-s[<node>]] [-v] [-z] [<PID>|<pattern>...]

DESCRIPTION

       numastat  with no command options or arguments at all, displays per-node NUMA hit and miss system statistics from the kernel memory alloca-
       tor.  This default numastat behavior is strictly compatible with the previous long-standing numastat perl script, written  by  Andi  Kleen.
       The default numastat statistics shows per-node numbers (in units of pages of memory) in these categories:

       numa_hit is memory successfully allocated on this node as intended.

       numa_miss is memory allocated on this node despite the process preferring some different node. Each numa_miss has a numa_foreign on another
       node.

       numa_foreign is memory intended for this node, but actually allocated on some different node.  Each numa_foreign has a numa_miss on another
       node.

       interleave_hit is interleaved memory successfully allocated on this node as intended.

       local_node is memory allocated on this node while a process was running on it.

       other_node is memory allocated on this node while a process was running on some other node.

       Any  supplied  options  or  arguments  with  the numastat command will significantly change both the content and the format of the display.
       Specified options will cause display units to change to megabytes of memory, and will  change  other  specific  behaviors  of  numastat	as
       described below.

OPTIONS

       -c     Minimize	table  display	width  by dynamically shrinking column widths based on data contents.  With this option, amounts of memory
	      will be rounded to the nearest megabyte (rather than the usual display with two decimal  places).   Column  width  and  inter-column
	      spacing  will  be  somewhat unpredictable with this option, but the more dense display will be very useful on systems with many NUMA
	      nodes.

       -m     Show the meminfo-like system-wide memory usage information.  This option produces a per-node breakdown of memory	usage  information
	      similar to that found in /proc/meminfo.

       -n     Show the original numastat statistics info.  This will show the same information as the default numastat behavior but the units will
	      be megabytes of memory, and there will be other formatting and layout changes versus the original numastat behavior.

       -p <PID> or <pattern>
	      Show per-node memory allocation information for the specified PID or pattern.  If the -p argument is only digits, it is  assumed	to
	      be  a  numerical	PID.  If the argument characters are not only digits, it is assumed to be a text fragment pattern to search for in
	      process command lines.  For example, numastat -p qemu will attempt to find and show information for processes  with  "qemu"  in  the
	      command line.  Any command line arguments remaining after numastat option flag processing is completed, are assumed to be additional
	      <PID> or <pattern> process specifiers.  In this sense, the -p option flag is optional: numastat qemu is equivalent  to  numastat	-p
	      qemu

       -s[<node>]
	      Sort  the  table data in descending order before displaying it, so the biggest memory consumers are listed first.  With no specified
	      <node>, the table will be sorted by the total column.  If the optional <node> argument is supplied, the data will be sorted  by  the
	      <node>  column.	Note  that <node> must follow the -s immediately with no intermediate white space (e.g., numastat -s2). Because -s
	      can allow an optional argument, it must always be the last option character in a compound  option  character  string.  For  example,
	      instead of numastat -msc (which probably will not work as you expect), use numastat -mcs

       -v     Make  some  reports  more  verbose.  In particular, process information for multiple processes will display detailed information for
	      each process.  Normally when per-node information for multiple processes is displayed, only the total lines are shown.

       -V     Display numastat version information and exit.

       -z     Skip display of table rows and columns of only zero valuess.  This can be used to greatly reduce the amount  of  uninteresting  zero
	      data  on	systems with many NUMA nodes.  Note that when rows or columns of zeros are still displayed with this option, that probably
	      means there is at least one value in the row or column that is actually non-zero, but rounded to zero for display.

NOTES

       numastat attempts to fold each table display so it will be conveniently readable on the output terminal.  Normally a terminal width  of	80
       characters is assumed.  When the resize command is available, numastat attempts to dynamically determine and fine tune the output tty width
       from resize output.  If numastat output is not to a tty, very long output lines can be produced, depending  on  how  many  NUMA	nodes  are
       present.   In  all  cases,  output  width  can  be  explicitly  specified via the NUMASTAT_WIDTH environment variable.  For example, NUMAS-
       TAT_WIDTH=100  numastat.  On systems with many NUMA nodes, numastat -c -z .... can be very helpful to selectively reduce the amount of dis-
       played information.

ENVIRONMENT VARIABLES

       NUMASTAT_WIDTH

FILES

       /proc/*/numa_maps
       /sys/devices/system/node/node*/meminfo
       /sys/devices/system/node/node*/numastat

EXAMPLES

       numastat -c -z -m -n
       numastat -czs libvirt kvm qemu
       watch -n1 numastat
       watch -n1 --differences=cumulative numastat

AUTHORS

       The original numastat perl script was written circa 2003 by Andi Kleen <andi.kleen@intel.com>.  The current numastat program was written in
       2012 by Bill Gray <bgray@redhat.com> to be compatible by default with the original, and to add options to display  per-node  system  memory
       usage and per-node process memory allocation.

SEE ALSO

       numactl(8), set_mempolicy(2), numa(3)

Bill Gray							       1.0.0							       numastat(8)