# TopN Report

Device>Configure>TopN Report

TopN is a report utility that collects port-specific data for each physical port’s activity during a user-specified interval. For example, TopN collects information such as port utilization, number of in/out bytes, number of in/out packets, number of in/out broadcast packets, number of in/out multicast packets, number of in errors, and number of buffer-overflow errors. The N value — a value specified by the user — is reported for topmost ports so that the traffic load among physical ports can be better analyzed.

Note: The statistics variables are samples of one of their base statistics over an interval specified by the management station. Thus, these statistics are rate-based. You select how many such ports are reported.

TIP: You must specify all options in the upper pane of the TopN configuration window. The report will be generated and displayed in the lower pane after you click the Report button.

TOP PANE CONFIGURATION OPTIONS:

The following variables shown in the upper configuration pane are used to create the TopN report:

Metric (portTopNRateBase)

The metric on which the report is based; select either:

Utilization: portTopNUtilization(1) the port utilization

I/O Octets: portTopNIOOctets(2) the number of in and out octets

I/O Packets: portTopNIOPkts(3) the number of in and out packets

I/O Broadcast Packets: portTopNIOBroadcastPkts(4) the number of in and out broadcast packets

I/O Multicast Packets: portTopNIOMulticastPkts(5) the number of in and out multicast packets

In-Error Packets: portTopNInErrors(6) the number of in error packets

Buffer Overflows: portTopNBufferOverflow(7) the number of buffer overflows

Port Type (portTopNType)

The variable for all ports in this system that the portTopNRate variable is based upon. Select either:

All: portTopNAllPorts(1) all ports

Ethernet: portTopNEthernet(2) ethernet only

Fast Ethernet: portTopNFastEthernet(3) fast ethernet only

Giga Ethernet: portTopNGigaEthernet(4) giga ethernet only

Token Ring: portTopNTokenRing(5) token ring only

FDDI: portTopNFDDI(6) FDDI only

TopN Mode (portTopNMode)

TopN mode is the running mode of this portTopN control entry. portTopNForeground (1) means when portTopNTimeRemaining reaches 0, the report will appear on the CLI and will not be kept in portTopNTable. portTopNBackground (2) means the report will not show on the CLI, it will be kept in the portTopNBackground.

Max. # of Reporting Ports (portTopNRequestedSize)

The maximum number of ports requested for the TopN entry. The valid value for this object is 1 to maximum number of physical ports. The default value is 20 seconds.

Duration (portTopNDuration)

The sampling interval in seconds during which statistics are collected for this report.

Requestor (portTopNOwner)

The requestor is the entity that configured this entry and is therefore using the resources assigned to it.

Note: the query criterion is deleted once the report is generated or failed. The user may also need to re-claim the resource of dead report, and this can be achieved with the button Delete All Reports.

Select a background report and click on Delete Single Report to delete a report from the CLI.

Click Report to generate the TopN Report.

TopN REPORT, LOWER PANE DISPLAY:

The following objects are shown in the lower pane as a result of the generated TopN Report:

# of Granted Ports: (portTopNGrantedSize) the number of ports reported in the portTopNTable.

Start Time: (portTopNStartTime) the sysUpTime when this report was last started.

Report ID

A report number for each report.

Port (portTopNModuleNumber and portTopNPortNumber)

The module/port identification of a port.

Utilization (%) (portTopNUtilization)

Port utilization.

In/Out Total (bytes) (portTopNIOOctets)

The number of in and out octets.

In/Out Total (packets) (portTopNIOPkts)

The number of in and out packets.

In/Out Broadcast (packets) (portTopNIOBroadcast)

The number of in and out broadcast packets.

In/Out Multicast (packets) (portTopNIOMulticast)

The number of in and out multicast packets.

In Error (packets) (portTopNInErrors)

The number of in error packets.

Buffer Overflows (#) (portTopNBufferOverFlow)

The number of overflow errors.

Click Cancel to close the dialog box without making any changes. Click Print to print the contents of the dialog box.