bonding`

Provides plugins access to the network bonding information gathered from all the files starteing with “bond.” located in the /proc/net/bonding directory.

Typical content of bond.* file is:

Ethernet Channel Bonding Driver: v3.2.4 (January 28, 2008)

Bonding Mode: IEEE 802.3ad Dynamic link aggregation
Transmit Hash Policy: layer2 (0)
MII Status: up
MII Polling Interval (ms): 500
Up Delay (ms): 0
Down Delay (ms): 0

802.3ad info
LACP rate: slow
Active Aggregator Info:
        Aggregator ID: 3
        Number of ports: 1
        Actor Key: 17
        Partner Key: 1
        Partner Mac Address: 00:00:00:00:00:00

Slave Interface: eth1
MII Status: up
Link Failure Count: 0
Permanent HW addr: 00:16:35:5e:42:fc
Aggregator ID: 3

Slave Interface: eth2
MII Status: up
Link Failure Count: 0
Permanent HW addr: 00:16:35:5e:02:7e
Aggregator ID: 2

Data is modeled as an array of Bond objects (bond being a pattern file specification gathering data from files located in /proc/net/bonding.

Examples

>>> type(bond_info)
<class 'insights.parsers.bond.Bond'>
>>> bond_info.bond_mode
'4'
>>> bond_info.partner_mac_address
'00:00:00:00:00:00'
>>> bond_info.slave_interface
['eth1', 'eth2']
>>> bond_info.aggregator_id
['3', '3', '2']
>>> bond_info.xmit_hash_policy
'layer2'
>>> bond_info.active_slave
>>> bond_info.slave_duplex
['full', 'full']
>>> bond_info.slave_speed
['1000 Mbps', '1000 Mbps']

class insights.parsers.bond.Bond(context)[source]

Bases: Parser

Models the /proc/net/bonding file.

Currently used information from /proc/net/bonding includes the “bond mode” and “partner mac address”.

property active_slave: Returns the active slave of the “Currently Active Slave” in the bond file if key/value exists. If the key is not in the bond file, None is returned.

property aggregator_id: Returns all the aggregator id of in the bond file wrapped a list if the key/value exists. If the key is not in the bond file, [] is returned.

property arp_ip_target: Returns the arp ip target as a string. None is returned if no “ARP IP target/s (n.n.n.n form)” key is found.

property arp_polling_interval: Returns the arp polling interval as a string. None is returned if no “ARP Polling Interval (ms)” key is found.

property bond_mode: Returns the bond mode number as a string, or if there is no known mapping to a number, the raw “Bonding Mode” value. None is returned if no “Bonding Mode” key is found.

property data: Returns all the details of bond interface and corresponding slave details on sucess else it will return empty {}.

property down_delay: Returns the “Down Delay” in the bond file if key/value exists. If the key is not in the bond file, None is returned.

property mii_polling_interval: Returns the mii polling interval as a string. None is returned if no “MII Polling Interval (ms)” key is found.

property mii_status: Returns the master and all the slaves “MII Status” value in the bond file wrapped a list if the key/value exists. If the key is not in the bond file, [] is returned.

parse_content(content)[source]: This method must be implemented by classes based on this class.

property partner_mac_address: Returns the value of the “Partner Mac Address” in the bond file if the key/value exists. If the key is not in the bond file, None is returned.

property primary_slave: Returns the “Primary Slave” in the bond file if key/value exists. If the key is not in the bond file, None is returned.

property slave_duplex: Returns all the slave “Duplex” value in the bond file wrapped a list if the key/value exists. If the key is not in the bond file, [] is returned.

property slave_interface: Returns all the slave interfaces of in the bond file wrapped a list if the key/value exists. If the key is not in the bond file, [] is returned.

property slave_link_failure_count: Returns all the slaves “Link Failure Count” value in the bond file wrapped a list if the key/value exists. If the key is not in the bond file, [] is returned.

property slave_speed: Returns all the slaves “Speed” value in the bond file wrapped a list if the key/value exists. If the key is not in the bond file, [] is returned.

property up_delay: Returns the “Up Delay” in the bond file if key/value exists. If the key is not in the bond file, None is returned.

Bond - file /proc/net/bonding

Bond - file `/proc/net/bonding`