UPSLOG(8) Network UPS Tools (NUT) UPSLOG(8)NAMEupslog - UPS status logger
SYNOPSISupslog-h
upslog ups logfile interval [format]
DESCRIPTIONupslog is a daemon that will poll a UPS at periodic inter-
vals, fetch the variables that interest you, format them,
and write them to a file.
The default format string includes variables that are sup-
ported by many common UPS models. See the description
below to make your own.
OPTIONS-h Display the help message.
ups Monitor this UPS. The format for this option is
[upsname@]hostname[:port].
logfile
Store the results in this file.
You can use - for stdout, but upslog will remain in
the foreground.
interval
Wait this many seconds between polls.
Remember that a poll is not instantaneous, so it
will slip back as the program runs. If you require
tighter timing, you should write your own logger
using the upsclient library.
format The string to log, including variables from the
UPS. Valid escapes within this string are:
%% - insert a single %
%TIME format% - insert the time with strftime for-
matting
%ETIME% - insert the number of seconds, ala time_t.
This is now a 10 digit number.
%HOST% - insert the local hostname
%UPSHOST% - insert the host of the UPS being moni-
tored
%PID% - insert the pid of upslog
%VAR varname% - insert the value of variable
varname
The default format string is:
%TIME @Y@m@d @H@M@S% %VAR battpct% %VAR utility%
%VAR loadpct% [%VAR status%] %VAR upstemp% %VAR
acfreq%
SERVICE DELAYS
The interval value is merely the number given to sleep()
after running through the format string. Therefore, a
query will actually take slightly longer than the interval
depending on the speed of your system.
LOG ROTATIONupslog writes its pid to upslog.pid, and will reopen the
log file if you send it a SIGHUP. This allows it to keep
running when the log is rotated by an external program.
SEE ALSO
Server:
upsd(8)
Clients:
upsc(8), upscmd(8), upsrw(8), upsmon(8)
Internet resources:
The NUT (Network UPS Tools) home page:
http://www.exploits.org/nut/
NUT mailing list archives and information:
http://lists.exploits.org/
Wed Oct 16 2002 UPSLOG(8)
