Monitoring Metrics of APC UPS with MRTG via SNMP

posted 17 Jun 2013, 09:01 by Tristan Self

This assumes you have a APC Smart-UPS UPS with a Network Management Card, that you have already configured to allow SNMP connections and you've configured the community string. This is tested using MRTG running on Ubuntu with an AP9619 network management card in the UPSes.

This took ages to find the correct metrics OIDs from the MIB to monitor using lots of time, swearing and investigation using MIB lookup tools. And some trail and error checking the values on the web interface to what the OID was showing.

These configurations allow you to pull out and monitor the following metrics from the UPS, note i've given the two types of UPS we use on our campuses, but basically you should find these work for most times of APC UPS, the 15Kva is a 3 phase UPS so we want to monitor the input and output Voltage on each phase. The 10KVa one is just a single phase UPS so we only monitor the one incoming and outgoing on that one.

APC UPS Smart-UPS VT 15kVA

Input Frequency - 1.3.6.1.4.1.318.1.1.1.3.2.4.0
Output Frequency - 1.3.6.1.4.1.318.1.1.1.4.2.2.0
Input Voltage Phase 1 - 1.3.6.1.4.1.318.1.1.1.9.2.3.1.3.1.1.1
Output Voltage Phase 1 - 1.3.6.1.4.1.318.1.1.1.9.3.3.1.3.1.1.1
Input Voltage Phase 2 - 1.3.6.1.4.1.318.1.1.1.9.2.3.1.3.1.1.2
Output Voltage Phase 2 - 1.3.6.1.4.1.318.1.1.1.9.3.3.1.3.1.1.2
Input Voltage Phase 3 - 1.3.6.1.4.1.318.1.1.1.9.2.3.1.3.1.1.3
Output Voltage Phase 3 - 1.3.6.1.4.1.318.1.1.1.9.3.3.1.3.1.1.3
Output Load Percent - 1.3.6.1.4.1.318.1.1.1.4.2.3.0
Internal UPS Temperature - 1.3.6.1.4.1.318.1.1.1.2.2.2.0
External UPS Temperature (Temperature Sensor) - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4.1
Battery Charge Level - 1.3.6.1.4.1.318.1.1.1.2.2.1.0

APC UPS Smart-UPS RT 10000 RM XL

Input Frequency - 1.3.6.1.4.1.318.1.1.1.3.2.4.0
Output Frequency - 1.3.6.1.4.1.318.1.1.1.4.2.2.0
Input Voltage - 1.3.6.1.4.1.318.1.1.1.3.2.1.0
Output Voltage - 1.3.6.1.4.1.318.1.1.1.4.2.1.0
Output Load Percent - 1.3.6.1.4.1.318.1.1.1.4.2.3.0
Internal UPS Temperature - 1.3.6.1.4.1.318.1.1.1.2.2.2.0
External UPS Temperature (Temperature Sensor) - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4.1
Battery Charge Level - 1.3.6.1.4.1.318.1.1.1.2.2.1.0

So now for the configuration in MRTG, you need to configure the MRTG file to use the files to build up the logs and you'd need to have this set to run a CRON job to take the MRTG script and scoop the current statistics every 5 minutes or so. I'm not explaining that as you can find instructions for it every where. Below are the MRTG configuration files that will produce the graphs for these metrics.

You may notice that for some of the single metric OIDs like "Battery Charge Level" have the same OID repeated twice in the input, this is because MRTG must have 2 inputs, if it doesn't it won't work. This is fine for a router interface with incoming and outgoing traffic, but doesn't work so well for battery charge level which would be 100% or 10% for example.

UPSNAME = Substitute this with your UPS's hostname on the network for easy identification.

COMMUNITYSTRING = The SNMP string is what is configured on the UPS.

IPADDRESS = The IP address of the management IP of the network card in the UPS.

APC UPS Smart-UPS VT 15kVA

# APC UPS APC MRTG config

EnableIPv6: no

WorkDir: /var/www/mrtg/ups

YLegend[UPSNAME_1]: Hertz
ShortLegend[UPSNAME_1]: Hz
Directory[UPSNAME_1]: UPSNAME
XSize[UPSNAME_1]: 400
YSize[UPSNAME_1]: 100
Legend1[UPSNAME_1]: Input Frequency
Legend2[UPSNAME_1]: Output Frequency
Legend3[UPSNAME_1]: Max Input Frequency
Legend4[UPSNAME_1]: Max Output Frequency
LegendI[UPSNAME_1]: Input Hz
LegendO[UPSNAME_1]: Output Hz
WithPeak[UPSNAME_1]: ywm
MaxBytes[UPSNAME_1]: 100
Unscaled[UPSNAME_1]: dwmy
Options[UPSNAME_1]: growright, gauge, nopercent
Title[UPSNAME_1]: Input & Output Frequency
Target[UPSNAME_1]: 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:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_1]: <H1>Input & Output Frequency</H1>

YLegend[UPSNAME_2]: Voltage
ShortLegend[UPSNAME_2]: v
Directory[UPSNAME_2]: UPSNAME
XSize[UPSNAME_2]: 400
YSize[UPSNAME_2]: 100
Legend1[UPSNAME_2]: Input Voltage Phase 1
Legend2[UPSNAME_2]: Output Voltage Phase 1
LegendI[UPSNAME_2]: Input Voltage
LegendO[UPSNAME_2]: Output Voltage
WithPeak[UPSNAME_2]: ywm
MaxBytes[UPSNAME_2]: 320
Unscaled[UPSNAME_2]: dwmy
Options[UPSNAME_2]: growright, gauge, nopercent
Title[UPSNAME_2]: Input and Output Voltage Phase 1
Target[UPSNAME_2]: 1.3.6.1.4.1.318.1.1.1.9.2.3.1.3.1.1.1&1.3.6.1.4.1.318.1.1.1.9.3.3.1.3.1.1.1:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_2]: <H1>Input and Output Voltage Phase 1</H1>

YLegend[UPSNAME_3]: Voltage
ShortLegend[UPSNAME_3]: v
Directory[UPSNAME_3]: UPSNAME
XSize[UPSNAME_3]: 400
YSize[UPSNAME_3]: 100
Legend1[UPSNAME_3]: Input Voltage Phase 2
Legend2[UPSNAME_3]: Output Voltage Phase 2
LegendI[UPSNAME_3]: Input Voltage
LegendO[UPSNAME_3]: Output Voltage
WithPeak[UPSNAME_3]: ywm
MaxBytes[UPSNAME_3]: 320
Unscaled[UPSNAME_3]: dwmy
Options[UPSNAME_3]: growright, gauge, nopercent
Title[UPSNAME_3]: Input and Output Voltage Phase 2
Target[UPSNAME_3]: 1.3.6.1.4.1.318.1.1.1.9.2.3.1.3.1.1.2&1.3.6.1.4.1.318.1.1.1.9.3.3.1.3.1.1.2:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_3]: <H1>Input and Output Voltage Phase 2</H1>

YLegend[UPSNAME_4]: Voltage
ShortLegend[UPSNAME_4]: v
Directory[UPSNAME_4]: UPSNAME
XSize[UPSNAME_4]: 400
YSize[UPSNAME_4]: 100
Legend1[UPSNAME_4]: Input Voltage Phase 3
Legend2[UPSNAME_4]: Output Voltage Phase 3
LegendI[UPSNAME_4]: Input Voltage
LegendO[UPSNAME_4]: Output Voltage
WithPeak[UPSNAME_4]: ywm
MaxBytes[UPSNAME_4]: 320
Unscaled[UPSNAME_4]: dwmy
Options[UPSNAME_4]: growright, gauge, nopercent
Title[UPSNAME_4]: Input and Output Voltage Phase 3
Target[UPSNAME_4]: 1.3.6.1.4.1.318.1.1.1.9.2.3.1.3.1.1.3&1.3.6.1.4.1.318.1.1.1.9.3.3.1.3.1.1.3:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_4]: <H1>Input and Output Voltage Phase 3</H1>

YLegend[UPSNAME_5]: Percent
ShortLegend[UPSNAME_5]: %
Directory[UPSNAME_5]: UPSNAME
XSize[UPSNAME_5]: 400
YSize[UPSNAME_5]: 100
Legend1[UPSNAME_5]: Output Load Percent
Legend2[UPSNAME_5]: Output Load Percent
LegendI[UPSNAME_5]: Percent
LegendO[UPSNAME_5]: Percent
WithPeak[UPSNAME_5]: ywm
MaxBytes[UPSNAME_5]: 100
Unscaled[UPSNAME_5]: dwmy
Options[UPSNAME_5]: growright, gauge, nopercent
Title[UPSNAME_5]: Output Load Percent
Target[UPSNAME_5]: 1.3.6.1.4.1.318.1.1.1.4.2.3.0&1.3.6.1.4.1.318.1.1.1.4.2.3.0:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_5]: <H1>Output Load Percent</H1>

YLegend[UPSNAME_6]: Temperature
ShortLegend[UPSNAME_6]: C
Directory[UPSNAME_6]: UPSNAME
XSize[UPSNAME_6]: 400
YSize[UPSNAME_6]: 100
Legend1[UPSNAME_6]: Internal UPS Temperature
Legend2[UPSNAME_6]: Internal UPS Temperature
LegendI[UPSNAME_6]: Celsius
LegendO[UPSNAME_6]: Celsius
WithPeak[UPSNAME_6]: ywm
MaxBytes[UPSNAME_6]: 40
Unscaled[UPSNAME_6]: dwmy
Options[UPSNAME_6]: growright, gauge, nopercent
Title[UPSNAME_6]: Internal UPS Temperature
Target[UPSNAME_6]: 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:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_6]: <H1>Internal UPS Temperature</H1>

YLegend[UPSNAME_7]: Temperature
ShortLegend[UPSNAME_7]: C
Directory[UPSNAME_7]: UPSNAME
XSize[UPSNAME_7]: 400
YSize[UPSNAME_7]: 100
Legend1[UPSNAME_7]: External UPS Temperature
Legend2[UPSNAME_7]: External UPS Temperature
LegendI[UPSNAME_7]: Celsius
LegendO[UPSNAME_7]: Celsius
WithPeak[UPSNAME_7]: ywm
MaxBytes[UPSNAME_7]: 40
Unscaled[UPSNAME_7]: dwmy
Options[UPSNAME_7]: growright, gauge, nopercent
Title[UPSNAME_7]: External UPS Temperature
Target[UPSNAME_7]: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4.1&1.3.6.1.4.1.318.1.1.10.2.3.2.1.4.1:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_7]: <H1>External UPS Temperature</H1>

YLegend[UPSNAME_8]: Percent
ShortLegend[UPSNAME_8]: %
Directory[UPSNAME_8]: UPSNAME
XSize[UPSNAME_8]: 400
YSize[UPSNAME_8]: 100
Legend1[UPSNAME_8]: Battery Charge Level
Legend2[UPSNAME_8]: Battery Charge Level
LegendI[UPSNAME_8]: %
LegendO[UPSNAME_8]: %
WithPeak[UPSNAME_8]: ywm
MaxBytes[UPSNAME_8]: 100
Unscaled[UPSNAME_8]: dwmy
Options[UPSNAME_8]: growright, gauge, nopercent
Title[UPSNAME_8]: Battery Charge Level
Target[UPSNAME_8]: .1.3.6.1.4.1.318.1.1.1.2.2.1.0&.1.3.6.1.4.1.318.1.1.1.2.2.1.0:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_8]: <H1>Battery Charge Level</H1>

APC UPS Smart-UPS RT 10000 RM XL

# APC UPS APC MRTG config

EnableIPv6: no

WorkDir: /var/www/mrtg/ups

YLegend[UPSNAME_2]: Voltage
ShortLegend[UPSNAME_2]: v
Directory[UPSNAME_2]: UPSNAME
XSize[UPSNAME_2]: 400
YSize[UPSNAME_2]: 100
Legend1[UPSNAME_2]: Input Voltage
Legend2[UPSNAME_2]: Output Voltage
LegendI[UPSNAME_2]: Input Voltage
LegendO[UPSNAME_2]: Output Voltage
WithPeak[UPSNAME_2]: ywm
MaxBytes[UPSNAME_2]: 320
Unscaled[UPSNAME_2]: dwmy
Options[UPSNAME_2]: growright, gauge, nopercent
Title[UPSNAME_2]: Input and Output Voltage
Target[UPSNAME_2]: 1.3.6.1.4.1.318.1.1.1.3.2.1.0&1.3.6.1.4.1.318.1.1.1.4.2.1.0:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_2]: <H1>Input and Output Voltage</H1>

YLegend[UPSNAME_3]: Percent
ShortLegend[UPSNAME_3]: %
Directory[UPSNAME_3]: UPSNAME
XSize[UPSNAME_3]: 400
YSize[UPSNAME_3]: 100
Legend1[UPSNAME_3]: Output Load Percent
Legend2[UPSNAME_3]: Output Load Percent
LegendI[UPSNAME_3]: Percent
LegendO[UPSNAME_3]: Percent
WithPeak[UPSNAME_3]: ywm
MaxBytes[UPSNAME_3]: 100
Unscaled[UPSNAME_3]: dwmy
Options[UPSNAME_3]: growright, gauge, nopercent
Title[UPSNAME_3]: Output Load Percent
Target[UPSNAME_3]: 1.3.6.1.4.1.318.1.1.1.4.2.3.0&1.3.6.1.4.1.318.1.1.1.4.2.3.0:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_3]: <H1>Output Load Percent</H1>

YLegend[UPSNAME_4]: Temperature
ShortLegend[UPSNAME_4]: C
Directory[UPSNAME_4]: UPSNAME
XSize[UPSNAME_4]: 400
YSize[UPSNAME_4]: 100
Legend1[UPSNAME_4]: Internal UPS Temperature
Legend2[UPSNAME_4]: Internal UPS Temperature
LegendI[UPSNAME_4]: Celsius
LegendO[UPSNAME_4]: Celsius
WithPeak[UPSNAME_4]: ywm
MaxBytes[UPSNAME_4]: 40
Unscaled[UPSNAME_4]: dwmy
Options[UPSNAME_4]: growright, gauge, nopercent
Title[UPSNAME_4]: Internal UPS Temperature
Target[UPSNAME_4]: 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:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_4]: <H1>Internal UPS Temperature</H1>

YLegend[UPSNAME_5]: Temperature
ShortLegend[UPSNAME_5]: C
Directory[UPSNAME_5]: UPSNAME
XSize[UPSNAME_5]: 400
YSize[UPSNAME_5]: 100
Legend1[UPSNAME_5]: External UPS Temperature
Legend2[UPSNAME_5]: External UPS Temperature
LegendI[UPSNAME_5]: Celsius
LegendO[UPSNAME_5]: Celsius
WithPeak[UPSNAME_5]: ywm
MaxBytes[UPSNAME_5]: 40
Unscaled[UPSNAME_5]: dwmy
Options[UPSNAME_5]: growright, gauge, nopercent
Title[UPSNAME_5]: External UPS Temperature
Target[UPSNAME_5]: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4.1&1.3.6.1.4.1.318.1.1.10.2.3.2.1.4.1:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_5]: <H1>External UPS Temperature</H1>

YLegend[UPSNAME_6]: Percent
ShortLegend[UPSNAME_6]: %
Directory[UPSNAME_6]: UPSNAME
XSize[UPSNAME_6]: 400
YSize[UPSNAME_6]: 100
Legend1[UPSNAME_6]: Battery Charge Level
Legend2[UPSNAME_6]: Battery Charge Level
LegendI[UPSNAME_6]: %
LegendO[UPSNAME_6]: %
WithPeak[UPSNAME_6]: ywm
MaxBytes[UPSNAME_6]: 100
Unscaled[UPSNAME_6]: dwmy
Options[UPSNAME_6]: growright, gauge, nopercent
Title[UPSNAME_6]: Battery Charge Level
Target[UPSNAME_6]: .1.3.6.1.4.1.318.1.1.1.2.2.1.0&.1.3.6.1.4.1.318.1.1.1.2.2.1.0:COMMUNITYSTRING@IPADDRESS
PageTop[UPSNAME_6]: <H1>Battery Charge Level</H1>

Once configured you can setup the MRTG scripts to run periodically to pickup the statistics and then you need to use "indexmaker" to create the nice graph html file so you can see the pretty graphs.

Comments

geekmungus	Search this site