Use this Knowledge Script to collect exception traceroute data between a specified source and target location in response to an event in a separate Networks-RT Knowledge Script.
You do not have to specify source or target information when associating the Action script with the Knowledge Script. This script automatically determines the source and target locations for the traceroute, based on the event details from the Knowledge Script.
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 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 |
|
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 an event if the TracerouteNetworks-RT job fails. The default is Yes. |
|
Event severity for traceroute failure |
Set the event severity level, from 1 to 40, to indicate the importance of an event in which the TracerouteNetworks-RT job fails. The default is 20. |
Before you launch a Networks-RT Knowledge Script, double-click it and click the Actions tab on the Properties dialog box. Click New, and select Action_TracerouteNetworks-RT from the list. If an event is generated by the Knowledge Script, the Action_TracerouteNetworks-RT Knowledge Script is launched automatically. It collects traceroute data between the source and target locations associated with the event, and stores the traceroute data in the AppManager database.
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 given pair of endpoints.