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
       sequence.

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

       output-file
	   Optional. Data will be saved	to this	file. The default is
	   dummy-device.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.2.	  04/17/2025		       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+14.3.quarterly>

home | help