SshMonitor
The SshMonitor tests the availability of an SSH service. During the poll, it attempts to connect on the specified port. If the connection request is successful, then the service is considered up. Optionally, the banner line the node provides may be parsed and compared against a pattern before the service is considered up.
SshMonitor vs. MinaSshMonitor
The SshMonitor only tests that the SSH port is accepting connections. The MinaSshMonitor also tests connecting and authenticating to a node via SSH.
Configuration and Use
Parameter | Description | Default |
---|---|---|
banner |
Regular expression to be matched against the service’s banner. |
n/a |
client-banner |
The client banner that Meridian uses to identify itself to the node. |
SSH-1.99-OpenNMS_1.5 |
match |
Regular expression to match against the service’s banner. |
n/a |
port |
TCP port to which SSH connection is tried. |
22 |
retry |
Number of attempts to establish the SSH connection. |
0 |
This monitor implements the Common Configuration Parameters.
Examples
Example uses CentOS/RHEL path name.
For Debian/Ubuntu, use /var/lib/opennms/rrd/response
.
Note that you must include the monitor
section for each service in your definition.
<service name="SSH" interval="300000" user-defined="false" status="on">
<parameter key="retry" value="1"/>
<parameter key="banner" value="SSH"/>
<parameter key="client-banner" value="OpenNMS poller"/>
<parameter key="timeout" value="5000"/>
<parameter key="rrd-repository" value="/opt/opennms/share/rrd/response"/>
<parameter key="rrd-base-name" value="ssh"/>
<parameter key="ds-name" value="ssh"/>
</service>
<monitor service="SSH" class-name="org.opennms.netmgt.poller.monitors.SshMonitor"/>