netdata/collectors/python.d.plugin/portcheck

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

Configuration

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

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

notes

• 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.

---