Njmon4AIXCommandLine

njmon for AIX Command Syntax version 92


     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

     NAME
	  njmon	and nimon are one program with two names (see ln
	  command)
	  - njmon: save	performance statistics in JSON format.
	  - nimon: save	performance statistics in InfluxDB Line
	  Protocol format.

     BRIEFLY
	  Performance statistics agent outputting in
	  1. JSON format for Time-Series databases, including InfluxDB
	  on any tools that accept JSON	data.
	  2. InfluxDB Line Protocol format directly to InfluxDB	over a
	  network. Or the Influxdata Telegraf tool to send the data
	  elsewhere. Or	to other tools or database like	Elastic,
	  Splunk or VictoriaMetrics.

	  Default is stdout to allow using a shell pipe	into other
	  commands.

	  Other	tools related to njmon:
	  - The	ninstall shell script puts njmon and nimon into
	  /usr/lbin and	adds this manual page.
	  - The	nmeasure programs allow	adding your own	data to
	  InfluxDB.
	  - The	njmond.py Python programs that can be used on a
	  central server to capture njmon data and add it to the
	  InfluxDB.

     Version
	  Version: 92 (Jan 2026)

     SYNOPSIS
	  Core options to save the statistics to stdout	(for piping
	  into other programs) or to a file (-f):
	  njmon	-s seconds -c count [-m	directory -f]
	  or
	  nimon	-s seconds -c count [-m	directory -f]

	  Other	options	are listed below:
	  -a file -b -B	-C -d -D -e -h -k -K pidfile -L	-V -n -o -O
	  org -P -PP -q	tags -r	-R -t percentage -T token -u -U	-v -W
	  -? -@	-! -~

	  Additional njmon specific options:
	  -i njmond-hostname -p	njmond-portno -e -I

	  Additional nimon specific options for	InfluxDB 1.x:
	  -i InfluxDB-hostname [-p InfluxDB-portno] [-x	InfluxDB-
	  database] [-y	InfluxDB-username [-z InfluxDB-password]] -H

     Page 1					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  -w

	  Additional nimon specific options for	InfluxDB 2.x or
	  higher:
	  -i InfluxDB-hostname [-p InfluxDB-portno] [-O	organisation]
	  [-T security-token] -H -w

     DESCRIPTION
	  These	are the	njmon command options in alphabetical order.

	  -a file
	  Read the command line	arguments from a file (so no passwords
	  are seen in the ps command output).
	  Place	only the command arguments into	a config file (not
	  including the	command	name).	Use the	same arguments,	all on
	  the first line, space-separated.  Only have the -a option on
	  the actual command line. Example:
	  nimon	-c 1440	-s 60 -i myinflux -x njmon -y fred -z abc123

	  Create a file	called njmon.conf:
	  -c 1440 -s 60	-i myinflux -x njmon -y	fred -z	abc123
	  Then run the command:	njmon -a njmon.conf
	  Note:	user and passwords need	to be setup in the InfluxDB
	  configuration	(these are optional for	InfluxDB).

	  -A hostname
	  User supplied	hostname override - ignoring the actual
	  hostname.  Some systems administrators have different
	  servers with the same	hostname on different network domains!

	  -b
	  For Process stats, switch off	adding pid to the process
	  names: "ksh_76927" becomes "ksh".  This can help if you want
	  to add up all	the stats (like	CPU use	and memory total) for
	  all processes	with the same name.

	  -B
	  Adds extra raw mode statistics without maths to convert to
	  averages or rates in the last	period.	 These are not user-
	  friendly but can help	if you want to do the maths. Look for
	  measures and statistics containing "raw".

	  -c count
	  Number of snapshots of the statistics	to save	and then stop
	  (the default is forever).  Multiply this count by the	-s
	  seconds option, and you have the run time in seconds.	 After
	  this time, njmon will	silently stop.	A crontab can be used
	  to regularly start njmon.
	  Examples: to run for 24 hours, collecting data every minute

     Page 2					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  or half-minute:
	   -s 60 -c 1440  or  -s 30 -c 2880
	  -C
	  Shared CPU/Processor Pool, you need to enable	performance
	  data collection on the LPAR on the HMC.

	  -d
	  Switch on debugging output. Note: debugging mode may ruin
	  the JSON or line protocol format.  Hint: Use the -f option
	  to save data to a file. Then analyse with an editor like
	  "vi".

	  -D
	  Skip dangerous libperfstat functions that can	cause
	  problems.  Temporary fix for some older AIX versions.

	  -e
	  NJMON	mode only. Switch on elastic mode (also	called
	  ElasticSearch	or ELK stack) with sub-arrays (with [])
	  instead of sub-JSON data structures for variable numbers of
	  resources like filesystems, disks, networks, etc.

	  -f file
	  Output to file (not stdout) to two files below:
	  NJMON	saves to
	  hostname_<year><month><day>_<hour><minutes>.json
	  NIMON	saves to
	  hostname_<year><month><day>_<hour><minutes>.influxlp

	  Debug	& Errors are saved
	  hostname_<year><month><day>_<hour><minutes>.err

	  In NIMON mode: If you	add a second "f" like "-ff" or "-f -f"
	  then the .influxlp output file has a "nanoseconds" since
	  epoch	start timestamp	at the end of every measure line.
	  This should allow it to be inserted into the InfluxDB	using
	  the "influx" command.

	  In NJMON mode: If you	add a second "f" like -ff or -f	-f
	  then each snapshot has its own file.
	  The file name	format is
	  hostname_<year><month><day>_<hour><minutes>_<6 digit
	  sequence_number>.json. The sequence number starts at 000000.
	  There	is only	a single error file.

	  -H
	  NIMON	mode only. This	option makes nimon send	to InfluxDB
	  the full hostname (as	the host tag).	The short hostname is
	  the default. This is important if many servers have the same
	  short	name in	different domains. For example:
	  myserver.achme.com
	  normally it has

     Page 3					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  host=myserver
	  With the -H option, the Fully	Qualified Domain Name (FQDN)
	  is used
	  host=myserver.achme.com
	  With NJMON mode, the hostname	is extracted from the stats by
	  njmond.py Python central server.  If you need	full hostname
	  tags from JSON data, modify the njmond.py program. -h
	  Outputs online help details and then stops. Similar to this
	  manual page.

	  -i IP-Address	or -i Hostname
	  The server to	which to send the data over a network.
	  NJMON	mode:
	  IP Address or	Hostname of the	central	server running
	  njmond.py for	ingesting JSON format data or some other
	  program that accepts JSON data.

	  NIMON	mode:
	  IP Address or	Hostname of the	InfluxDB server	sending	the
	  Line Protocol	format.

	  -I
	  Force	NIMON mode.
	  Force	switch to running in NIMON mode	(regardless of the
	  command name used) for InfluxDB Line Protocol	output format.

	  -J
	  Force	NJMON mode
	  Force	switch to running in NJMON mode	(regardless of the
	  command name used) for JSON output format.  If you only have
	  the njmon program is installed, use this option to run nimon
	  mode:	njmon -I ....

	  -k
	  If the file /tmp/njmon.pid is	not found, this	njmon
	  continues running. For nimon,	the file is called
	  /tmp/nimon.pid.
	  If the file is found,	the process PID	is read	from it	& if
	  it is	found that the process is still	running, then this
	  njmon	(or nimon) silently exits.
	  If no	process	is found running with this PID,	then this
	  njmon	continues running.
	  This allows you to try starting njmon	or nimon, say, once an
	  hour from crontab.
	  This will restart the	njmon or nimon only if the previous
	  one has stopped.
	  njmon/nimon will remove the njmon.pid	or nimon.pid file when
	  it stops normally.
	  If njmon/nimon detects the .pid file but can't gain access,
	  it will produce a warning and	stop.
	  Usually, due to not being the	file owner (like you are not
	  the root user) or having the wrong file permissions.

     Page 4					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  -K pidfile
	  This is the same as the -k option, but the user decides the
	  directory and	filename for the file containing the Process
	  Identity (PID).  Also, you can run multiple njmon processes,
	  using	different PID files.  Some users prefer	to use a file
	  in, for example, /var/logs, but that requires	root access.
	  Others prefer	to avoid /tmp and use /home/njmon.  If
	  njmon/nimon detects the .pid file but	can't gain access, it
	  will produce a warning and stop.  Usually, due to not	being
	  the file owner (like you are not the root user) or having
	  the wrong file permissions.

	  -L
	  Don't	collect	Logical	Volume stats to	reduce the CPU
	  processing time.  If not the root user, then these are
	  silently switched off.

	  -m directory
	  The program will change to this directory before creating
	  files. This can be useful when using crontab so that files
	  are not created in the user's	top-most directory.

	  -n
	  No PID for the child process is printed out at startup.  A
	  child	process	is created to make a new "process group", so
	  that njmon does not get terminated by	the kernel, if/when
	  you log out.

	  -o
	  If using Oracle ASM raw disks	have zero size.	 This option
	  requests njmon to use	the "bootinfo -s" command to find out
	  the ASM disk sizes.

	  -O org
	  Set the organisation.	This is	used in	nimon mode and
	  required for InfluxDB	2+.  InfluxDB 2+ uses this feature to
	  separate data	for different users and	dashboards.  This
	  could	be a company name, if hosting for more than one
	  company's data in a single InfluxDB. Or used for department
	  names, or a group of users, or a workload.  See also the -T
	  token	option.

	  -p port-number
	  NJMON	mode.  Network port number of the central njmond.py
	  server. Many users use port 8181.

	  NIMON	mode. Network port number of the InfluxDB server.  If
	  not set, then	the default InfluxDB port number of 8086 is
	  used.

	  -P
	  Switch on the	collection of process statistics.  Note: these

     Page 5					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  can be a very	large volume of	stats on large servers.
	  Processes using less than the	CPU threshold are ignored.
	  See -t percentage option to change the default threshold.
	  This reduces the collection of statistics for	processes not
	  using	any CPU	time.  Collecting hundreds of zero stats for
	  paused processes is seen as rather pointless.

	  -PP or -P -P
	  A second -P switches on the capture of command line
	  arguments into the process statistics.  This can add even
	  more to the size of files or the size	of a database.	The
	  default is 256 characters. Minimum is	16 characters.	The
	  size can be extended using a shell variable NJMON_ARGS_MAX
	  up to	16384 characters.  Note: that some AIX kernels may
	  have a lower max argument size.  Example: export
	  NJMON_ARGS_MAX=1024

	  -q influxDB-tags
	  The tag format is a comma-separated
	  tagname=tagvalue
	  both parts are strings. No double or single quotes.
	  For example: -q dept=foobar,area=51
	  This option adds user-defined	tags that might	include:
	  location, racknumber,	owner, workload, department spp, ssp
	  or HAcluster.	 See InfluxDB documentation for	the definition
	  of the Line Protocol tag syntax.  No spaces are allowed in
	  the tags string.

	  New in njmon version 81, there is a new "tags" measure
	  containing the original and user-defined tags.  These	can be
	  added	to Grafana's single statistics "text boxes".

	  NIMON	mode: nimon InfluxDB default tags are: hostname, os,
	  architecture,	serial_no, mtm and now includes	the additional
	  tags automatically.  There is	also a new measure called
	  "tags" with keys of the default tags and additional tags
	  with "_tag" added to the names.

	  NJMON	mode: njmon sending data to InfluxDB via njmond	has
	  InfluxDB tags	are: hostname, os, architecture, serial_no and
	  mtm.	These are extracted from the JSON data by njmond.
	  njmond would need to be changed to add the additional	tags.
	  njmond may be	updated	in the future to use the tag
	  measurement for the tags.

	  -r
	  Random pause at the start. Stops cron	starting every njmon
	  in sync on many endpoints (VM), causing massive network and
	  InfluxDB peaks, say, once a minute.  Especially if you are
	  using	the network time protocol (NTP).

	  -R

     Page 6					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  Reduced mode,	don't collect CPU core thread: logical CPUs
	  like cpu_logicals, cpu_physicals, syscall statistics,	nor
	  netbuffers. You still	get the	total statistics.

	  -s seconds
	  Seconds between snapshots of data (default 60	seconds).
	  Seconds multiplied by	the -c count decided how long njmon
	  with run before stopping.

	  -S
	  NIMON	mode only:  Appends a Line Protocol timestamp to the
	  end of every	line (for files, pipes & network sockets) When
	  saving to a file, the	data	can be added to	    InfluxDB
	  later	on.  Not needed	if sending to InfluxDB as it adds
	  timestamps	 itself	thus removing time zone	& drift
	  problems.  Can help other databases. For example
	  VictoriaMetrics.

	  -t percentage
	  Process CPU cut-off threshold	percentage. Default 0.001.
	  This is one thousandth of a CPU second.
	  Processes using less than this value are not included	in the
	  statistics, thus removing processes using no (or very
	  little) CPU clock cycle,s and	drastically reducing the data
	  saved	for processes.

	  -T token
	  For NIMON mode only, InfluxDB	2+ uses	a different REST API
	  and this option switches to Influx 2+	mode.
	  The Security Token is	found in the InfluxDB 2+ CLI or	GUI.
	  It is	about 50 characters (Lower and upper case letters,
	  numbers and some symbol characters).	See also the -O
	  organisation option.

	  -u
	  Only available if njmon or nimon are compiled	with VIOS
	  support. Compile with	the -D SSP option.  This adds VIOS
	  Shared Storage Pools (SSP) statistics.

	  -U
	  Only available if njmon or nimon are compiled	with VIOS
	  support. Compile with	the -D SSP option.  This adds VIOS
	  Shared Storage Pools (SSP) statistics	for each node.

	  -v
	  Only available if njmon or nimon are compiled	with VIOS
	  support. Compile with	the -D VIOS option.  This adds VIOS
	  virtual disk and virtual network statistics.

	  -V
	  Don't	collect	Volume Group stats to reduce the CPU
	  processing time.  If not the root user, then these are

     Page 7					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  silently switched off.

	  -w
	  NIMON	mode only. Switch on Influxdata	telegraf output	mode.
	  This excludes	the HTTP POST string in	the output stream.

	  -W
	  Ignore warning messages. Use this to suppress	some messages
	  that you no longer want to see.

	  -x database
	  NIMON	mode only. This	is the InfluxDB's database name. For
	  example: created with	"influx" command, then:	 create
	  database njmon and exit
	  Note:	nimon and njmon	can share the same database and	it is
	  normally called "njmon".
	  You can use a	different database name.
	  If not specified, then "njmon" is the	default.  In
	  InfluxDB2, "database"	is now called a	"bucket".

	  -y username
	  NIMON	mode only. This	is the InfluxDB	1.x server's username
	  for authentication. Mandatory: if you	have setup InfluxDB to
	  enforce username and password	authentication.	The InfluxDB's
	  default is that no username and no password are necessary.
	  In this case,	any username or	password is silently ignored.

	  -z password
	  NIMON	mode only. This	is the InfluxDB	1.x server's password
	  for authentication.  Mandatory: if you have setup InfluxDB
	  to enforce username and password authentication. The
	  InfluxDB's default is	that no	username and no	password are
	  necessary.  In this case, any	username or password is
	  silently ignored.

	  -?
	  Same as the -h Help option.

	  -!
	  Output the full njmon	or nimon version information and stop.
	  For example:s
	  Version njmon4AIX7-v90-33/10/2025
	  This is a simple check that you have upgraded	njmon and/or
	  nimon.

	  -@
	  Switch on Workload Manager statistics.
	  See the AIX wlmstat command for the sorts of statistics that
	  are available.  WLM is an advanced AIX feature that allows
	  AIX processes	can be grouped for monitoring and controlling
	  performance.

     Page 8					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  -~
	  Experimental mode recording only process information and
	  some other details.  This is to aid capturing	shorter	lived
	  processes.

	  Note:	on Spectrum Scale (GPFS):

	  njmon	automatically collects GPFS if /usr/lpp/mmfs/bin/mmksh
	  and /usr/lpp/mmfs/bin/mmpmon are found on the	system.
	  However, if GPFS is present but switched off,	then it	can
	  get confused.	 Use:
	  export NOGPFS=1
	  to set a shell variable before running njmon or nimon	will
	  disable GPFS stats.
	  You can at compile time disable GPFS support with: -D	NOGPFS

	  NIMON	to change the POST REST	API command PREFIX

	  NIMON	mode
	   Set shell variable NJMON_INFLUX_API_PREFIX before starting
	  njmon.  This string is added before the    REST API "/write"
	  command.  This addition was requested	by a VictoriaMetrics
	  user using proxy servers.
	  Example: export     NJMON_INFLUX_API_PREFIX=/abc/def then
	  start	nimon
	  And "POST /write?db..."  becomes   "POST
	  /abc/def/write?db..."

     EXAMPLES for using	njmon
	  1 Simple use
	  Every	minute (60 seconds), all day (1440 minutes), njmond
	  server hostname and port 8181.
	  1 Syntax
	  njmon	-s 60 -c 1440 -i centralbox -p 8181

	  2 Piping the JSON output into	a data handler
	  Every	1 minute (-c 60) all day (1440 minutes in a day),
	  InfluxDB server hostname influxbox, default InfluxDB port
	  (-p 8086) and	username /password.
	  2 Syntax
	  njmon	-s 60 -c 1440 |	myprog

	  3 Add	process	statistics and remove Logical Volume Manager
	  and Volume Group statistics
	  Add process statistics (-P) and remove LV + VG data (-LV).
	  3 Syntax
	  njmon	-s60 -c	1440 -PLV -i centralbox	-p 8181

     Page 9					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  4 Every half minute
	  Collect statistics every 30 seconds (-s 30) and all day
	  (2880	half minutes in	a day).
	  4 Syntax
	  njmon	-s30 -c	2880 -i	centralbox -p 8181

	  5 Add	VIOS statistics
	  Adding VIOS extra statistics for virtual resources and
	  including SSP, requires the njmon version with VIOS
	  statistics support compiled in.  Use the default port	number
	  of 8181.
	  5 Syntax
	  njmon	-s30 -c	2880 -vuU -i centralbox

	  6 Using crontab
	  Crontab entry	starts at 4 minutes after midnight, saves data
	  every	30 seconds for a day.  Use the default port number of
	  8181 and database name of "njmon".
	  6 Syntax
	  4 0 *	* * /usr/lbin/njmon -s30 -c 2880 -vuU -i centralbox
	  2>/dev/null

	  7 Crontab with kill option
	  Crontab entry	starting hourly	and checking if	the previous
	  njmon	is still running (if it	is, this njmon stops itself).
	  This uses a PID file called /tmp/njmon.pid.  Use the default
	  port number of 8181 and database name	of "njmon".
	  7 Syntax
	  0 * *	* * /usr/lbin/njmon -s 60 -k -i	centralbox 2>/dev/null

	  8 Using a PID	file
	  Naming a PID file so it is not in /tmp, which	might be
	  erased by some cleanup script.  Use the default port number
	  of 8181 and the database name	of "njmon".
	  8 Syntax
	  0 * *	* * /usr/lbin/njmon -s 60 -K /home/nag/njmon.pid -i
	  centralbox 2>/dev/null

	  9 Saving to a	local file
	  Save the njmon data to a file	(-f). Here is a	quick 5
	  minutes worth	of data.  This file can	be loaded into
	  InfluxDB later with njmon2influx.py. The two files will end
	  .err and .influxlp (lp = Line	Protocol).
	  9 syntax
	  njmon	-s 10 -c 30  -f

	  10 Getting njmon to change to	a specific current directory
	  njmon	moves to the directory /tmp before creating any	files.
	  Save the njmon data to a file	(-f). This can be loaded into
	  InfluxDB later.  This	is good	practice when using crontab.
	  10 Syntax
	  njmon	-s 60 -c 1440 -m /tmp -f

     Page 10					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  11
	  Use "ssh" to start the njmon agent on	a remote endpoint,
	  return the data over a secure	socket and pipe	it into	the
	  InfluxDB.  Capturing every 15	seconds.
	  11 Syntax
	  0 * *	* * /usr/lbin/njmon -s 15 -c 5760 | /usr/bin/ssh
	  fred@ibox /usr/lbin/njmon2influxturbo.py

	  12 Using a conf file
	  Use a	configuration file to contain the njmon	arguments.
	  This means the arguments are not seen	in the "ps" command
	  output, which	is good	for security.  Use the -a argument-
	  file option.
	  12 Syntax
	  Example command line:	/usr/lbin/njmon	-a /etc/njmon.conf
	  12 Config file
	  An example /etc/njmon.config file contains just the options:
	  -s 60	-c 1440	-i centralbox -O Acme -T
	  hduUKdyJH&kdueb123&...

	  13 What version of njmon am I	running?
	  Output the njmon version details and stop.  Good for a quick
	  installation check.
	  13 Syntax
	  njmon	-!

	  14 Add command line argument statistics

	  Run njmon and	include	the process stats with the command
	  line arguments details per process.
	  14 Syntax
	  njmon	-s 30 -c 2880 -PP -f

     EXAMPLES for using	nimon
	  1 Simple use
	  Every	minute (60 seconds), all day (1440 minutes), InfluxDB
	  server hostname, default InfluxDB port (8086), database
	  njmon.
	  1 Syntax
	  nimon	-s 60 -c 1440 -i influxbox -x njmon

	  2 With user &	password
	  Every	1 minute (-c 60) all day (there	are 1440 minutes in a
	  day),	InfluxDB server	hostname influxbox, InfluxDB port (-p
	  8086)	and username and password.
	  2 Syntax
	  nimon	-s 60 -c 1440 -i influxbox -p 8086 -x njmon -y Nigel
	  -z passw0rd

	  3 Request process and	Logical	Volume stats
	  Add process stats and	remove LVM data	- assuming the

     Page 11					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  database of njmon and	the InfluxDB port of 8086
	  Add process statistics (-P) and remove LV + VG data (-LV).
	  3 Syntax
	  nimon	-s60 -c	1440 -PLV -i influxbox

	  4 A typical nimon use
	  Every	half minute with a non-default port of 8888 (this
	  would	have to	be configured in the InfluxDB setup).
	  Collect statistics twice a minute (-s	30) and	all day	(2880
	  half minutes in a day).
	  4 Syntax
	  nimon	-s30 -c	2880 -i	influxbox -p 8888 -x njmon

	  5 Add	VIOS statistics
	  Note:	these statistics are only possible on a	Virtual	I/O
	  Server.
	  Adding VIOS extra statistics for virtual resources and
	  including SSP	- requires nimon version with VIOS support
	  compiled in.
	  5 Syntax
	  nimon	-s30 -c	2880 -vuU -i influxbox

	  6 Using crontab
	  Crontab entry	starts at 4 minutes after midnight, save data
	  every	30 seconds for a day.
	  Using	defaults for the InfluxDB database name	(njmon)	and
	  Influx port (8086).  The -n stops the	 process id (PID)
	  being	output as this would generate an email.
	  6 Syntax
	  4 0 *	* * /usr/lbin/nimon -s30 -c 2880 -i influxbox -n
	  2>/dev/null

	  7 Crontab with kill option
	  Crontab entry	starting hourly	and checking if	the previous
	  nimon	is still running (if it	is, this nimon stops itself).
	  This uses a PID file called /tmp/nimon.pid.
	  7 Syntax
	  0 * *	* * /usr/lbin/nimon -s 60 -k -i	influxbox -n
	  2>/dev/null

	  8 Using a PID	file
	  Naming a PID file so it is not in /tmp as this might which
	  might	be erased by a cleanup script.
	  8 Syntax
	  0 * *	* * /usr/lbin/nimon -s 60 -K /home/nag/nimon.pid -i
	  influxbox -n 2>/dev/null

	  9 Saving to a	local file
	  Save the nimon data to a file	(-f).  This file can not be
	  loaded into InfluxDB due to it not having a time and date
	  stamp.  The data and time are	added by InfluxDB as the data
	  is loaded.  The two files will end .err (for errors) and

     Page 12					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  .influxlp (lp	= Line Protocol).
	  Note:	nimon Line Protocol format files are much easier to
	  read with an editor like "vi". JSON format does not include
	  any Line-feed	characters without using a Python script to
	  reformat to pretty Python format.
	  9 Syntax
	  nimon	-s 10 -c 30  -f

	  10 Getting nimon to change directory
	  nimon	changes	the current directory tp /tmp before creating
	  any files.  Save the nimon data to a file (-f).  This	stops
	  any files from being created in the user's top level
	  directory.
	  The second -f	option adds the	timestamp to the end of	each
	  line of stats.
	  This can be loaded into InfluxDB later.
	  10 Syntax
	  nimon	-s 60 -c 1440 -m /tmp -ff

	  11 Telegraf, Prometheus, elastic and Splunk support
	  Send data to Telegraf	and then onto Prometheus, elastic
	  (also	called ElasticSearch or	ELK) or	Splunk.	 You will have
	  to setup Telegraf on the AIX running nimon with an InfluxDB
	  input	plugin and an output plugin of type Prometheus (or
	  other	services).
	  Then point Prometheus	at the Telegraf	server to collect the
	  data.	 Similar for elastic and Splunk.
	  11 Syntax
	  nimon	-s 15 -c 5760 -w -i telegraf_server -p 8888

	  12 Using a conf file
	  Using	a configuration	file to	contain	the nimon command
	  arguments.  This means the arguments are not seen in the
	  "ps" command output.	This is	good for security as it	hides
	  the password or InfluxDB Token.  Use the -a argument-file
	  option.
	  12 Syntax
	  Example command line:	/usr/lbin/nimon	-a /etc/njmon.conf
	  12 An	example	/etc/njmon.config file contains	just the
	  options:
	  -s 30	-c 2880	-i influxbox -O	MyOrg -T djJYb5622!&*^@...

	  13 What version of nimon am I	using?
	  Output the nimon version details and stop
	  13 Syntax nimon -!

	  14 Simple example of using InfluxDB 2+.
	  Note:	that the Token is really much larger than in this
	  example.  For	security, using	the "-a	file" option would
	  hide the Token from the "ps" command.
	  14 Syntax
	  nimon	-k -s 30 -i influx_hostname -O IBM -T HyS7g1TT-...KK==

     Page 13					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  15 Requesting	full CLI details for running programs
	  Request nimon	to include the command line arguments.	Look
	  for "cmdline"	stats within the process statistics.
	  15 Syntax
	  nimon	-s 30 -c 2880 -PP -i influxbox

     SIGNALS
	  Dynamically, toggle on verbose debug output using SIGUSR1.
	  This is good for problem determination and njmon
	  development.

	  kill -USR1 <njmon-pid>

     FILES
	  /usr/lbin/njmon The executable command

     SEE ALSO
	  njmon(1)
	  njmon	is like	nimon but outputs JSON data.

	  nimon(1)
	  nimon	is like	njmon but outputs InfluxDB Line	Protocol data.

	  ninstall
	  A simple shell script	supplied with njmon to install njmon &
	  nimon	and manual pages with the right	file permissions.

	  nmeasure
	  Separate command to allow users to add their own statistics
	  to the njmon InfluxDB	database for graphing along side njmon
	  data.

	  Online njmon Manual website
	  See
	  http://nmon.sourceforge.net/pmwiki.php?n=Site.NjmonManualPage

	  njmon	Download Project website
	  http://nmon.sourceforge.net/pmwiki.php?n=Site.Njmon

	  AIXpert Blog Articles	on nimon and njmon
	  https://ibm.biz/AIXpertBlog

	  perfstat Library website
	  This is the source of	most of	the statistics documentation
	  https://www.ibm.com/support/knowledgecenter/ssw_aix_73/filesreference/libperfstat.h.html

	  Grafana dashboards (assuming InfluxDB	hold the data)
	  https://grafana.com/grafana/dashboards?search=njmon

     Page 14					    (printed 1/17/26)

     njmon & nimon(1)	       (AIX and	VIOS)	      njmon & nimon(1)

	  Other	open source tools from Nigel Griffiths
	  https://mr-nmon.com

     AUTHOR
	  Nigel	Griffiths  @mr_nmon nigelargriffiths@hotmail.com

     BUGS
	  None,	of course.  But	just in	case, please report issues to
	  the author by	email.

     Page 15					    (printed 1/17/26)