1NUT-RECORDER(8)                   NUT Manual                   NUT-RECORDER(8)
2
3
4

NAME

6       nut-recorder - utility to record device status and values changes
7

SYNOPSIS

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

DESCRIPTION

12       nut-recorder is an utility to record sequences from running devices
13       (such as power failures, or any other value changes) from upsd, and
14       dump it in a .seq format.
15
16       The .seq file can then be used by the dummy-ups(8) driver to replay the
17       sequence.
18

OPTIONS

20       device-name
21           Record the changes of this device. The format for this option is
22           devname[@hostname[:port]]. The default hostname is "localhost".
23
24       output-file
25           Optional. Data will be saved to this file. The default is
26           dummy-device.seq.
27
28       interval
29           Optional. The status of the device will be checked every interval.
30           The default is 5 seconds.
31

EXAMPLES

33       To record data from ups1@host1 every 10 seconds:
34
35           $ nut-recorder ups1@host1' ups1-output.seq 10
36           . . .
37           battery.charge: 100.0
38           battery.voltage: 13.9
39           battery.voltage.nominal: 13.6
40           ups.status: OL
41           . . .
42           battery.charge: 90.0
43           ups.status: OB
44           . . .
45
46       You can then define a dummy device in ups.conf(5):
47
48           [ups-test]
49                   driver = dummy-ups
50                   port = ups1-output.seq
51

AUTHOR

53       Arnaud Quette
54

SEE ALSO

56   The dummy-ups driver:
57       dummy-ups(8)
58
59   Internet resources:
60       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
61
62
63
64Network UPS Tools 2.8.0           04/26/2022                   NUT-RECORDER(8)