show prefix
Displays information about a prefix or group of prefixes.
show [ last ] prefix
[ all |
sufficient |
asserted |
<prefix> |
<address> |
<domain-name> |
alias <alias-name> |
group <group_name> |
using-policy <policy-name>
]
[ trended-live ]
[ limit <number> ]
{ application |
application-loss |
application-performance |
application-delay |
measurements |
raw-measurements |
observed |
optimized |
policy |
info |
hrtt |
metric |
network-loss |
jitter |
quality-metric |
reliability |
rtt
summary
traffic-counter
traffic-rate
}
[ > <url> ]
- prefix--individual prefix address, in CIDR format (a.b.c.d/n)
- address--individual IP address, in dotted decimal format (a.b.c.d)
- alias-name--prefix alias (see report prefix-alias command)
- group_name--name of prefix group (see report group command)
- policy_name--name of policy (see decision-policy command)
- number--number of prefixes to include in output (range 0 through 1,000,000; default is 500; specifying 0 indicates no limit)
- url--destination for output
System operations mode, login-level access.
none
The show prefix command will display a variety of data related to prefixes.
Use the last keyword to obtain the data from the snapshot database maintained on the reporting module.
If you omit the last keyword, the data displayed will be taken from the live database maintained on the engine module. Avaya strongly recommends that whenever you specify all, you also use the last keyword. Generating data for all prefixes can consume an enormous amount of system resources.
Use the keyword all to display data for all prefixes in the database.
Use the trended-live keyword to show only those prefixes that are currently being trended live.
The keyword limit followed by a number limits the number of prefixes in the display. Set limit to 0 for no restriction on quantity (all prefixes meeting the specified criteria will be included in the output).
Use the keyword sufficient to limit the display to prefixes which have met the criteria for route assertion (minimum required measurements have been received for the prefix, and the prefix is reachable by at least two service provider links).
You can filter prefixes by substituting values for any one of the following optional arguments: number, prefix, address, domain-name, or group.
You can specify any of the following data-type keywords:
- application--output will display information for each application (or group of applications) on all networks.
- application-loss--output will display loss statistics for all links associated with the specified prefixes.
- application-performance--output will display performance ratings from 1.0 (worst) to 5.0 (best) for all links associated with the specified prefixes.
- application-delay--output will display an estimate (given the raw measurements observed for a prefix) of the application delay that would be experienced for all links associated with the specified prefixes.
- measurements--display will show a table of measurement data for each service provider link on each prefix, including number of measurements made, average inter-measurement time (IMT), and time since last measurement (TSLM).
- raw measurements--display will show actual measurement values for all links associated with the specified prefixes. These data include round trip time (RTT), jitter, loss, and TCP-based round trip time (HRTT).
- observed--display will show a comparison of HRTT scores for the best-performing, worst-performing link, and BGP-selected link on each edge router. For details about the contents of the display, see Observed report in Chapter 2: Reports of the CNA Reporting Guide.
- optimized--all data associated with the specified prefixes obtained from the specified router (identified by address or alias defined by the neighbor report-alias command)
- policy--display will show information on the decision policy of the specified prefixes.
- info--display will show summary information for the specified prefix.
- hrtt--output will display handshake round trip time (HRTT) values obtained from CNA’s user traffic tests (UTT) and TCP probes, in milliseconds for all links associated with the specified prefixes.
- metric--display will show an index for each prefix listed (a number in the range 0 through 1,000 calculated from HRTTs and user-defined penalty) depicting the quality of a web transaction as perceived by the end user; CNA uses this metric as a basis for making routing decisions (smaller is better)
- network-loss--output will display the average loss for all links associated with the specified prefixes. These values are available only for prefixes receiving measurements from ICMP or traceprobe active-probing.
- jitter--displays the average jitter values in milliseconds for all links associated with the specified prefixes. Jitter is calculated as the difference between consecutive round trip time (RTT) values. Jitter is available only for prefixes receiving measurements from ICMP or traceprobe active-probing.
- quality-metric--output will display a quality index for all links associated with the given prefixes. The index, which is calculated form raw measurements, ranges from 0 (best) to 1000 (worst) and is indicative of the quality of the performance of each link per prefix.
- reliability--the average time a link is in the winner set for each prefix
- rtt--output will display round trip time (RTT) values, in milliseconds, for all links associated with the specified prefixes. RTT is available only for prefixes receiving measurements from ICMP or traceprobe active-probing.
- traffic-counter--output will display application since the start of CNA.
- traffic-rate--output will display average traffic rate l.
Prefix categories are:
- A--advised winner (CNA has asserted a route for this prefix that is better than the one selected by BGP but the router has not yet confirmed that it has switched)
- B--BGP winner (CNA has determined that the route chosen by BGP is in fact the best path to this prefix)
- C--confirmed winner (CNA has asserted a route for this prefix that is better than the one selected by BGP and the router has confirmed that it has switched)
- D--determined winner (CNA has determined that a route for this prefix is better than the one selected by BGP but has not yet asserted this route to the router)
- I--insufficient data (CNA has not yet received enough measurement tests from this prefix; or the BGP next hop is unknown to CNA)
- N--not used; prefix is in the BGP table, but CNA considers it to be an invalid route
- R--remote BGP; traffic to the prefix is routed through a service provider link that is not defined in the CNA configuration
- U--unavailable data (prefix is in the BGP table but CNA has no measurement data for it)
The category identifier may also show one or both of the following symbols:
- ~--new data (measurement data has been received for this prefix but nothing has not yet been processed)
- ^--non-bgp prefix; CNA learned of this prefix from some source other than BGP (a private, VPN-related prefix added by the set-decision-policy command, for example)
When load optimization is enabled, the prefix category will also be accompanied by one of the following labels, indicating how the winner was chosen:
- r--winner was selected from the regular winner set
- e--winner was selected from the extended winner set
- h--all links hot; winner is “least hot”
- j--no eligible winner in the extended winner set at the threshold-table level appropriate for current usage; the decision-maker process had to jump to a higher level (indicates a narrow extended winner set; you should consider increasing the size)
- l--no eligible winners could be selected by the load optimization algorithm; winner selected by load optimization (current usage has exceeded the maximum total load configured at the highest level of your load threshold table; it means that either the table is not configured correctly or you have insufficient capacity to meet demand)
The level indicator label will be accompanied by the total load value configured for that level.
Service provider links may be labeled by one or more of the following codes in some displays:
- a--CNA has asserted link to be best path
- b--link selected by BGP (multiple links may show b label for a single prefix, if there are multiple routers)
- h--link has been categorized as hot by CNA decision-maker process. See Determining the Winner Set in Chapter 2: WAN Cost and Load Optimization of the CNA Adaptive Path Controller Guide.
- i--data is invalid; link no longer considered reliable for this prefix
- o--outage detected; prefix is no longer generating measurement traffic
- s--link is in winner set (see winner-set-width command)
- w--link is CNA-determined winner (best path to prefix)
Output of the show prefix command can be diverted to a file, using the > character as a keyword, followed by a file name in URL format (see the copy command for information about supported protocols and URL syntax).
Note that a space is required between the > character and the URL.
NOTE: Occasionally, the show prefix command will fail with an “unknown error” message. This could be due to a conflict with a database task being executed by CNA concurrently with your show prefix request. Wait a few minutes and reissue the show prefix command.
See also the report prefix-limit command.
