Network adapter port metric group

OSA and RoCE network adapters have up to two physical ports that connect to the network. Metrics are collected from these ports on a DPM enabled system and provided to the user. This metrics group will contain metrics data representing metrics for one physical port. Metrics are collected and provided on an interval, and each metric provided is the total cumulative value, and not a delta.

Metric Group Name
"network-physical-adapter-port"
Collection Interval
30 seconds
Applicable Managed Object Class
"adapter"

The following metrics are provided in each entry of this metric group:

Table 1. Network adapter port metric group
Pos Metric field name Type Units Description
1 network-port-id Integer   Numerical value corresponding to the network adapter's physical port. For OSA adapters, this value can be either 0 or 1, and for RoCE adapters, this value can be 1 or 2. To get more information about the physical port, a URI can be constructed using this value together with the target adapter-id:
/api/adapters/{adapter-id}/network-ports/{network-port-id}
2 bytes-sent Long Bytes Number of bytes this physical port sent out to the attached network.
3 bytes-received Long Bytes Number of unicast packets this physical port received from the attached network.
4 packets-sent Long Count Number of unicast packets this physical port sent out to the attached network.
5 packets-received Long Count Number of unicast packets this physical port received from the attached network.
6 packets-sent-dropped Long Count Number of packets that were dropped when this physical port was sending them out to the attached network.

Packets may be dropped due to conditions related to resource constraints such as a buffer shortage.

7 packets-received-dropped Long Count Number of packets that were dropped when this physical port was receiving them from the attached network.

Packets may be dropped due to conditions related to resource constraints such as a buffer shortage.

8 packets-sent-discarded Long Count Number of packets that were discarded when this physical port was sending them out to the attached network.

Packets may be discarded due to errors such as malformed packets.

9 packets-received-discarded Long Count Number of packets that were discarded when this physical port was receiving them from the attached network.

Packets may be discarded due to errors such as malformed packets.

10 multicast-packets-sent Long Count Number of multicast packets this physical port sent out to the attached network.
11 multicast-packets-received Long Count Number of multicast packets this physical port received from the attached network.
12 broadcast-packets-sent Long Count Number of broadcast packets this physical port sent out to the attached network.
13 broadcast-packets-received Long Count Number of broadcast packets this physical port received from the attached network.
14 interval-bytes-sent Long Bytes Number of bytes sent by this physical port over the collection interval.
15 interval-bytes-received Long Bytes Number of bytes received by this physical port over the collection interval.
16 bytes-per-second-sent Long Bytes per second Number of bytes sent per second by this physical port over the collection interval.
17 bytes-per-second-received Long Bytes per Second Number of bytes per second received by this physical port over the collection interval.
18 utilization Long Percentage Link utilization expressed as usage percentage of overall link bandwidth.
19 mac-address String   The MAC address of this uplink, if known. If it is not known, then "N/A".
20 flags Long   Flags indicating the types of metrics that are supported by this interface. The value of this field should be interpreted as a bitmask. The meaning of each bit is as follows:
  • 0x02 - Byte counts are supported
  • 0x04 - Packet counts are supported
  • 0x08 - Drop counts are supported
  • 0x10 - Discard counts are supported
  • 0x20 - Multicast counts are supported
  • 0x40 - Broadcast counts are supported
  • 0x80 - Interval bytes sent and received are supported