Poller package

From OpenNMS
Jump to navigation Jump to search

A "Poller Package" is OpenNMS' Idea of grouping IP addresses which are polled for service assurance. E.g. if you have 10 hosts whose interfaces you want to be polled for SSH, you can create a poller package to explain that to OpenNMS.

Let's call the package "tenforssh":

  • poller-configuration.xml
<package name="tenforssh">
  • Any address on any node may be a candidate for polling, so make the filter wide open
  <filter>IPADDR != '0.0.0.0'</filter>
  • Load the interface addresses we want:
  <include-url>file:/etc/opennms/include/tenforssh.cfg</include-url>

tenforssh.cfg holds a list of IP Addresses (one per line) with the 10 hosts.

  • The info for RRD (..)
  <rrd step="300">
      <rra>RRA:AVERAGE:0.5:1:2016</rra>
      <rra>RRA:AVERAGE:0.5:12:1488</rra>
      <rra>RRA:AVERAGE:0.5:288:366</rra>
      <rra>RRA:MAX:0.5:288:366</rra>
      <rra>RRA:MIN:0.5:288:366</rra>
   </rrd>
  • And now the SSH definition
  <service name="SSH" interval="300000" user-defined="false" status="on">
    <parameter key="retry" value="1"/>
    <parameter key="timeout" value="3000"/>
    <parameter key="rrd-repository" value="/var/lib/opennms/rrd/response"/>
    <parameter key="rrd-base-name" value="ssh"/>
    <parameter key="ds-name" value="ssh"/>
  </service>
</package>