MRTG APC UPS battery info

MRTG APC UPS battery info

In addition to the APC PDU’s which you can graph nicely to see the power usage, it is also possible to graph a UPS so you can monitor the UPS with mrtg.

In this case I will be using a APC Smart-UPS VT 40 which supports graphing the battery temperature, battery capacity, input & output frequency, minimum & maximum line voltage and the reason why the UPS switched to battery (see below for a example)

First create your MRTG config dir in /etc/ if it doesn’t exists yet and create a mrtg dir in your www root (in my case /var/www) the name of the UPS I will be monitoring is ‘UPS001’.

trouble@sun:$ sudo mkdir /etc/mrtg
trouble@sun:$ sudo mkdir -p /var/www/mrtg/UPS001

Then create the mrtg config file: /etc/mrtg/APC001.cfg and add the following content:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

WorkDir: /var/www/mrtg/UPS001
 
################################
# Battery temperature
################################
 
Target[batt-temp]: 1.3.6.1.4.1.318.1.1.1.2.2.2.0&1.3.6.1.4.1.318.1.1.1.2.2.2.0:COMMUNITY@YOUR.APC.IP
Directory[batt-temp]: apc_ups
MaxBytes[batt-temp]: 100
Title[batt-temp]: APC-UPS Temperature
PageTop[batt-temp]: <H1>APC-UPS Temperature</H1>
Options[batt-temp]: growright, gauge, nopercent, absolute
YLegend[batt-temp]: Temp
Legend1[batt-temp]: Temperature
Legend2[batt-temp]: .
Legend3[batt-temp]: Max value per interval on graph
Legend4[batt-temp]: .
LegendI[batt-temp]: UPS Battery Temperature
LegendO[batt-temp]: . 
 
 
################################
# Battery capacity
################################
 
 
YLegend[batt-cap]: Percent
ShortLegend[batt-cap]: %
Directory[batt-cap]: apc_ups
Legend1[batt-cap]: Battery Capacity
Legend2[batt-cap]: Load
Legend3[batt-cap]: Max Capacity
Legend4[batt-cap]: Max Load
LegendI[batt-cap]: Battery Capacity
LegendO[batt-cap]: Load
WithPeak[batt-cap]: ywm
Unscaled[batt-cap]: dwmy
MaxBytes[batt-cap]: 110
Options[batt-cap]: growright, gauge, nopercent
Title[batt-cap]: APC Battery Capacity & Load
Target[batt-cap]: 1.3.6.1.4.1.318.1.1.1.2.2.1.0&1.3.6.1.4.1.318.1.1.1.4.2.3.0:COMMUNITY@YOUR.APC.IP
PageTop[batt-cap]: <H1>Battery Capacity & Load</H1>
 
################################
# Input & output frequency
################################
 
 
YLegend[batt-iofreq]: Hertz
ShortLegend[batt-iofreq]: Hz
Directory[batt-iofreq]: apc_ups
Legend1[batt-iofreq]: Input Frequency
Legend2[batt-iofreq]: Output Frequency
Legend3[batt-iofreq]: Max Input Frequency
Legend4[batt-iofreq]: Max Output Frequency
LegendI[batt-iofreq]: Input Hz
LegendO[batt-iofreq]: Output Hz
WithPeak[batt-iofreq]: ywm
MaxBytes[batt-iofreq]: 100
Unscaled[batt-iofreq]: dwmy
Options[batt-iofreq]: growright, gauge, nopercent
Title[batt-iofreq]: APC Input & Output Frequency
Target[batt-iofreq]: 1.3.6.1.4.1.318.1.1.1.3.2.4.0&1.3.6.1.4.1.318.1.1.1.4.2.2.0:COMMUNITY@YOUR.APC.IP
PageTop[batt-iofreq]: <H1>APC Input & Output Frequency</H1>
 
################################
# Minimum & Maximum line voltage
################################
YLegend[batt-mimaxline]: Volts AC
ShortLegend[batt-mimaxline]: VAC
Directory[batt-mimaxline]: apc_ups
Legend1[batt-mimaxline]: Minimum Line Voltage
Legend2[batt-mimaxline]: Maximum Line Voltage
Legend3[batt-mimaxline]: Minimum Line Voltage
Legend4[batt-mimaxline]: Maximum Line Voltage
LegendI[batt-mimaxline]: Min VAC
LegendO[batt-mimaxline]: Max VAC
WithPeak[batt-mimaxline]: ywm
MaxBytes[batt-mimaxline]: 500
Options[batt-mimaxline]: growright, gauge, nopercent
Title[batt-mimaxline]: APC Minimum & Maximum line voltage
Target[batt-mimaxline]: 1.3.6.1.4.1.318.1.1.1.3.2.3.0&1.3.6.1.4.1.318.1.1.1.3.2.2.0:COMMUNITY@YOUR.APC.IP
PageTop[batt-mimaxline]: <H1>APC Minimum & Maximum line voltage</H1>
 
################################
# Last-Reason-On-Battery
################################
YLegend[batt-lrob]: Reason
ShortLegend[batt-lrob]:
Directory[batt-lrob]: apc_ups
Legend1[batt-lrob]: Last-Reason-On-Battery
Legend2[batt-lrob]: Last-Reason-On-Battery
Legend3[batt-lrob]: Last-Reason-On-Battery
Legend4[batt-lrob]: Last-Reason-On-Battery
LegendI[batt-lrob]: LROB
LegendO[batt-lrob]: LROB
WithPeak[batt-lrob]: ywm
MaxBytes[batt-lrob]: 11
Unscaled[batt-lrob]: dwmy
Options[batt-lrob]: growright, gauge, nopercent
Title[batt-lrob]: apc_ups Last Reason On Battery
Target[batt-lrob]: 1.3.6.1.4.1.318.1.1.1.3.2.5.0&1.3.6.1.4.1.318.1.1.1.3.2.5.0:COMMUNITY@YOUR.APC.IP
PageTop[batt-lrob]: <H1>APC Last Reason On Battery</H1>
  <TABLE>
    <TR><TD>System:</TD><TD>APC in OXIVOCC</TD></TR>
    <TR><TD>Maintainer:</TD><TD>operations</TD></TR>
    <TR><TD VALIGN="top">Description:</TD><TD>LROB Values<BR>
				 	1) No Transfer<BR>
					2) High Line Voltage<BR>
					3) 40% - 100% Line Power<BR>
					4) 0% - 40% Line Power<BR>
					5) <5 Sec Shallow Voltage Sag<BR>
					6) <5 Sec Deep Voltage Sag<BR>
					7) <5 Sec Small Voltage Spike<BR>
					8) <5 Sec Large Voltage Spike<BR>
					9) UPS Self Test<BR>
				   10) Significant Voltage Delta</TD></TR>
    <TR><TD>Resource:</TD><TD>Last Reason On Battery</TD></TR>
  </TABLE>

################################
# Battery temperature
################################

Target[batt-temp]: 1.3.6.1.4.1.318.1.1.1.2.2.2.0&1.3.6.1.4.1.318.1.1.1.2.2.2.0:COMMUNITY@YOUR.APC.IP
Directory[batt-temp]: apc_ups
MaxBytes[batt-temp]: 100
Title[batt-temp]: APC-UPS Temperature
PageTop[batt-temp]: <H1>APC-UPS Temperature</H1>
Options[batt-temp]: growright, gauge, nopercent, absolute
YLegend[batt-temp]: Temp
Legend1[batt-temp]: Temperature
Legend2[batt-temp]: .
Legend3[batt-temp]: Max value per interval on graph
Legend4[batt-temp]: .
LegendI[batt-temp]: UPS Battery Temperature
LegendO[batt-temp]: .

################################
# Battery capacity
################################

YLegend[batt-cap]: Percent
ShortLegend[batt-cap]: %
Directory[batt-cap]: apc_ups
Legend1[batt-cap]: Battery Capacity
Legend2[batt-cap]: Load
Legend3[batt-cap]: Max Capacity
Legend4[batt-cap]: Max Load
LegendI[batt-cap]: Battery Capacity
LegendO[batt-cap]: Load
WithPeak[batt-cap]: ywm
Unscaled[batt-cap]: dwmy
MaxBytes[batt-cap]: 110
Options[batt-cap]: growright, gauge, nopercent
Title[batt-cap]: APC Battery Capacity & Load
Target[batt-cap]: 1.3.6.1.4.1.318.1.1.1.2.2.1.0&1.3.6.1.4.1.318.1.1.1.4.2.3.0:COMMUNITY@YOUR.APC.IP
PageTop[batt-cap]: <H1>Battery Capacity & Load</H1>

################################
# Input & output frequency
################################

YLegend[batt-iofreq]: Hertz
ShortLegend[batt-iofreq]: Hz
Directory[batt-iofreq]: apc_ups
Legend1[batt-iofreq]: Input Frequency
Legend2[batt-iofreq]: Output Frequency
Legend3[batt-iofreq]: Max Input Frequency
Legend4[batt-iofreq]: Max Output Frequency
LegendI[batt-iofreq]: Input Hz
LegendO[batt-iofreq]: Output Hz
WithPeak[batt-iofreq]: ywm
MaxBytes[batt-iofreq]: 100
Unscaled[batt-iofreq]: dwmy
Options[batt-iofreq]: growright, gauge, nopercent
Title[batt-iofreq]: APC Input & Output Frequency
Target[batt-iofreq]: 1.3.6.1.4.1.318.1.1.1.3.2.4.0&1.3.6.1.4.1.318.1.1.1.4.2.2.0:COMMUNITY@YOUR.APC.IP
PageTop[batt-iofreq]: <H1>APC Input & Output Frequency</H1>

################################
# Minimum & Maximum line voltage
################################
YLegend[batt-mimaxline]: Volts AC
ShortLegend[batt-mimaxline]: VAC
Directory[batt-mimaxline]: apc_ups
Legend1[batt-mimaxline]: Minimum Line Voltage
Legend2[batt-mimaxline]: Maximum Line Voltage
Legend3[batt-mimaxline]: Minimum Line Voltage
Legend4[batt-mimaxline]: Maximum Line Voltage
LegendI[batt-mimaxline]: Min VAC
LegendO[batt-mimaxline]: Max VAC
WithPeak[batt-mimaxline]: ywm
MaxBytes[batt-mimaxline]: 500
Options[batt-mimaxline]: growright, gauge, nopercent
Title[batt-mimaxline]: APC Minimum & Maximum line voltage
Target[batt-mimaxline]: 1.3.6.1.4.1.318.1.1.1.3.2.3.0&1.3.6.1.4.1.318.1.1.1.3.2.2.0:COMMUNITY@YOUR.APC.IP
PageTop[batt-mimaxline]: <H1>APC Minimum & Maximum line voltage</H1>

################################
# Last-Reason-On-Battery
################################
YLegend[batt-lrob]: Reason
ShortLegend[batt-lrob]:
Directory[batt-lrob]: apc_ups
Legend1[batt-lrob]: Last-Reason-On-Battery
Legend2[batt-lrob]: Last-Reason-On-Battery
Legend3[batt-lrob]: Last-Reason-On-Battery
Legend4[batt-lrob]: Last-Reason-On-Battery
LegendI[batt-lrob]: LROB
LegendO[batt-lrob]: LROB
WithPeak[batt-lrob]: ywm
MaxBytes[batt-lrob]: 11
Unscaled[batt-lrob]: dwmy
Options[batt-lrob]: growright, gauge, nopercent
Title[batt-lrob]: apc_ups Last Reason On Battery
Target[batt-lrob]: 1.3.6.1.4.1.318.1.1.1.3.2.5.0&1.3.6.1.4.1.318.1.1.1.3.2.5.0:COMMUNITY@YOUR.APC.IP
PageTop[batt-lrob]: <H1>APC Last Reason On Battery</H1>
<TABLE>
<TR><TD>System:</TD><TD>APC in OXIVOCC</TD></TR>
<TR><TD>Maintainer:</TD><TD>operations</TD></TR>
<TR><TD VALIGN="top">Description:</TD><TD>LROB Values<BR>
1) No Transfer<BR>
2) High Line Voltage<BR>
3) 40% – 100% Line Power<BR>
4) 0% – 40% Line Power<BR>
5) <5 Sec Shallow Voltage Sag<BR>
6) <5 Sec Deep Voltage Sag<BR>
7) <5 Sec Small Voltage Spike<BR>
8) <5 Sec Large Voltage Spike<BR>
9) UPS Self Test<BR>
10) Significant Voltage Delta</TD></TR>
<TR><TD>Resource:</TD><TD>Last Reason On Battery</TD></TR>
</TABLE>

Be sure to change the SNMP community and IP to your settings and the location of your www root if you use some other location.

Now add the following line to your crontab to run mrtg every 5 minutes.

1

*/5 * * * *   env LANG=C /usr/bin/mrtg /etc/mrtg/UPS001.cfg >> /var/log/mrtg/mrtg.log 2>&1

Create a index.html in /var/www/mrtg/UPS001:

trouble@sun:$ indexmaker /etc/mrtg/UPS001.cfg > /var/www/mrtg/UPS001/index.html

Now browse to your webserver and you should see the graphs.

Temperature:
Temperature

APC Minimum & Maximum line voltage:
APC Minimum & Maximum line voltage

Last Reason On Battery:
Last reason on battery

Input & Output Frequency:
Input & Output Frequency

Battery Capacity & Load:
Battery Capacity & Load

29
JUL
2009
0

linux, MRTG

, , ,