UPSSTATS.HTML(5) NUT Manual UPSSTATS.HTML(5)
>>> (NAME)
upsstats.html - >>>> HTML >>>> >>>>>
>>> >> upsstats >> Network UPS Tools
>>>>>>> (DESCRIPTION)
>>> >>>>> > >>>> >>>>>>>>>
upsstats-single.html >>>> >>>> >>>>>
>>>>>> >>>> >>>> upsstats.cgi(8) >>>
>>>>> >>>>> >>>>> CGI >> NUT
>>>>>>> >>>>>>>. >>>>>>>
>>>>> >>>>>>> >>> > >> >>>>
>>>>>>> >> >>>>> >>>>>>>
>>>>> >>>>>>> >>>>>> >>.
>> >>>>> >> >>>>> >>>>>>>
>>>> >>>> >>>>> >> >>>>>
@NUT_UPSSTATS_TEMPLATE@ >>>> >>>.
>>>> >>>>>> >>>>> >> >>>>
>>>>>>>> >>>> >>>>>>>>>>
>>>>>>>> >>> >>>>>
>>>>>>>>>> CGI >> NUT> >>>>> >>
>>>> >>>>>>> upsset.conf(5) >>>>>>
>>>>.
>>>>
>>> >>>> >>>> >>>> >>
>>>> >>>>>>>> NUT >>>>
>>>>. >>> >> >> >>>>>>
>>>>>>> >> >> >>>>>>>>>
>>>>>>> >>>>>>> >>
>>>>>>> >> >>>>
>>>>>>>>>> >>>>>>>>> >>
>>>>>>>> cgi-bin >>>>>>> >>>
>>>>>>> >>>>>>> (>>>>>
>>>>>>>> NUT >>>> >>>>>> >>
>> >>> >>>>>>> >>>>>> >>
>>>> >> >> >>>>>> >>>>>
>>>>>>>)> >>>> >>>> >>>>>
>>>>> NUT_CONFPATH >> >> >>>>>>>
>> >>> >>>> >>>>.
>>>>
>> >>>>>>>>>>> >>
>>>>>>>> >>>>>> >>>> >>>
>>>>>>>> >>>>>>> >>>>>
>>>>>>> >>>> >>> >>>>>
>>>> >> >>>>> >>>> >>
>>>>> *.cgi.exe >>>> >>>>>>>>>
>> >>>>>>>> >>>> HTML
>>>>>>> >>>> (>>>>> UPSSTATSPATH
> UPSIMAGEPATH).
>>>>>>>>> (FORMATTING)
>>>>>>> >>>>>>>>> >> >>
>>>> >> >> >>>> >>>>>> >>>
>>>> >> @ >>>> >>> > >> @
>>>>> >>>>>.
>>>>>> >>>>> >>>>> >>> >>
>>> >> >>>>>>> >>>> >>>>>
>>>> >>>> >>>>> >>.
>>>>>>> >> >>> >> >> >>>>>
>> >> >> >>>> >>>> >>>>>>
>> >> >>>>> >>>>> >>>>>
>>>> > >>>>> >>>> >> >>>
>>>>.
>>> >>>> >> >>>>>>> >>
>>>>> @ >>>>>> >> >>>>>>> HTML
>> >>>> @ >>>>>>> >>>> >>
>> >>>>> >>>>> >>>> >>>>
>>>>.
>>>>> >>>> (BLOCK CONTROL)
>>>> >>>>>>> >>>>>>> >>
>>>> >>>>>>> -- >>>>>>>> >>
>>>> >> >>>> >> >>>>>>>>>>
>>>>> >>>>>>>> >>> >>
>>>>> >>>>>>>.
>>>>> >>>> - >>>>> (BLOCK CONTROL - ITERATION)
@FOREACHUPS@
>>>>> >> >>>> >>>>>> >>
>>>> >> >>>>>>>>>> MONITOR >>
hosts.conf(5) >>>>> >>>>> >>. >>
>>> >>>>> >>>>>>>>>
>>>>>> >>>>> >>>> >>
>>>>> >>>>>>>>> >>> >> >>
>>>> >>>>>> >>>>>
>>>>>>>.
@ENDFOR@
>> >> >>>> FOREACHUPS >>>>>
>>>>>>.
>>>>> >>>> - >>>>> >>>>> >>>
(BLOCK CONTROL - MATCHING SPECIFIC CASES)
@IFSUPP var@*
>>>>> >> >>>> >>>>>> >>
>>> >> >>>> >>>>>>>>
>>>>> var >>>> >>>>>>> >>>>
>>> >>>>> >>. >>> >>>>>
>>>>>> >>>> >>>>>>> >>
>>>>> >>>>>>>> "not supported" >>
>>>>>> >>>> >> >>>>>>>>
>>>>> > >>>>> >> >>>
>>>>>>.
@IFEQ var value@
>>>>> >> >>>> >>>>>> >>>
>>>>> >>>>>>>>>>>>>> >>
>>>>> var >> value >>>>>> >>>>>
>>>>.
>>>>
>>>>>>>>> >> @IFEQ upsstats.use_celsius
(0|1)@ >>>> >>>>> >>>>>
>>>> >>>> >>>>> >>>>>
@TEMPC@ >> @TEMPF@ >>>>>>> >>>>.
@IFBETWEEN varlow varhigh varvalue@
>>>>> >> >>>> >>>>>> >>>
>>>>> >>>>>>>>>>>>>>
>>>> >>>>> varvalue >>> >>>>>>
>>>>>>>>>>>>>> >>>>
>>>>>>>> varlow > varhigh >>>>.
@ELSE@
>>> >>>>> IF >>>> >>>>>>
>>>>>> >> >>> >> >>> >>>
>> >>>> >>>>>>.
@ENDIF@
>> >> >>>> IF/ELSE >>>>>
>>>>>>.
>>>>> >>>> - >>>>>> >>>>>>>
(BLOCK CONTROL - ADVANCED EXPRESSIONS)
>>>>> >>>>>>>>>>> >>
>>>>> >>>>> >>>> >>>
>>>>>> >>>>> >>>> >>>>>>
>>>>>> >>>>>>> >>>> >>>>.
>>>> >>>>>>> >> >>> >>>>
>>> >>>>>> >>> >> >>> >>>>>
>>>>> >>>> >> >>>>>> AND
>>>>>>>. >>> >>>>>> >> >>
>>>> >>> >>>> >>> >>>
(>>>>>>>> >>>>> >> upsstats.html
>>>>> >>>).
@IFSUPP ambient.humidity@
@IFSUPP ambient.temperature@
>>> >>>>>>> >> >>>> >>>> > >> >>>>> >>>> >> >>>>>>>>.
@ELSE@
@IFSUPP ambient.humidity@
>>> >>>>>>> >>> >>>>> >>>> >> >>>>>>>>.
@ELSE@
@IFSUPP ambient.temperature@
>>> >>>>>>> >>> >>>> >>>> >> >>>>>>>>.
@ELSE@
>>> >>>>>>> >>>> >>>>>>>>> >> >>>>>>>>>.
@ENDIF@
>>>> >>>>>>> (OTHER COMMANDS)
@NUT_UPSSTATS_TEMPLATE [args]@
>>>> >>>> >>>>>>> >>>>
>>>>>> >> @NUT_UPSSTATS_TEMPLATE@ >>
@NUT_UPSSTATS_TEMPLATE Some text@ >>>> >>> >>
upsstats.cgi(8) >>>>> >> >>>>>
>>>>>>>> >>>>>> >>>>.
>> >>> >>>> >>> >>>>> >
>>>>>>>>>>> >> >>>>>>
>>>>> >>>>>>>> >>>>>>>>
>>>>>>>>> >>>>> >> NUT >>
>>>>>> >>>>>>> "default" > "single"
>>>>> >> >>>>> >>>>>>>>
>>>> >>>>>>>>>>> >
>>>>>>>> >>>>>>>
>>>>>>>.
@UPSSTATSPATH filename@
>>>>> URI >>>> >>>>>> upsstats.cgi(8)
>> >> >>>>>>> HTML >>>>
>>>>>>>. >>>> >>>>>>> >>>
>>>>>> >>> >> >> >> >>
>>>>>> >>>> >> >>>> >>
>>> >>>>> >> >>>>>> >>>>>
>>>>>>.
>>>> >>> >>>> >>>> >>>>>
>>> >>>> >>>>>> >>>> >>
>>>>>> >> >>> >>>> >>>>
>>>>> @UPSSTATSPATH upsstats.cgi.exe@
@UPSIMAGEPATH filename@
>>>>> URI >>>> >>>>>> upsimage.cgi(8)
>> >> >>>>>>> HTML >>>>
>>>>>>>. >>>> >>>>>>> >>>
>>>>>> >>> >> >> >> >>
>>>>>> >>>> >> >>>> >>
>>> >>>>> >> >>>>>> >>>>>
>>>>>>.
>>>> >>> >>>> >>>> >>>>>
>>> >>>> >>>>>> >>>> >>
>>>>>> >> >>> >>>> >>>>
>>>>> @UPSIMAGEPATH upsimage.cgi.exe@
@AMBTEMP@
>>> >>>> >>>> >> >>>>>
>>>>> >>>>.
@DATE format@
>>> >>>>> > >>>> >>>>.
>>>> >>>>>>>>> >> strftime
>>>>> >>>>>>> >>>>>>>>
>>>>>>> >> >>>>>
>>>>>>>>>> >>>. >>>>
>>>>>> >>>> >> strftime(3)
>>>>>> >>>>.
@DEGREES@
>>> >>>>> >>>>>>> >>>>
>>>> () > >>> C >> F >>>>
>> >>>>> >>>> >>>>.
@HOST@
>>> >>>>> >>>>>>> >>
>>>>> >>>>>>> >>>>>
myups@localhost.
@HOSTDESC@
>>> >>> >>>>>> >> hosts.conf(5).
@HOSTLINK@
>>> >> >>>>> HTML >> upsstats.cgi(8) >>
>>>> >> >>>>> "host" >>>
>>>>>>> >>>> >>>>> >>>
>>>. >>> >>>>> >>>> >>>>
>> >>>> FOREACHUPS >>>>>> >>>>.
@TREELINK [Link text]@
>>> >> >>>>> HTML >> upsstats.cgi(8) >>
>>>> >> >>>>> "host" >>>
>>>>>>> >>>> >>>>> >>> >
"treemode" >>>> >>>>> >>>> >>>>
>>>> >> >>>> >> >>>> HTML
>>>> >>>. >>> >>>>> >>
>>>> >>> >>>> >> >>>> FOREACHUPS
>>>> >>>> >>> >> >>>>>
>>>>>> >> upsstats-single.html >>>
>>>>>> >>>>. >> >>>>> >>
"Link text" >>>>> >>>>> >>>>>
>>>>>>> >> "All data" >>>>> >>>.
@TREELINK_JSON [Link text]@
>>> >> >>>>> HTML >> upsstats.cgi(8) >>
>>>> >> >>>>> "host" >>>
>>>>>>> >>>> >>>>> >>> >
"treemode" >>>> >>>>> >>>> >>>>
>>>> >> >>>> >> >>> JSON >>>>
>>>. >>> >>>>> >> >>>> >>>
>>>> >> >>>> FOREACHUPS >>>>
>>>> >>> >> >>>>> >>>>>>
>> upsstats-single.html >>> >>>>>>
>>>>. >> >>>>> >> "Link text"
>>>>> >>>>> >>>>>
>>>>>>> >> "JSON" >>>>> >>>.
@IMG varname @
>>> >> >> IMG SRC >> upsimage.cgi(8) >>>>
>>> >> >>> >>>>>>>>
>>>>>:
battery.charge
>>>> >>>>> -- >> >>> >>>>
battery.voltage
>>>>> >>>> >>>>> >> >>>
>>>
input.frequency
>>>>>> >>> >>>>> (>>>>)
input.voltage
>>>>> >>> >>>>>
input.L1-L2.voltage
>>>>> >>>>>> L1-L2 (>> >>>)
input.L2-L3.voltage
>>>>> >>>>>> L2-L3 (>> >>>)
input.L3-L1.voltage
>>>>> >>>>>> L3-L1 (>> >>>)
output.frequency
>>>>>> >>> >>>>> (>>>>)
output.voltage
>>>>> >>>>> (>> >>>>>>>)
output.L1-L2.voltage
>>>>> >>>>>> L1-L2 (>> >>>)
output.L2-L3.voltage
>>>>> >>>>>> L2-L3 (>> >>>)
output.L3-L1.voltage
>>>>> >>>>>> L3-L1 (>> >>>)
output.L1.power.percent
>>> >>>>>>>> L1 (>> >>>)
output.L2.power.percent
>>> >>>>>>>> L2 (>> >>>)
output.L3.power.percent
>>> >>>>>>>> L3 (>> >>>)
ups.load
>>> >>>>>>> -- >> >>>
>>>>
ups.temperature
>>>> >>>>>>>
>>> extra >>>> >>> >>
>>>>>>>>> >>>>>> >>>>> >>
>> >> >>>> >>>>. >> >>> >>>>
>>>>>> >>>>>> >>>>>> >>>>
>>>>>>> >>>>> >>>>>>>
>>>>>>> >>>> upsimage.cgi(8) >>>>>.
>>>>>>> >>>> >>> >>>>>>>
>>:
back_col
>>> >>>>>>>>
scale_num_col
>>> >>>>>>>>> >>>>>
summary_col
>>> >>>>> (>>> >> >>>>>)
ok_zone_maj_col
>>> >>>>> >>>> >>>> >>>>>
>>>> ("ok")
ok_zone_min_col
>>> >>>>> >>>> >>>> >>>>>
>>>> ("ok")
neutral_zone_maj_col
>>> >>>>> >>>> >>>> >>>>>
>>>>
neutral_zone_min_col
>>> >>>>> >>>> >>>> >>>>>
>>>>
warn_zone_maj_col
>>> >>>>> >>>> >>>> >>>>>
>>>>>
warn_zone_min_col
>>> >>>>> >>>> >>>> >>>>>
>>>>>
bar_col
>>> >>>> >> >>>
>>>> >>>>>> >>>>>>>>>>>
>>>>>>>>>> >>>>> -- >>>>>
0xff0000 >>>> >>>>> 0x00ff00 >>>> >>>
> 0x0000ff >>>> >>>.
>>>>>>>:
@IMG battery.charge@
@IMG battery.charge back_col=0xff00ff bar_col=0xaabbcc@
@IMG input.voltage ok_zone_maj_col=0x123456@
@REFRESH@
>>> >>>>> >>> META >>>>
>>>>>>>>> >>>> >> >>>>>
>> >>> >>>>> >>>> >>>>>>
>>>>> >>> >>>>. >>> >>>>>
>>>> >> >>> HEAD >>>> >>>>
>>>>.
@STATUS separator@, @STATUS@
>>>>> >>>>>>>> >> >>>>>
ups.status -- >>>>> OL >> "On line">
>>>>> OB >> "On battery" > >>>>>
>>>> >>>>> >>>>>>. >>>>>>
>>>>>>>>> >>>> >>>>>>>>
>>>>>>> >>>>>>>> >>>
>>>>>>> (
>>> >>>> >>>>
>>>>)> >> >> >>>>> >>>> >>
>> "STATUS" >>>> >>>>>> (>>
>>>>> >>>>> >>
>>>>>>>>>> @STATUS @ >>>> >>>
>>>> >>>>>> >> >>>>>>
>>>>>>> >>>>>>> >>>> >>
@STATUS @ >>>> >>>>>>> >>
>>>>>).
@STATUSCOLOR@
>>> >>>>>>>>>>> >>>
>>>>> >>> >> >>> >>>> >>
>>> >>>>> >>>> >>>>>>>.
>>>>>> >>>> >>> >>>>
>>>>>>>>> >>>>> >>>>> >>
>>>> >>>>> (trim/boost) >> "off" >>>
>>>>>> > >>>>>>>>> >>>>
>>>>> >>> >>> >>>>> >>
>>>>> >>>> >>>> >>>>>.
@VAR varname@
>>> >>>>> >>>> >>>>>
>>>>> varname >> >>>>>> >>>
>>>>>> >> >>>>> "Not supported".
@RUNTIME@
>>> >>>> >>>>>> >>>>> >>
>>>> hh:mm:ss.
@TEMPC@
>>>>>>> >> >>>>> >>>>>>
>>>> >>>>>>>> >>>
(>>>>>>>).
@TEMPF@
>>>>>>> >> >>>>>
>>>>>>>> >>>> >>>>>>>>
>>>.
@UPSTEMP@
>>> >>>> >>>>>>> >> >>>>>
>>>>.
@BATTTEMP@
>>> >>>> >>>>> >> >>>>>
>>>>.
@UTILITYCOLOR@
>>>>> >>> >>>. >> >>> >> >>
IFBETWEEN >>>>>>> >>>> (>>>>
>>>>> >> upsstats.html >> >>>>>>).
@VERSION@
>>> >>>>> >>>> >>>>>>>>>.
>>>> >>>>>>> (OTHER TEMPLATES)
upsstats.cgi(8) >>>>>> >>>>> >> >>>
upsstats-single.html >> >> >>>>
>>>>>>>> >> >>>>> host=
>>>>>>>>> >> URL >>> >>>>>
>>>. >> >>>> >> >>>> >>>>>>
> >>>>>>>>> >>>>>>>> >>
>>>>> >>>>>>> >>>>>>.
>>>>>> >>>>>> (SEE ALSO)
upsstats.cgi(8), upsimage.cgi(8)
>>>>> >>>>>>>>: (Internet resources:)
>>>> >>>> NUT (Network UPS Tools):
https://www.networkupstools.org/historic/v2.8.5
Network UPS Tools 2.8.5 06/21/2026 UPSSTATS.HTML(5)