Skip to content


Module monitors a remote TCP service.

Following charts are drawn per host:

  1. Latency ms
    * Time required to connect to a TCP port.
    Displays latency in 0.1 ms resolution. If the connection failed, the value is missing.

  2. Status boolean
    * Connection successful
    * Could not create socket: possible DNS problems
    * Connection refused: port not listening or blocked
    * Connection timed out: host or port unreachable


  host: 'dns or ip'     # required
  port: 22              # required
  timeout: 1            # optional
  update_every: 1       # optional


  • The error chart is intended for alarms, badges or for access via API.
  • A system/service/firewall might block netdata’s access if a portscan or
    similar is detected.
  • Currently, the accuracy of the latency is low and should be used as reference only.