Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NUT-RECORDER(8) 		   NUT Manual			 NUT-RECORDER(8)

NAME
     nut-recorder - Utility to record device status and values changes

SYNOPSIS
     nut-recorder device-name [output-file] [interval]

DESCRIPTION
     nut-recorder  is  an utility to record sequences from running devices (such
     as power failures, or any other value changes) from  upsd(8)  data  server,
     and dump it in a .seq format.

     The .seq file can then be used by the dummy-ups(8) driver to replay the se-
     quence.

OPTIONS
     device-name
	 Record  the  changes of this device. The format for this option is dev-
	 name[@hostname[:port]]. The default hostname is "localhost".

     output-file
	 Optional. Data will be saved to this file.  The  default  is  dummy-de-
	 vice.seq.

     interval
	 Optional.  The status of the device will be checked every interval. The
	 default is 5 seconds.

EXAMPLES
     To record data from ups1@host1 every 10 seconds:

	 :; nut-recorder ups1@host1' ups1-output.seq 10
	 . . .
	 battery.charge: 100.0
	 battery.voltage: 13.9
	 battery.voltage.nominal: 13.6
	 ups.status: OL
	 . . .
	 battery.charge: 90.0
	 ups.status: OB
	 . . .

     You can then define a dummy device in ups.conf(5):

	 [ups-test]
		 driver = dummy-ups
		 port = ups1-output.seq

AUTHOR
     Arnaud Quette

SEE ALSO
   The dummy-ups driver:
     dummy-ups(8)

   The logging daemon:
     upslog(8)

   Internet resources:
     The NUT (Network UPS Tools) home page: https://www.networkupstools.org/

Network UPS Tools 2.8.5.	   08/04/2026			 NUT-RECORDER(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nut-recorder&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help