nut-recorder - Man Page

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/historic/v2​.8​.5/

Info

10/07/2026 Network UPS Tools 2.8.5 NUT Manual