Ethernet Statistics Properties

NI-XNET 19.1 Help

Edition Date: June 2019

Part Number: 372841W-01

»View Product Info
Download Help (Windows Only)

This category includes statistical counters for the session's Ethernet interface.

Counter Names and Counter Values properties each return an array of strings (both same size), displaying all name/value pairs. Each string is returned separately so that you can customize the display.

Receive (Rx) and Transmit (Tx) statistics (for example, see Rx Bytes) return more specific statistics as unsigned long integers (U64 datatype).

When the Port Mode of the session interface is Direct, receive and transmit statistics are relative to this interface. When the Port Mode is Tap, receive statistics refer to this session's interface, and the values of all transmit statistics do not increment. (To obtain statistics for frames received by the Tap partner, use a session with the Tap partner interface.) Refer to Using Ethernet for more information about Direct and Tap port modes.

When the description of a statistic refers to frame length, that length is measured from the start of the destination MAC address to the last octet of the Frame Check Sequence.

The statistics refer to good (error-free) frames and bad frames. On the endpoint path (e.g., "ENET1"), only good frames are returned from XNET Read. On the monitor path (e.g., "ENET1/monitor"), good and bad frames are returned from XNET Read.

These statistics are counted at the Media Access Control (MAC) layer. Therefore, when Port Mode is Direct, the statistics apply to all receives frames, including those forwarded to the OS stack as well as the XNET endpoint (see Interface:Ethernet:Endpoint:Receive Filter). The number of good frames returned from XNET Read might not match with the number of good frames counted by these statistics.

Note Note  All statistics are reset when the system powers up or the device is reset.

List of Ethernet Statistics

The following table lists the name and description of each Ethernet statistic in this version of NI-XNET. Some statistics in this table might not provide a named property to obtain a single value, with the expectation that the statistic is only appropriate for display purposes.

Name Description
Rx Bytes Count of the number of bytes (octets) received. The count for each frame is its frame length. Bad frames are counted in addition to good frames. Read this counter twice to obtain an estimate of received bandwidth over the time between the two reads.

This statistic corresponds to etherStatsOctets as described in RFC 2819.

Rx Good Frames Count of error-free frames received. This count is equal to (Rx Good Unicast + Rx Good Multicast + Rx Good Broadcast).
Rx Bad Frames Count of frames received with an error detected by the Ethernet MAC and/or PHY.

This statistic corresponds to ifInErrors as described in RFC 2863.

Rx Good Unicast Count of error-free unicast frames received. A unicast frame contains a destination MAC address with an I/G bit of 0 (individual address).

This statistic corresponds to ifHCInUcastPkts in RFC 2863.

Rx Good Multicast Count of error-free multicast frames received. A multicast frame contains a destination MAC address with an I/G bit of 1 (group address), and an address that is not the all-stations broadcast address (all 1's).

This statistic corresponds to ifHCInMulticastPkts in RFC 2863, and etherStatsMulticastPkts in RFC 2819.

Rx Good Broadcast Count of error-free broadcast frames received. A broadcast frame contains a destination MAC address with an I/G bit of 1 (group address), and uses the all-stations broadcast address (all 1's).

This statistic corresponds to ifHCInBroadcastPkts in RFC 2863, and etherStatsBroadcastPkts in RFC 2819.

Rx Good VLAN Tagged Count of error-free VLAN tagged frames received. For information on VLAN tagged frames, refer to Read (Frame Ethernet).
Rx Good Pause Frames Count of error-free PAUSE frames received. A PAUSE frame contains EtherType of 8808 hex (MAC Control), and payload with an opcode of PAUSE.
Rx Good 64 Byte Frames Count of error-free frames received with a frame length of exactly 64 bytes.

This statistic corresponds to etherStatsPkts64Octets as described in RFC 2819.

Rx Good 65 to 127 Byte Frames Count of error-free frames received with a frame length between 65 and 127 bytes.

This statistic corresponds to etherStatsPkts65to127Octets as described in RFC 2819.

Rx Good 128 to 255 Byte Frames Count of error-free frames received with a frame length between 128 and 255 bytes.

This statistic corresponds to etherStatsPkts128to255Octets as described in RFC 2819.

Rx Good 256 to 511 Byte Frames Count of error-free frames received with a frame length between 256 and 511 bytes.

This statistic corresponds to etherStatsPkts256to511Octets as described in RFC 2819.

Rx Good 512 to 1023 Byte Frames Count of error-free frames received with a frame length between 512 and 1023 bytes.

This statistic corresponds to etherStatsPkts512to1023Octets as described in RFC 2819.

Rx Good 1024 to Max Byte Frames Count of error-free frames received with a frame length between 1024 and the maximum specified by IEEE Std 802.3. For information on maximum frame length, refer to Read (Frame Ethernet).

This statistic corresponds to etherStatsPkts1024to1518Octets as described in RFC 2819.

Rx Frame Check Sequence Errors Count of received frames that had a bad Frame Check Sequence, and frame length is between 64 and the maximum specified by IEEE Std 802.3.

This statistic corresponds to etherStatsCRCAlignErrors as described in RFC 2819.

Rx Undersize Frames Count of received frames that were fewer than 64 bytes in length, but otherwise well formed.

This statistic corresponds to etherStatsUndersizePkts as described in RFC 2819.

Rx Fragment Frames Count of received frames that were fewer than 64 bytes in length, and had a bad Frame Check Sequence.

This statistic corresponds to etherStatsFragments as described in RFC 2819.

Rx Oversize Frames Count of received frames that exceeded the maximum frame length specified by IEEE Std 802.3. For information on maximum frame length, refer to Read (Frame Ethernet).

This statistic corresponds to etherStatsOversizePkts as described in RFC 2819.

Rx Invalid Opcode Count of frames received with EtherType of 8808 hex (MAC Control), and payload with an opcode that was not PAUSE.
Tx Bytes Count of the number of bytes (octets) transmitted. The count for each frame is its frame length. Read this counter twice to obtain an estimate of transmitted bandwidth over the time between the two reads.
Tx Good Frames Count of error-free frames transmitted. This count is equal to (Tx Good Unicast + Tx Good Multicast + Tx Good Broadcast).
Tx Good Unicast Count of error-free unicast frames transmitted. A unicast frame contains a destination MAC address with an I/G bit of 0 (individual address).

This statistic corresponds to ifHCOutUcastPkts in RFC 2863.

Tx Good Multicast Count of error-free multicast frames transmitted. A multicast frame contains a destination MAC address with an I/G bit of 1 (group address), and an address that is not the all-stations broadcast address (all 1's).

This statistic corresponds to ifHCOutMulticastPkts in RFC 2863.

Tx Good Broadcast Count of error-free broadcast frames transmitted. A broadcast frame contains a destination MAC address with an I/G bit of 1 (group address), and uses the all-stations broadcast address (all 1's).

This statistic corresponds to ifHCOutBroadcastPkts in RFC 2863.

Tx Good VLAN Tagged Count of error-free VLAN tagged frames transmitted. For information on VLAN tagged frames, refer to Write (Frame Ethernet).
Tx Good Pause Frames Count of error-free PAUSE frames transmitted. A PAUSE frame contains EtherType of 8808 hex (MAC Control), and payload with an opcode of PAUSE.
Tx Good 64 Byte Frames Count of error-free frames transmitted with a frame length of exactly 64 bytes.
Tx Good 65-127 Byte Frames Count of error-free frames transmitted with a frame length between 65 and 127 bytes.
Tx Good 128-255 Byte Frames Count of error-free frames transmitted with a frame length between 128 and 255 bytes.
Tx Good 256-511 Byte Frames Count of error-free frames transmitted with a frame length between 256 and 511 bytes.
Tx Good 512-1023 Byte Frames Count of error-free frames transmitted with a frame length between 512 and 1023 bytes.
Tx Good 1024-Max Byte Frames Count of error-free frames transmitted with a frame length between 1024 and the maximum specified by IEEE Std 802.3. For information on maximum frame length, refer to a Write (Frame Ethernet).

WAS THIS ARTICLE HELPFUL?

Not Helpful