This monitor uses TCP to test OSI Layer 4 connectivity. The monitor establishes a TCP connection to a specific port. The greetings banner of the application is evaluated to check the availability of the service. The behavior is similar to a simple test using the telnet command as shown in the example.

Simulating monitor behavior with telnet
root@vagrant:~# telnet 22
Connected to
Escape character is '^]'.
SSH-2.0-OpenSSH_6.6.1p1 Ubuntu-2ubuntu2 (1)
1 Service greeting banner

Monitor facts

Class Name


Configuration and Use

Table 1. Monitor specific parameters for the TcpMonitor
Parameter Description Default



TCP port of the application.




Number of retries before the service is marked as down.



Evaluation of the service connection banner with regular expression. By default any banner result is valid.


This monitor implements the Common Configuration Parameters.


This example shows how to test if the Independent Computing Architecture (ICA) service is available on TCP port 1494. The test evaluates the connection banner starting with ICA.

The example uses a 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="TCP-Citrix-ICA" interval="300000" user-defined="false" status="on">
  <parameter key="retry" value="0" />
  <parameter key="banner" value="ICA" />
  <parameter key="port" value="1494" />
  <parameter key="timeout" value="3000" />
  <parameter key="rrd-repository" value="/opt/opennms/share/rrd/response" />
  <parameter key="rrd-base-name" value="tcpCitrixIca" />
  <parameter key="ds-name" value="tcpCitrixIca" />

<monitor service="TCP-Citrix-ICA" class-name="org.opennms.netmgt.poller.monitors.TcpMonitor" />