# Port Schema Statistics

The Port schema provides operational statistics that can be used for monitoring and troubleshooting the following products: All
This schema provides the following types of statistics:

- Counter: A counter records incremental data cumulatively and rolls over when the counter limit is reached. All counter statistics are cumulative and reset only by one of the following methods: roll-over when limit is reached, after a system restart, or after a clear command is performed. The limit depends upon the data type.
- Gauge: A gauge statistic indicates a single value; a snapshot representation of a single point in time within a defined time frame. The gauge changes to a new value with each snapshot though a value may repeat from one period to the next. The limit depends upon the data type.
- Information: This type of statistic provides information, often intended to differentiate sets of statistics; for example, a VPN name or IP address. The type of information provided depends upon the data type.

The data type defines the format of the data for the value provided by the statistic. The following data types are used in statistics for this schema:

- Int32/Int64: An integer, either 32-bit or 64-bit: For statistics with the Int32 data type, the roll-over to zero limit is 4,294,967,295. For statistics with the Int64 data type, the roll-over to zero limit is 18,446,744,073,709,551,615.
- Float: A numeric value that can be represented fractionally; for example, 1.345.
- String: A series of ASCII alphanumeric characters in a single grouping, usually pre-configured.

IMPORTANT:

Unless otherwise indicated, all statistics are counters and all statistics are standards-based.

Key Variables: Every schema has some variables which are typically referred to as 'key variables'. These key variables provide index markers to identify which object the statistics apply to. For example, in the card schema, the card number (variable %card%) uniquely identifies a card. For an HA service, the keys would be "%vpnname%" plus "%servname%", as the combination uniquely identifies an HA service. So, in a given measurement interval, one row of statistics will be generated per unique key. The schema keys are identified in the Description section of the table.
Table 1. Bulk Statistic Variables in the Port-level Schema

Variables | Description | Data Type
--- | --- | ---
card | Description: Chassis slot numbers. This is a key variable. Type: Information | Int32
port | Description: Port number on the card. This is a key variable. Type: Information | Int32
maxrate | Description: The maximum physical data rate for the port. Type: Information | Int64
rxbytes | Description: The number of bytes received over the port. Type: Counter | Int64
txbytes | Description: The number of bytes transmitted over the port. Type: Counter | Int64
ucast_inpackets | Description: The number of unicast packets received over the port. Type: Counter This statistic is not supported for SPIO ports. | Int64
ucast_outpackets | Description: The number of unicast packets sent over the port. Type: Counter This statistic is not supported for SPIO ports. | Int64
mcast_inpackets | Description: The number of multicast packets received over the port. Type: Counter This statistic is not supported for SPIO ports. | Int64
mcast_outpackets | Description: The number of multicast packets sent over the port. Type: Counter This statistic is not supported for SPIO ports. | Int64
bcast_inpackets | Description: The number of broadcast packets received over the port. Type: Counter This statistic is not supported for SPIO ports. | Int64
bcast_outpackets | Description: The number of broadcast packets sent over the port. Type: Counter This statistic is not supported for SPIO ports. | Int64
rxpackets | Description: The number of packets received over the port. Type: Counter | Int64
txpackets | Description: The number of packets transmitted over the port. Type: Counter | Int64
rxdiscbytes | Description: The number of bytes received over the port that were discarded. Type: Counter | Int64
rxdiscpackets | Description: The number of packets received over the port that were discarded. Type: Counter | Int64
txdiscbytes | Description: The number of bytes transmitted over the port that were discarded. Type: Counter | Int64
txdiscpackets | Description: The number of packets transmitted over the port that were discarded. Type: Counter | Int64
rxerrorbytes | Description: The number of error bytes received over the port. Type: Counter | Int64
rxerrorpackets | Description: The number of error packets received over the port. Type: Counter | Int64
txerrorbytes | Description: The number of error bytes transmitted over the port. Type: Counter | Int64
txerrorpackets | Description: The number of error packets transmitted over the port. Type: Counter | Int64
frag-rcvd | Description: The number of fragments received on this port. Type: Counter | Int64
pkt-reassembled | Description: The number of packets re-assembled from fragments received on this port. Type: Counter | Int64
frag-tokernel | Description: The number of fragments received on this port and sent to the kernel. Type: Counter | Int64
util-rx-curr | Description: The current average port utilization for received data in Mbps. Type: Gauge | Int64
util-tx-curr | Description: The current average port utilization for transmitted data in Mbps. Type: Gauge | Int64
util-rx-5min | Description: The average port utilization for received data over the last five minutes in Mbps. Type: Gauge | Int64
util-tx-5min | Description: The current average port utilization for transmitted data over the last five minutes in Mbps. Type: Gauge | Int64
util-rx-15min | Description: The average port utilization for received data over the last 15 minutes in Mbps. Type: Gauge | Int64
util-tx-15min | Description: The current average port utilization for transmitted data over the last 15 minutes in Mbps. Type: Gauge | Int64
port-5peak-rx-util | Description: This is the peak Rx port utilization for a 1-minute average over the last 5 minutes. Type: Gauge | Int64
port-5peak-tx-util | Description: This is the peak Tx port utilization for a 1-minute average over the last 5 minutes. Type: Gauge | Int64
port-15peak-rx-util | Description: This is the peak Rx port utilization for a 1-minute average over the last 15 minutes. Type: Gauge | Int64
port-15peak-tx-util | Description: This is the peak Tx port utilization for a 1-minute average over the last 15 minutes. Type: Gauge | Int64
IMPORTANT: For information on statistics that are common to all schema see the Statistics and Counters Overview chapter.