Use this Knowledge Script to collect exception traceroute data between a specified source and target location in response to an event in another Knowledge Script.
When you enable this script to run automatically in association with another Knowledge Script job, you must specify the source and target locations of the traceroute as parameters. The source location must have the ResponseTime for Networks managed object installed and discovered.
When you associate this Action with a monitoring Knowledge Script, you must set the Location to MC to run the Action on the managed client. Otherwise, this Action creates an error event and will not collect traceroute data when it is invoked.
NOTE:Although any managed client can be selected as the Location, the ResponseTime for Networks managed object must be installed on the managed client.
On the Actions tab, set the Action Type value to Repeat Event - 1 to run a new traceroute each time an event occurs. The Type value is dependent on the settings for event collapsing and on the schedule of the associated Knowledge Script. If the Knowledge Script runs and generates events more often than the event collapsing interval (default is 20 minutes), the traceroute Action will not occur at every event. A new child event must be generated for the Action to be executed.
Set the following parameters as needed:
|
Parameter |
How to Set It |
|
Traceroute source location |
The source is where the traceroute is run from. Select a ResponseTime for Networks node. The field may not be left blank. Specify only one source. |
|
Traceroute target location |
The target is where the traceroute will be run to. Select a ResponseTime for Networks node, some other AppManager node, an IP address, or a URL. The field may not be left blank. Specify only one target. The script will validate the source and target locations are not the same, and will generate an error if they are identical. |
|
Maximum number of hops |
Set the maximum number of hops, from 1 to 30, allowed in the traceroute. The default is 30. |
|
Event when traceroute fails? |
Select Yes to raise events if the Traceroute job fails. The default is Yes. |
|
Event severity -- Traceroute failure |
Set the event severity level, from 1 to 40, to indicate the importance of an event in which the Traceroute job fails. The default is 20. |
Before you launch a Knowledge Script (other than one of the Networks-RT scripts), double-click it to see its Properties dialog box. Click the Actions tab. Click New and select Action_Traceroute from the list. Then click Properties to specify the source location and target location for the traceroute. If an event is generated by the Knowledge Script, the Action_Traceroute Knowledge Script is launched automatically. It collects traceroute data between the source and target you selected and stores the traceroute data in the AppManager repository.
The traceroute data is associated with the event that triggered the traceroute. Run the Report_TracerouteException Knowledge Script to generate a report that compares the traceroute data collected for this event with the historical traceroute data for the associated source and target locations.