Skip to main content

TCP endpoint monitoring with Netdata

Monitors TCP endpoint availability and response time.

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


Edit the python.d/portcheck.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory, if different
sudo ./edit-config python.d/portcheck.conf
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.

Reach out

If you need help after reading this doc, search our community forum for an answer. There's a good chance someone else has already found a solution to the same issue.



Last updated on