diff options
author | Costa Tsaousis <costa@tsaousis.gr> | 2018-03-11 16:37:21 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2018-03-11 16:37:21 +0200 |
commit | cf6350ba18a27fe2fc997e553b7aaaaa31c3fb38 (patch) | |
tree | 9dce550927e3ba6b26acd6230e6d7dcde6f2891e /python.d/README.md | |
parent | 408d499572a8362ed502ace6b964dc939077a841 (diff) | |
parent | b1e25be55a965e0192f219fd4478564d811ca7a4 (diff) |
Merge pull request #3447 from ccremer/portcheck
Add port check plugin
Diffstat (limited to 'python.d/README.md')
-rw-r--r-- | python.d/README.md | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/python.d/README.md b/python.d/README.md index 57b5732da9..5df1ec726f 100644 --- a/python.d/README.md +++ b/python.d/README.md @@ -1684,6 +1684,42 @@ Without configuration, module attempts to connect to `http://localhost/status` --- +# portcheck + +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 + + +### configuration + +```yaml +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. + +--- + # postfix Simple module executing `postfix -p` to grab postfix queue. |