show active-measurements

The show active-measurements command displays a table of active probes that meet your specified filter criteria. Columns in the table are:

• P--Current state of probing
• S--Failure suppression
• Group--Active measurement group name (n/a means the probe was configured as a standalone probe, using the target command rather than the active-measurement group commands)
• Target--IP address of the probe target, as configured, or its hostname. Addresses marked “(EFC)” indicates that these are derived from Endpoint Flow Collection.
• Address--DNS-resolved address of the probe
• Type--Configured probe type (either tcp or icmp)
• USTAT--Slot number or subsystem and name of USTAT to which this row of the table applies, in the form <name> <slot> (USTATs which are still configured to use slot numbers instead of names will repeat the slot number as the name entry; if a USTAT module is defined in the configuration but is not associated with a slot or subsystem, the slot entry will be shown in the output as <unk>)
• Success--Number of probes that were successful
• Errors--Summary of what went wrong (error codes are defined in the key at the top of the table)

Output is displayed as follows:

ssf-neat-5008# show active-measurements range-address 4.2.0.0/16
 
Thu Dec 11 14:04:59 PST 2003
 
Summary
 
Rows       Total Timing Out  Net Unrch Host Unrch       Wait   Recovery
 
Shown         21         12          0          0          0          0
 
Found         21         12          0          0          0          0
 

 
Measurement Results
 
'unk' means no mapped slot number
 
Probing: normal = ., timing out = t, net unreachable = n, host unreachable = h,
 
wait = w, recovery = r
 
Failure Suppression: no failures = ., recent failure = f, suppressed = s,
 
unmeasured = u
 
Errors: DNS = d, Queue Drop = q, Probe Timeout = t, Network Unreachable = n,
 
Host Unreachable = h, Port Unreachable = p, Other = o
 

 
PS Group   Target          Address         Type Ustat (Slot)     Success Errors
 
ts top-n-e (EFC)           4.2.143.75      icmp 4 (4)                  0 203t
 
.. top-n-e (EFC)           4.2.143.75      icmp 5 (5)                203 0
 
.. top-n-e (EFC)           4.2.143.75      icmp 6 (6)                198 5t
 
.. top-n-e (EFC)           4.2.163.162     icmp 6 (6)                106 105t
 
tu top-n-e (EFC)           4.2.167.130     icmp 4 (4)                  0 203t
 
tu top-n-e (EFC)           4.2.167.130     icmp 5 (5)                  0 203t
 
.. top-n-e (EFC)           4.2.170.194     icmp 6 (6)                220 0 
 

 

This display summarizes the results of two stand-alone active probes configured using the active-measurement target command, on an CNA system that has four USTATs (modules 4, 5 and 6).

P and S columns show normal probing status for four rows and three rows are currently timing out; and outages are not being reported to the decision-maker process for first one (s indicates suppressed).

Possible values for the P column are:

• . (period)--probing activity is normal
• n--the CNA system has received a network unreachable ICMP packet in response to a probe; probing will continue until the network has been unreachable for the length of time specified by the trigger argument of the probe-backoff command
• h--the CNA system has received a host unreachable ICMP packet in response to a probe; probing will continue until the host has been unreachable for the length of time specified by the trigger argument of the probe-backoff command
• t--probing continues, although no response has been received from a probe for the amount of time specified by the timeout argument in the probe configuration; probing will continue until the timeout period specified by the trigger argument of the probe-backoff command
• w--wait-state triggered by probe-backoff; no probes will be sent for the period of time specified by the wait argument of the probe-backoff command
• r--recovery, which means that the system is now attempting to find a convergence point because of probe failures to a target.

Possible values for the O column are:

• . (period)--outages are being reported to the decision-maker process
• f--probe failure
• u--unmeasured; the target has never been successfully probed and no probe failures will be reported to the decision-maker process.
• s--the CNA system has not received a measurement from this prefix for at least the last hour, so the outage report is being suppressed rather than inundating the decision-maker process with reports for possibly non-existent prefixes

Target and Address values are the same for each, since there was no DNS resolution of targets (as there would have been had the targets been specified by host name). Over time, these values can give you insight about how hosts are configured in DNS. Each time the target resolves to a different address, there will be a new entry in the table. By comparing measurement counts, you can discover how often the host name resolves to a specific IP address.

The Module column lists USTATs by name and slot number. On an IBM xSeries platform running CNA, there is no relevant slot or subsystem information, regardless of the number of USTAT modules configured.

The first table compares the number of lines that match the search criteria specified when you launched the command to the number that are actually in the current output. For example, if you execute the show active-measurements command with no search parameters, the Found row will report the total number of probe reports currently in memory. If used with the traceprobe parameter, it will show the last reachable hosts for a given target. If the last reachable hosts are not the same for all ustats, then the measurements are not reported to the database. If you are not seeing measurements for a traceprobe target, you can use this command to help explain this.

However, the command output will never exceed 5,000 lines, so the Shown line will report that number of probes.

If the number of probes found exceeds the number of lines shown, you should refine your search query in order to see the additional probe reports.

The first two lines in the second table show the results of the first configured probe, which targets the address 4.2.143.75 (one line for each of the four USTATs).

In 203 attempts (total of success and errors), the probe succeeded on two of the USTATs and failed on the other one. The error codes indicate that all probes timed out on the first USTAT and five on the second.

Use the command clear active-measurements to clear the data tables and counters displayed by the show active-measurements command. This command also resets the Probing status to '.', the Outage Reporting status to 's', clears the decision-maker process’s knowledge of the data contained in the display, and, for traceprobe targets, forces a traceroute.