20
edits
Difference between revisions of "Subagent:Ping"
Added in upper / lower boundaries for values and return value for ICMP.Ping if not successful.
(Created page with "{{DISPLAYTITLE:Ping Subagent}} This subagent can be used to measure ICMP ping responce times from one location to another. = Provided Parameters = When loaded, PING subagen...") |
(Added in upper / lower boundaries for values and return value for ICMP.Ping if not successful.) |
||
| Line 18: | Line 18: | ||
|- | |- | ||
| Icmp.Ping(''target'',''timeout'',''psize'') || ICMP ping responce time from ''target''. Agent will send echo request as soon as it receives request for paramter's value, and will return responce 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 responce time from ''target''. Agent will send echo request as soon as it receives request for paramter's value, and will return responce 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. If the ping fails the value of 10000 will be returned. | ||
|} | |} | ||
| Line 47: | Line 47: | ||
| DefaultPacketSize || ''bytes'' || Set default packet size to ''bytes''. || 46 | | DefaultPacketSize || ''bytes'' || Set default packet size to ''bytes''. || 46 | ||
|- | |- | ||
| PacketRate || ''packets'' || Set ping packet rate per minute. || 4 | | PacketRate || ''packets'' || Set ping packet rate per minute. Allowed values are from 1 to 60 and values below or above will be adjusted automatically. || 4 | ||
|- | |- | ||
| Target || ''ip'':''name'':''psize'' || Add target with IP address ''ip'' to background ping target list and assign an optional name ''name'' to it. Target will be pinged using packets of ''psize'' bytes size. Name and packet size fields are optional and can be omited. This parameter can be given multiple times to add multiple targets. || ''none'' | | Target || ''ip'':''name'':''psize'' || Add target with IP address ''ip'' to background ping target list and assign an optional name ''name'' to it. Target will be pinged using packets of ''psize'' bytes size. Name and packet size fields are optional and can be omited. This parameter can be given multiple times to add multiple targets. || ''none'' | ||
|- | |- | ||
| Timeout || ''milliseconds'' || Set response timeout to ''milliseconds''. || 3000 | | Timeout || ''milliseconds'' || Set response timeout to ''milliseconds''. Allowed values are from 500 to 5000 and values below or above will be adjusted automatically. || 3000 | ||
|} | |} | ||