Skip to content

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#

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.

CheckInterfaces

interfaces.eda.nokia.com / v1

SPEC

CheckInterfacesSpec defines the desired state of CheckInterfaces

  • #
  • #
  • #
  • #

STATUS

CheckInterfacesStatus defines the observed state of CheckInterfaces

  • #
  • #
  • #