[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

hobbit monitoring of NUT-managed UPSes



OK, this is a long post, and for that I apologize. It contains information on
changes/additions required to several hobbit config files and it also contains
several scripts in their entirety (cut and pasted from a working server)

I also apologize for the serious lack of any real documentation here. This
post was thrown together quickly, to get the information out into the wild.
Hopefully this will be addressed in the near future (by me or by someone else
with a lot of free time) and this post will be properly organized and migrated
to the shire.


Some things to note:

- First and foremost, a NUT (Network UPS Tools) server managing at least one
  UPS is required since this hobbit monitoring implementation pulls UPS data
  points from a NUT server.

- This configuration has been in place for about 3 months monitoring
  the bat-charge, bat-voltage, in-voltage, out-voltage and ups-load on two
  APC1500 UPSes and has performed well for me. Your mileage may vary.

- The scripts, graphs, and other configurations listed here represent the
  required configurations for hobbit to monitor two UPSes attached to one NUT
  server. You will need to modify much of this, paying careful attention to
  UPS names etc. In other words, everywhere you see two UPSes defined, strip
  one out and rename the remaining one to match your environment.

- While the plan was to write the scripts so that they are able to monitor
  multiple UPSes connected to multiple NUT UPS servers, I know that as written
  they will not work properly. Once I have more NUT servers up, this will be
  addressed. They currently work fine with multiple UPSes attached to one NUT
  server, however.

- Please report back to me if you are able to successfully implement this
  configuration. It would be encouraging to know that others have
  found this to be useful and it may force me to find the time to clean it up
  for the shire. :)

- Comments are welcomed


What follows is a BARE BONES listing of what changes need to be made to your
hobbit system files and the scripts used to pull the data and report back to
the hobbit server.

Please read though each of the lists, and each of the scripts, modifying
system names, UPS names, IP addresses as you see fit before simply cutting
and pasting any of this. You should also read through and understand the the
"how to set up custom graphs" help file here:
http://your.hobbit.server.ip/hobbit/help/howtograph.html to get an
understanding of how this all fits together.






----[hobbitserver.cfg changes]----
Add the following definitions to the TEST2RRD variable:
"bat-charge=ncv,bat-voltage=ncv,in-voltage=ncv,out-voltage=ncv,ups-load=ncv"

Add the following definitions to the GRAPHS variable:
"bat-charge,bat-voltage,in-voltage,out-voltage,ups-load"

Add the following NCV definition lines to the end of the file:
NCV_bat-charge="apc1500115:GAUGE,apc1500117:GAUGE"
NCV_bat-voltage="apc1500115:GAUGE,apc1500117:GAUGE"
NCV_in-voltage="apc1500115:GAUGE,apc1500117:GAUGE"
NCV_out-voltage="apc1500115:GAUGE,apc1500117:GAUGE"
NCV_ups-load="apc1500115:GAUGE,apc1500117:GAUGE"
----[end of hobbitserver.cfg changes]----



----[hobbitgraph.cfg changes]----
Add the following graph definitions to the hobbitgraph.cfg file:

[bat-charge]
        TITLE Battery % Charge
        YAXIS %
        DEF:apc1500115=bat-charge.rrd:apc1500115:AVERAGE
        DEF:apc1500117=bat-charge.rrd:apc1500117:AVERAGE
        LINE2:apc1500115#00CCCC:apc1500-115
        LINE2:apc1500117#FF0000:apc1500-117
        COMMENT:\n
        GPRINT:apc1500115:LAST: apc1500-115 \: %5.1lf%s (cur)
        GPRINT:apc1500115:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500115:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500115:AVERAGE: \: %5.1lf%s (avg)\n
        GPRINT:apc1500117:LAST: acp1500-117 \: %5.1lf%s (cur)
        GPRINT:apc1500117:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500117:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500117:AVERAGE: \: %5.1lf%s (avg)\n
[bat-voltage]
        TITLE Battery VDC
        YAXIS VDC
        DEF:apc1500115=bat-voltage.rrd:apc1500115:AVERAGE
        DEF:apc1500117=bat-voltage.rrd:apc1500117:AVERAGE
        LINE2:apc1500115#00CCCC:apc1500-115
        LINE2:apc1500117#FF0000:apc1500-117
        COMMENT:\n
        GPRINT:apc1500115:LAST: apc1500-115 \: %5.1lf%s (cur)
        GPRINT:apc1500115:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500115:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500115:AVERAGE: \: %5.1lf%s (avg)\n
        GPRINT:apc1500117:LAST: acp1500-117 \: %5.1lf%s (cur)
        GPRINT:apc1500117:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500117:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500117:AVERAGE: \: %5.1lf%s (avg)\n
[in-voltage]
        TITLE Input AC Voltage
        YAXIS VAC
        DEF:apc1500115=in-voltage.rrd:apc1500115:AVERAGE
        DEF:apc1500117=in-voltage.rrd:apc1500117:AVERAGE
        LINE2:apc1500115#00CCCC:apc1500-115
        LINE2:apc1500117#FF0000:apc1500-117
        COMMENT:\n
        GPRINT:apc1500115:LAST: apc1500-115 \: %5.1lf%s (cur)
        GPRINT:apc1500115:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500115:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500115:AVERAGE: \: %5.1lf%s (avg)\n
        GPRINT:apc1500117:LAST: acp1500-117 \: %5.1lf%s (cur)
        GPRINT:apc1500117:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500117:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500117:AVERAGE: \: %5.1lf%s (avg)\n
[out-voltage]
        TITLE Output AC Voltage
        YAXIS VAC
        DEF:apc1500115=out-voltage.rrd:apc1500115:AVERAGE
        DEF:apc1500117=out-voltage.rrd:apc1500117:AVERAGE
        LINE2:apc1500115#00CCCC:apc1500-115
        LINE2:apc1500117#FF0000:apc1500-117
        COMMENT:\n
        GPRINT:apc1500115:LAST: apc1500-115 \: %5.1lf%s (cur)
        GPRINT:apc1500115:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500115:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500115:AVERAGE: \: %5.1lf%s (avg)\n
        GPRINT:apc1500117:LAST: acp1500-117 \: %5.1lf%s (cur)
        GPRINT:apc1500117:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500117:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500117:AVERAGE: \: %5.1lf%s (avg)\n
[ups-load]
        TITLE UPS Load %
        YAXIS %
        DEF:apc1500115=ups-load.rrd:apc1500115:AVERAGE
        DEF:apc1500117=ups-load.rrd:apc1500117:AVERAGE
        LINE2:apc1500115#00CCCC:apc1500-115
        LINE2:apc1500117#FF0000:apc1500-117
        COMMENT:\n
        GPRINT:apc1500115:LAST: apc1500-115 \: %5.1lf%s (cur)
        GPRINT:apc1500115:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500115:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500115:AVERAGE: \: %5.1lf%s (avg)\n
        GPRINT:apc1500117:LAST: acp1500-117 \: %5.1lf%s (cur)
        GPRINT:apc1500117:MAX: \: %5.1lf%s (max)
        GPRINT:apc1500117:MIN: \: %5.1lf%s (min)
        GPRINT:apc1500117:AVERAGE: \: %5.1lf%s (avg)\n
----[end of hobbitgraph.cfg changes]----


----[hobbitlaunch.cfg]----
Add the following script definitions to the hobbitlaunch.cfg file:

[batcharge]
        ENVFILE  /usr/local/hobbit/client/etc/hobbitclient.cfg
        CMD  /usr/local/hobbit/client/ext/bat-charge.sh
        INTERVAL 5m
[batvoltage]
        ENVFILE  /usr/local/hobbit/client/etc/hobbitclient.cfg
        CMD  /usr/local/hobbit/client/ext/bat-voltage.sh
        INTERVAL 5m
[involtage]
        ENVFILE  /usr/local/hobbit/client/etc/hobbitclient.cfg
        CMD  /usr/local/hobbit/client/ext/in-voltage.sh
        INTERVAL 5m
[outvoltage]
        ENVFILE  /usr/local/hobbit/client/etc/hobbitclient.cfg
        CMD  /usr/local/hobbit/client/ext/out-voltage.sh
        INTERVAL 5m
[upsload]
        ENVFILE  /usr/local/hobbit/client/etc/hobbitclient.cfg
        CMD  /usr/local/hobbit/client/ext/ups-load.sh
        INTERVAL 5m
----[end of hobbitlaunch.cfg changes]----



----[ external client scripts to reside in ~hobbit/client/ext ]----
---------------------
BATTERY CHARGE SCRIPT
---------------------
#!/bin/bash
#
# waa - 20080616 - bat-charge.sh
#
# William A. Arlofski
# Reverse Polarity, LLC
# 860-824-2433 Office
# http://www.revpol.com/
#
# 20080319 - Initial version
#
# -  Client script for use with Hobbit monitoring server
#    and NUT UPS monitoring software
#
###############################################################################
#
# Copyright (C) 2008 William A. Arlofski - waa-at-revpol-dot-com
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License, version 2, as
# published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
# or visit http://www.gnu.org/licenses/gpl.txt
#
###############################################################################

# ---------------------
# Set up some variables
# ---------------------
upsc="/usr/bin/upsc"
nutserver="UPS fqdn or IP Address"
upslist="apc1500-115 apc1500-117"
datatest="battery\.charge:"
yellowcharge="80"
redcharge="65"

# ----------------
# hobbit variables
# ----------------
COLUMN=bat-charge
COLOR=green
MSG=""

for server in $nutserver; do
 for ups in $upslist; do
  data=`"$upsc" "$ups"@"$server" 2>&1 | grep "$datatest" | cut -d' ' -f2`

  MSG="${MSG}
  $ups : $data"
  if [ "$data" -le "$redcharge" ]; then
    COLOR=red
     elif [ "$data" -le "$yellowcharge" ]; then
      COLOR=yellow
  fi
 done
done

# report status to Hobbit Server
$BB $BBDISP "status $MACHINE.$COLUMN $COLOR `date`

${MSG}
"
exit 0



----------------------
BATTERY VOLTAGE SCRIPT
----------------------
#!/bin/bash
#
# waa - 20080616 - bat-voltage.sh
#
# William A. Arlofski
# Reverse Polarity, LLC
# 860-824-2433 Office
# http://www.revpol.com/
#
# 20080319 - Initial version
#
# -  Client script for use with Hobbit monitoring server
#    and NUT UPS monitoring software
#
###############################################################################
#
# Copyright (C) 2008 William A. Arlofski - waa-at-revpol-dot-com
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License, version 2, as
# published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
# or visit http://www.gnu.org/licenses/gpl.txt
#
###############################################################################

# ---------------------
# Set up some variables
# ---------------------
upsc="/usr/bin/upsc"
nutserver="UPS fqdn or IP Address"
upslist="apc1500-115 apc1500-117"
datatest="battery\.voltage:"
yellowvoltage="260"
redvoltage="220"

# ----------------
# hobbit variables
# ----------------
COLUMN=bat-voltage
COLOR=green
MSG=""

for server in $nutserver; do
 for ups in $upslist; do
  data=`"$upsc" "$ups"@"$server" 2>&1 | grep "$datatest" | cut -d' ' -f2`

  datanopoint=`echo "$data" | sed -e 's/\.//'`
  MSG="${MSG}
  $ups : $data"
  if [ "$datanopoint" -le "$redvoltage" ]; then
    COLOR=red
     elif [ "$datanopoint" -le "$yellowvoltage" ]; then
      COLOR=yellow
  fi
 done
done

# report status to Hobbit Server
$BB $BBDISP "status $MACHINE.$COLUMN $COLOR `date`

${MSG}
"
exit 0



-----------------------
AC INPUT VOLTAGE SCRIPT
-----------------------
#!/bin/bash
#
# waa - 20080616 - in-voltage.sh
#
# William A. Arlofski
# Reverse Polarity, LLC
# 860-824-2433 Office
# http://www.revpol.com/
#
# 20080319 - Initial version
#
# -  Client script for use with Hobbit monitoring server
#    and NUT UPS monitoring software
#
###############################################################################
#
# Copyright (C) 2008 William A. Arlofski - waa-at-revpol-dot-com
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License, version 2, as
# published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
# or visit http://www.gnu.org/licenses/gpl.txt
#
###############################################################################

# -----------------------------
# Set up some initial variables
# -----------------------------
upsc="/usr/bin/upsc"
nutserver="UPS fqdn or IP Address"
upslist="apc1500-115 apc1500-117"
datatest="input\.voltage:"
yellowvoltage="1150"
redvoltage="1090"

# ----------------
# hobbit variables
# ----------------
COLUMN=in-voltage
COLOR=green
MSG=""

for server in $nutserver; do
 for ups in $upslist; do
  data=`"$upsc" "$ups"@"$server" 2>&1 | grep "$datatest" | cut -d' ' -f2`
  datanopoint=`echo "$data" | sed -e 's/\.//'`
  MSG="${MSG}
  $ups : $data"
  if [ "$datanopoint" -le "$redvoltage" ]; then
    COLOR=red
     elif [ "$datanopoint" -lt "$yellowvoltage" ]; then
      COLOR=yellow
  fi
 done
done
# report status to Hobbit Server
$BB $BBDISP "status $MACHINE.$COLUMN $COLOR `date`

${MSG}
"
exit 0



------------------------
AC OUTPUT VOLTAGE SCRIPT
------------------------
#!/bin/bash
#
# waa - 20080616 - out-voltage.sh
#
# William A. Arlofski
# Reverse Polarity, LLC
# 860-824-2433 Office
# http://www.revpol.com/
#
# 20080319 - Initial version
#
# -  Client script for use with Hobbit monitoring server
#    and NUT UPS monitoring software
#
###############################################################################
#
# Copyright (C) 2008 William A. Arlofski - waa-at-revpol-dot-com
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License, version 2, as
# published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
# or visit http://www.gnu.org/licenses/gpl.txt
#
###############################################################################

# ---------------------
# Set up some variables
# ---------------------
upsc="/usr/bin/upsc"
nutserver="UPS fqdn or IP Address"
upslist="apc1500-115 apc1500-117"
datatest="output\.voltage:"
yellowvoltage="1150"
redvoltage="1090"

# ----------------
# hobbit variables
# ----------------
COLUMN=out-voltage
COLOR=green
MSG=""

for server in $nutserver; do
 for ups in $upslist; do
  data=`"$upsc" "$ups"@"$server" 2>&1 | grep "$datatest" | cut -d' ' -f2`
  datanopoint=`echo "$data" | sed -e 's/\.//'`
  MSG="${MSG}
  $ups : $data"
  if [ "$datanopoint" -le "$redvoltage" ]; then
    COLOR=red
     elif [ "$datanopoint" -lt "$yellowvoltage" ]; then
      COLOR=yellow
  fi
 done
done
# report status to Hobbit Server
$BB $BBDISP "status $MACHINE.$COLUMN $COLOR `date`

${MSG}
"
exit 0




-----------------
UPS % LOAD SCRIPT
-----------------
#!/bin/bash
#
# waa - 20080616 - ups-load.sh
#
# William A. Arlofski
# Reverse Polarity, LLC
# 860-824-2433 Office
# http://www.revpol.com/
#
# 20080319 - Initial version
#
# -  Client script for use with Hobbit monitoring server
#    and NUT UPS monitoring software
#
###############################################################################
#
# Copyright (C) 2008 William A. Arlofski - waa-at-revpol-dot-com
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License, version 2, as
# published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
# or visit http://www.gnu.org/licenses/gpl.txt
#
###############################################################################

# ---------------------
# Set up some variables
# ---------------------
upsc="/usr/bin/upsc"
nutserver="UPS fqdn or IP Address"
upslist="apc1500-115 apc1500-117"
datatest="ups\.load:"
yellowload="800"
redload="900"

# ----------------
# hobbit variables
# ----------------
COLUMN=ups-load
COLOR=green
MSG=""

for server in $nutserver; do
 for ups in $upslist; do
  data=`"$upsc" "$ups"@"$server" 2>&1 | grep "$datatest" | cut -d' ' -f2`
  datanopoint=`echo "$data" | sed -e 's/\.//'`
  MSG="${MSG}
  $ups : $data"
  if [ "$datanopoint" -ge "$redload" ]; then
    COLOR=red
     elif [ "$datanopoint" -ge "$yellowload" ]; then
      COLOR=yellow
  fi
 done
done
# report status to Hobbit Server
$BB $BBDISP "status $MACHINE.$COLUMN $COLOR `date`

${MSG}
"
exit 0

----[end of client external scripts ]----




--
Bill Arlofski
Reverse Polarity, LLC
waa (at) revpol.com
http://www.revpol.com/
* Stop the NSA from illegally eavesdropping on your personal email *
Learn about PGP and start encrypting your email today
http://gnupg.org or http://www.pgp.com