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.<\/p>\n\n\n\n
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.<\/p>\n\n\n\n
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.<\/p>\n\n\n\n
APC UPS Smart-UPS VT 15kVA<\/p>\n\n\n\n
APC UPS Smart-UPS RT 10000 RM XL<\/p>\n\n\n\n
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.<\/p>\n\n\n\n
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.<\/p>\n\n\n\n
UPSNAME = Substitute this with your UPS’s hostname on the network for easy identification.<\/p>\n\n\n\n
COMMUNITYSTRING = The SNMP string is what is configured on the UPS.<\/p>\n\n\n\n
IPADDRESS = The IP address of the management IP of the network card in the UPS.<\/p>\n\n\n\n
APC UPS Smart-UPS VT 15kVA<\/strong><\/p>\n\n\n\n APC UPS Smart-UPS RT 10000 RM XL<\/strong><\/p>\n\n\n\n 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.<\/p>\n","protected":false},"excerpt":{"rendered":" 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 … Read more<\/a><\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[],"class_list":["post-717","post","type-post","status-publish","format-standard","hentry","category-linux"],"_links":{"self":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/717","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=717"}],"version-history":[{"count":1,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/717\/revisions"}],"predecessor-version":[{"id":1478,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=\/wp\/v2\/posts\/717\/revisions\/1478"}],"wp:attachment":[{"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=717"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=717"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/geekmungus.co.uk\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=717"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}# APC UPS APC MRTG config\n\nEnableIPv6: no\n\nWorkDir: \/var\/www\/mrtg\/ups\n\nYLegend[UPSNAME_1]: Hertz\n\nShortLegend[UPSNAME_1]: Hz\n\nDirectory[UPSNAME_1]: UPSNAME\n\nXSize[UPSNAME_1]: 400\n\nYSize[UPSNAME_1]: 100\n\nLegend1[UPSNAME_1]: Input Frequency\n\nLegend2[UPSNAME_1]: Output Frequency\n\nLegend3[UPSNAME_1]: Max Input Frequency\n\nLegend4[UPSNAME_1]: Max Output Frequency\n\nLegendI[UPSNAME_1]: Input Hz\n\nLegendO[UPSNAME_1]: Output Hz\n\nWithPeak[UPSNAME_1]: ywm\n\nMaxBytes[UPSNAME_1]: 100\n\nUnscaled[UPSNAME_1]: dwmy\n\nOptions[UPSNAME_1]: growright, gauge, nopercent\n\nTitle[UPSNAME_1]: Input & Output Frequency\n\nTarget[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\n\nPageTop[UPSNAME_1]: <H1>Input & Output Frequency<\/H1>\n\nYLegend[UPSNAME_2]: Voltage\n\nShortLegend[UPSNAME_2]: v\n\nDirectory[UPSNAME_2]: UPSNAME\n\nXSize[UPSNAME_2]: 400\n\nYSize[UPSNAME_2]: 100\n\nLegend1[UPSNAME_2]: Input Voltage Phase 1\n\nLegend2[UPSNAME_2]: Output Voltage Phase 1\n\nLegendI[UPSNAME_2]: Input Voltage\n\nLegendO[UPSNAME_2]: Output Voltage\n\nWithPeak[UPSNAME_2]: ywm\n\nMaxBytes[UPSNAME_2]: 320\n\nUnscaled[UPSNAME_2]: dwmy\n\nOptions[UPSNAME_2]: growright, gauge, nopercent\n\nTitle[UPSNAME_2]: Input and Output Voltage Phase 1\n\nTarget[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\n\nPageTop[UPSNAME_2]: <H1>Input and Output Voltage Phase 1<\/H1>\n\nYLegend[UPSNAME_3]: Voltage\n\nShortLegend[UPSNAME_3]: v\n\nDirectory[UPSNAME_3]: UPSNAME\n\nXSize[UPSNAME_3]: 400\n\nYSize[UPSNAME_3]: 100\n\nLegend1[UPSNAME_3]: Input Voltage Phase 2\n\nLegend2[UPSNAME_3]: Output Voltage Phase 2\n\nLegendI[UPSNAME_3]: Input Voltage\n\nLegendO[UPSNAME_3]: Output Voltage\n\nWithPeak[UPSNAME_3]: ywm\n\nMaxBytes[UPSNAME_3]: 320\n\nUnscaled[UPSNAME_3]: dwmy\n\nOptions[UPSNAME_3]: growright, gauge, nopercent\n\nTitle[UPSNAME_3]: Input and Output Voltage Phase 2\n\nTarget[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\n\nPageTop[UPSNAME_3]: <H1>Input and Output Voltage Phase 2<\/H1>\n\nYLegend[UPSNAME_4]: Voltage\n\nShortLegend[UPSNAME_4]: v\n\nDirectory[UPSNAME_4]: UPSNAME\n\nXSize[UPSNAME_4]: 400\n\nYSize[UPSNAME_4]: 100\n\nLegend1[UPSNAME_4]: Input Voltage Phase 3\n\nLegend2[UPSNAME_4]: Output Voltage Phase 3\n\nLegendI[UPSNAME_4]: Input Voltage\n\nLegendO[UPSNAME_4]: Output Voltage\n\nWithPeak[UPSNAME_4]: ywm\n\nMaxBytes[UPSNAME_4]: 320\n\nUnscaled[UPSNAME_4]: dwmy\n\nOptions[UPSNAME_4]: growright, gauge, nopercent\n\nTitle[UPSNAME_4]: Input and Output Voltage Phase 3\n\nTarget[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\n\nPageTop[UPSNAME_4]: <H1>Input and Output Voltage Phase 3<\/H1>\n\nYLegend[UPSNAME_5]: Percent\n\nShortLegend[UPSNAME_5]: %\n\nDirectory[UPSNAME_5]: UPSNAME\n\nXSize[UPSNAME_5]: 400\n\nYSize[UPSNAME_5]: 100\n\nLegend1[UPSNAME_5]: Output Load Percent\n\nLegend2[UPSNAME_5]: Output Load Percent\n\nLegendI[UPSNAME_5]: Percent\n\nLegendO[UPSNAME_5]: Percent\n\nWithPeak[UPSNAME_5]: ywm\n\nMaxBytes[UPSNAME_5]: 100\n\nUnscaled[UPSNAME_5]: dwmy\n\nOptions[UPSNAME_5]: growright, gauge, nopercent\n\nTitle[UPSNAME_5]: Output Load Percent\n\nTarget[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\n\nPageTop[UPSNAME_5]: <H1>Output Load Percent<\/H1>\n\nYLegend[UPSNAME_6]: Temperature\n\nShortLegend[UPSNAME_6]: C\n\nDirectory[UPSNAME_6]: UPSNAME\n\nXSize[UPSNAME_6]: 400\n\nYSize[UPSNAME_6]: 100\n\nLegend1[UPSNAME_6]: Internal UPS Temperature\n\nLegend2[UPSNAME_6]: Internal UPS Temperature\n\nLegendI[UPSNAME_6]: Celsius\n\nLegendO[UPSNAME_6]: Celsius\n\nWithPeak[UPSNAME_6]: ywm\n\nMaxBytes[UPSNAME_6]: 40\n\nUnscaled[UPSNAME_6]: dwmy\n\nOptions[UPSNAME_6]: growright, gauge, nopercent\n\nTitle[UPSNAME_6]: Internal UPS Temperature\n\nTarget[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\n\nPageTop[UPSNAME_6]: <H1>Internal UPS Temperature<\/H1>\n\nYLegend[UPSNAME_7]: Temperature\n\nShortLegend[UPSNAME_7]: C\n\nDirectory[UPSNAME_7]: UPSNAME\n\nXSize[UPSNAME_7]: 400\n\nYSize[UPSNAME_7]: 100\n\nLegend1[UPSNAME_7]: External UPS Temperature\n\nLegend2[UPSNAME_7]: External UPS Temperature\n\nLegendI[UPSNAME_7]: Celsius\n\nLegendO[UPSNAME_7]: Celsius\n\nWithPeak[UPSNAME_7]: ywm\n\nMaxBytes[UPSNAME_7]: 40\n\nUnscaled[UPSNAME_7]: dwmy\n\nOptions[UPSNAME_7]: growright, gauge, nopercent\n\nTitle[UPSNAME_7]: External UPS Temperature\n\nTarget[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\n\nPageTop[UPSNAME_7]: <H1>External UPS Temperature<\/H1>\n\nYLegend[UPSNAME_8]: Percent\n\nShortLegend[UPSNAME_8]: %\n\nDirectory[UPSNAME_8]: UPSNAME\n\nXSize[UPSNAME_8]: 400\n\nYSize[UPSNAME_8]: 100\n\nLegend1[UPSNAME_8]: Battery Charge Level\n\nLegend2[UPSNAME_8]: Battery Charge Level\n\nLegendI[UPSNAME_8]: %\n\nLegendO[UPSNAME_8]: %\n\nWithPeak[UPSNAME_8]: ywm\n\nMaxBytes[UPSNAME_8]: 100\n\nUnscaled[UPSNAME_8]: dwmy\n\nOptions[UPSNAME_8]: growright, gauge, nopercent\n\nTitle[UPSNAME_8]: Battery Charge Level\n\nTarget[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\n\nPageTop[UPSNAME_8]: <H1>Battery Charge Level<\/H1><\/code><\/pre>\n\n\n\n# APC UPS APC MRTG config\n\nEnableIPv6: no\n\nWorkDir: \/var\/www\/mrtg\/ups\n\nYLegend[UPSNAME_1]: Hertz\n\nShortLegend[UPSNAME_1]: Hz\n\nDirectory[UPSNAME_1]: UPSNAME\n\nXSize[UPSNAME_1]: 400\n\nYSize[UPSNAME_1]: 100\n\nLegend1[UPSNAME_1]: Input Frequency\n\nLegend2[UPSNAME_1]: Output Frequency\n\nLegend3[UPSNAME_1]: Max Input Frequency\n\nLegend4[UPSNAME_1]: Max Output Frequency\n\nLegendI[UPSNAME_1]: Input Hz\n\nLegendO[UPSNAME_1]: Output Hz\n\nWithPeak[UPSNAME_1]: ywm\n\nMaxBytes[UPSNAME_1]: 100\n\nUnscaled[UPSNAME_1]: dwmy\n\nOptions[UPSNAME_1]: growright, gauge, nopercent\n\nTitle[UPSNAME_1]: Input & Output Frequency\n\nTarget[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\n\nPageTop[UPSNAME_1]: <H1>Input & Output Frequency<\/H1>\n\nYLegend[UPSNAME_2]: Voltage\n\nShortLegend[UPSNAME_2]: v\n\nDirectory[UPSNAME_2]: UPSNAME\n\nXSize[UPSNAME_2]: 400\n\nYSize[UPSNAME_2]: 100\n\nLegend1[UPSNAME_2]: Input Voltage\n\nLegend2[UPSNAME_2]: Output Voltage\n\nLegendI[UPSNAME_2]: Input Voltage\n\nLegendO[UPSNAME_2]: Output Voltage\n\nWithPeak[UPSNAME_2]: ywm\n\nMaxBytes[UPSNAME_2]: 320\n\nUnscaled[UPSNAME_2]: dwmy\n\nOptions[UPSNAME_2]: growright, gauge, nopercent\n\nTitle[UPSNAME_2]: Input and Output Voltage\n\nTarget[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\n\nPageTop[UPSNAME_2]: <H1>Input and Output Voltage<\/H1>\n\nYLegend[UPSNAME_3]: Percent\n\nShortLegend[UPSNAME_3]: %\n\nDirectory[UPSNAME_3]: UPSNAME\n\nXSize[UPSNAME_3]: 400\n\nYSize[UPSNAME_3]: 100\n\nLegend1[UPSNAME_3]: Output Load Percent\n\nLegend2[UPSNAME_3]: Output Load Percent\n\nLegendI[UPSNAME_3]: Percent\n\nLegendO[UPSNAME_3]: Percent\n\nWithPeak[UPSNAME_3]: ywm\n\nMaxBytes[UPSNAME_3]: 100\n\nUnscaled[UPSNAME_3]: dwmy\n\nOptions[UPSNAME_3]: growright, gauge, nopercent\n\nTitle[UPSNAME_3]: Output Load Percent\n\nTarget[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\n\nPageTop[UPSNAME_3]: <H1>Output Load Percent<\/H1>\n\nYLegend[UPSNAME_4]: Temperature\n\nShortLegend[UPSNAME_4]: C\n\nDirectory[UPSNAME_4]: UPSNAME\n\nXSize[UPSNAME_4]: 400\n\nYSize[UPSNAME_4]: 100\n\nLegend1[UPSNAME_4]: Internal UPS Temperature\n\nLegend2[UPSNAME_4]: Internal UPS Temperature\n\nLegendI[UPSNAME_4]: Celsius\n\nLegendO[UPSNAME_4]: Celsius\n\nWithPeak[UPSNAME_4]: ywm\n\nMaxBytes[UPSNAME_4]: 40\n\nUnscaled[UPSNAME_4]: dwmy\n\nOptions[UPSNAME_4]: growright, gauge, nopercent\n\nTitle[UPSNAME_4]: Internal UPS Temperature\n\nTarget[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\n\nPageTop[UPSNAME_4]: <H1>Internal UPS Temperature<\/H1>\n\nYLegend[UPSNAME_5]: Temperature\n\nShortLegend[UPSNAME_5]: C\n\nDirectory[UPSNAME_5]: UPSNAME\n\nXSize[UPSNAME_5]: 400\n\nYSize[UPSNAME_5]: 100\n\nLegend1[UPSNAME_5]: External UPS Temperature\n\nLegend2[UPSNAME_5]: External UPS Temperature\n\nLegendI[UPSNAME_5]: Celsius\n\nLegendO[UPSNAME_5]: Celsius\n\nWithPeak[UPSNAME_5]: ywm\n\nMaxBytes[UPSNAME_5]: 40\n\nUnscaled[UPSNAME_5]: dwmy\n\nOptions[UPSNAME_5]: growright, gauge, nopercent\n\nTitle[UPSNAME_5]: External UPS Temperature\n\nTarget[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\n\nPageTop[UPSNAME_5]: <H1>External UPS Temperature<\/H1>\n\nYLegend[UPSNAME_6]: Percent\n\nShortLegend[UPSNAME_6]: %\n\nDirectory[UPSNAME_6]: UPSNAME\n\nXSize[UPSNAME_6]: 400\n\nYSize[UPSNAME_6]: 100\n\nLegend1[UPSNAME_6]: Battery Charge Level\n\nLegend2[UPSNAME_6]: Battery Charge Level\n\nLegendI[UPSNAME_6]: %\n\nLegendO[UPSNAME_6]: %\n\nWithPeak[UPSNAME_6]: ywm\n\nMaxBytes[UPSNAME_6]: 100\n\nUnscaled[UPSNAME_6]: dwmy\n\nOptions[UPSNAME_6]: growright, gauge, nopercent\n\nTitle[UPSNAME_6]: Battery Charge Level\n\nTarget[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\n\nPageTop[UPSNAME_6]: <H1>Battery Charge Level<\/H1><\/code><\/pre>\n\n\n\n