Check Interfaces#

Workflows → CICheck Interfaces

The CheckInterfaces workflow is used to check the health of Interfaces. It loops over all nodes selected by the nodeSelectors and nodes properties, and checks every interface that matches the label(s) specified in the interfaceSelectors property.

Checks#

By default, the workflow checks that all members of all selected Interfaces are operationally up. Additional checks can be run against the counters of each interface. Each check monitors a particular metric for waitTimeSeconds seconds and fails if the timer has increased during this window.

Unless explicitly mentioned, these checks are only supported on Nokia SR Linux and SR OS.

EthernetCRC: checks if any CRC error frames were received
EthernetFrameSize: checks for oversized, undersized (< 64 bytes), and jabber (oversized with bad CRC) frames received on the interface
EthernetPauseFrames: checks for received pause frames that indicate congestion
CarrierTransitions: checks whether the link is "flapping"
DiscardedPackets: checks whether packets were discarded on ingress or egress
TransceiverHealth: checks whether the transceiver has reset during the time window
LACPErrors: checks for any errors reported through the Link Aggregation Control Protocol (LACP)
IfPacketErrors: checks for packet errors both in the ingress and egress direction

Dependencies#

The CheckInterfaces workflow does not depend on any other resources.

Referenced resources#

`TopoNode`#

The workflow selects nodes that it will check interfaces on through the nodeSelectors and nodes properties.

Note

Only interfaces that have a matching Interface will be checked.

Examples#

YAMLkubectl

apiVersion: interfaces.eda.nokia.com/v1
kind: CheckInterfaces
metadata:
  name: checkinterfaces-20b8144f-a4b6-488a-ac5b-4c5f8cc27502
  namespace: eda
spec:
  interfaceSelectors:
    - eda.nokia.com/role = interSwitch
  checkStateCounters:
    skip: false
    waitTimeSeconds: 30
    checks:
      - LACPErrors
      - TransceiverHealth
  nodeSelectors:
    - eda.nokia.com/role = leaf
    - eda.nokia.com/role = spine

cat << 'EOF' | kubectl apply -f -
apiVersion: interfaces.eda.nokia.com/v1
kind: CheckInterfaces
metadata:
  name: checkinterfaces-20b8144f-a4b6-488a-ac5b-4c5f8cc27502
  namespace: eda
spec:
  interfaceSelectors:
    - eda.nokia.com/role = interSwitch
  checkStateCounters:
    skip: false
    waitTimeSeconds: 30
    checks:
      - LACPErrors
      - TransceiverHealth
  nodeSelectors:
    - eda.nokia.com/role = leaf
    - eda.nokia.com/role = spine
EOF

Custom Resource Definition#

To browse the Custom Resource Definition go to crd.eda.dev.

SPEC

CheckInterfacesSpec defines the desired state of CheckInterfaces

#
Configure checking state paths for erroneous counter increments.
- #
- #
- #
#
#
#

STATUS

CheckInterfacesStatus defines the observed state of CheckInterfaces

#
Details contains the results of the checks performed on each node. Each entry in the list corresponds to a node where the Operational State has been checked.
- #
#