show report

Output snapshot report to monitor.

show report [ <name> [ <object> ] ] 
 
            [ customer <customer-name>
 
            [ time { <timestamp> | last | all } ]
 

• name--name of report; can be one of:
• billing
• distribution-all
• distribution-all-weighted
• distribution-named
• distribution-named-weighted
• distribution-sufficient
• distribution-sufficient-weighted
• executive-summary
• executive-summary-weighted
• hrtt
• measurements
• metric
• observed
• optimized
• outage-link-summary
• outage-prefix-summary
• summary-of-improvements
• summary-of-improvements-weighted
• object--name of router or link (required for selected reports)
• customer-name--name of the customer reports that are defined by <customer>.prefix files (see the customer-prefix-file command)
• timestamp--timestamp of specific report, in yyyy-mm-dd_HH-MM_TZ format
• exp--a regular expression, to be used as a filter
• url--destination for output

System operations mode, login-level access.

The show report command will cause a specified snapshot report to be displayed on the monitor.

For descriptions of individual reports, see Chapter 2: Reports of the CNA Reporting Guide.

If you enter the show report command with partial data and multiple reports match the entry, the output will display a list of the reports that match the data.

For example, entering just show report will cause CNA to display a list of all reports.

If you enter show report executive-summary, the device will display a list of all executive-summary reports.

Specify all or part of a date for timestamp. Reports shown will be those that come closest to matching the specified time.

For example, if you specify only a year, a list of all reports for that year will be displayed. (You must specify everything to the left of the desired time element. If you specify month you must include a year; if you specify day, you must include month and year, and so on.)

The timezone element of timestamp (TZ) should be the three-letter code displayed in the list of reports, not the full timezone name entered with the timezone command.

If you enter show report executive-summary 2002-06, the device will display a list of all executive-summary reports currently on the hard drive with a timestamp any time in June of 2002. Note the use of hyphens as separators between elements of the date and elements of the time, and the use of the underscore to separate date from time.

If only one report matches the partial data, the report itself will be shown.

If you use the last keyword instead of a timestamp, the device will display the most recently saved instance of the specified report.

See also the delete report and export report commands.

You can pipe the command through one of the following filters:

• include--shows all lines in the output which contain a match to the specified regular expression
• exclude--shows all lines in the output except those which contain a match to the specified regular expression
• begin--shows all lines in the output beginning with the first match to the specified regular expression

The vertical-line pipe character | is required when a filter is used.

You can send the output to a remote file location, by piping the display to a remote URL (leading > required). See the copy command for URL syntax.