nut-recorder(8)

nut-recorder8

Utility to record device status and values changes

Usage

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

Overview

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

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

Author

Arnaud Quette

From nut 2.8.5-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.