node-red-contrib-advanced-ping-multiple
v1.4.4
Published
A Node-RED node which takes input and pings a remote server or multiple servers.
Downloads
145
Maintainers
Readme
node-red-contrib-advanced-ping-multiple
A Node-RED node which takes input and pings a remote server.
This is a modification of the node-red-node-ping node. Difference is that this node will perform a ping when it recieves input where the node-red-node-ping node performs pings on a set interval. You may also programmatically pass ping settings to this node. For periodical checks, wire an inject node to this ping node.
Install
Run the following command in the root directory of your Node-RED install
npm install node-red-contrib-advanced-ping-multiple
Usage
- Pings an array of machines and returns the trip time in ms. Ping time is returned in
msg.payload
. Returns Int -1000 if no response received within givenmsg.timeout
in seconds (5 seconds being the default value), or if the host is unresolveable. - Will perform ping on any input and only once per machine.
- You may override the host set in the configuration by passing in a value in
msg.host
.msg.host
can be an array of hosts. In that casemsg.payload
will be an array with the delays or -1000 when unreachable.Null
positions of the array will be preserved and presented asnull
in themsg.pyload
output. - You may set a timeout for each machine's ping by pasing a value in seconds in
msg.timeout
. Also a delay between pings to different servers can be set by passing a value in miliseconds inmsg.delta
. Default values are 5 seconds and 25 miliseconds if no value is set on those message properties. - For legacy reasons, the node will output the host as
msg.topic
(the original node-red-node-ping does it this way). - Any incomming data will be passed on to the output.
- Incoming
msg.payload
data will be outputted asmsg._payload
(as the newmsg.payload
will contain the result of the ping). - Incoming
msg.topic
data will be outputted asmsg._topic
(as the newmsg.topic
will contain the the host).
- Incoming
Todo
Ability to set ping options in node configuration/by incomming message. Right now, these settings are hardcoded except timeout. Default is 5secs but you can override it by passing a msg.timeout value in seconds.
- Linux: -n -w
timeout
-c 1 - Windows: -n 1 -w
timeout x1000
- Mac: -n -t
timeout
-c 1