Difference between revisions of "Subagent:Ping"

255 bytes added ,  16:59, 28 September 2012
no edit summary
m (Removed 10000 in ICMP.Ping missed it at bottom. Fixed spelling for response.)
Line 19: Line 19:
| Icmp.Ping(''target'',''timeout'',''psize'') || ICMP ping response time from ''target''. Agent will send echo request as soon as it receives request for paramter's value, and will return response time for that particular request. Argument ''target'' should be an IP address. Optional argument ''timeout'' specifies timeout in milliseconds. Default timeout is 1 second. Optional argument ''psize'' specifies packet size in bytes, including IP header. If this argument is omited, value from DefaultPacketSize configuration parameter will be used.
| Icmp.Ping(''target'',''timeout'',''psize'') || ICMP ping response time from ''target''. Agent will send echo request as soon as it receives request for paramter's value, and will return response time for that particular request. Argument ''target'' should be an IP address. Optional argument ''timeout'' specifies timeout in milliseconds. Default timeout is 1 second. Optional argument ''psize'' specifies packet size in bytes, including IP header. If this argument is omited, value from DefaultPacketSize configuration parameter will be used.
Please note that other parameters just returns result of background ping process, while this parameter waits for actual ping completion and then returns the result. Because of this behavior, it is not recommended to use '''Icmp.Ping''' parameter for instant monitoring, only for occasional tests. For instant monitoring, you should configure targets for background ping and use '''Icmp.AvgPingTime''' or '''Icmp.LastPingTime''' parameters to retrieve results.   
Please note that other parameters just returns result of background ping process, while this parameter waits for actual ping completion and then returns the result. Because of this behavior, it is not recommended to use '''Icmp.Ping''' parameter for instant monitoring, only for occasional tests. For instant monitoring, you should configure targets for background ping and use '''Icmp.AvgPingTime''' or '''Icmp.LastPingTime''' parameters to retrieve results.   
|-
| Icmp.PingStdDev(''target'') || [http://en.wikipedia.org/wiki/Standard_deviation Standard deviation] of ICMP ping response time for ''target''. Argument ''target'' can be either IP address or name specified in Target configuration record (see below).
|}
|}


683

edits