Leaf-Level Support for PFE Sensors
You can configure leaf-level resource paths for telemetry data export on network devices to reduce computational overhead and bandwidth usage. This feature allows selective querying of specific data elements, such as interface operational status or packet counters, instead of exporting data for all instances of a resource. By focusing on relevant leaves, you obtain precise information efficiently, enhancing performance for telemetry collectors.
Using this leaf level support feature, any path till a given element can be configured and just data corresponding to that element is exported.
The following XPATH leaf options are supported:
-
Precise leaf such as
/interfaces/interface[name='et-1/0/35']/state/counters/in-pkts -
A container within the path such as
/interfaces/interface[name='et-1/0/35']/state/counters/ -
A list within the path
/interfaces/interface/ -
Exported leafs for IFD/IFL/Queues
Following is the full list of leafs that are exported for physical, logical interfaces and their associated queues.
- IFD or Physical
Interfaces
interfaces/interface/state/counters/in-pkts interfaces/interface/state/counters/in-octets interfaces/interface/state/counters/in-unicast-pkts interfaces/interface/state/counters/in-broadcast-pkts interfaces/interface/state/counters/in-multicast-pkts interfaces/interface/state/counters/in-pause-pkts interfaces/interface/state/counters/in-discards interfaces/interface/state/counters/in-errors interfaces/interface/state/counters/in-unknown-proto-pkts interfaces/interface/state/counters/out-pkts interfaces/interface/state/counters/out-octets interfaces/interface/state/counters/out-unicast-pkts interfaces/interface/state/counters/out-broadcast-pkts interfaces/interface/state/counters/out-multicast-pkts interfaces/interface/state/counters/out-pause-pkts interfaces/interface/state/counters/out-discards interfaces/interface/state/counters/out-errors interfaces/interface/state/counters/out-unknown-proto-pkts
- IFD
Queues
interfaces/interface/state/counters/out-queue/queue-number interfaces/interface/state/counters/out-queue/pkts interfaces/interface/state/counters/out-queue/bytes interfaces/interface/state/counters/out-queue/tail-drop-pkts interfaces/interface/state/counters/out-queue/tail-drop-bytes interfaces/interface/state/counters/out-queue/rl-drop-pkts interfaces/interface/state/counters/out-queue/rl-drop-bytes interfaces/interface/state/counters/out-queue/red-drop-pkts interfaces/interface/state/counters/out-queue/red-drop-bytes interfaces/interface/state/counters/out-queue/avg-buffer-occupancy interfaces/interface/state/counters/out-queue/cur-buffer-occupancy interfaces/interface/state/counters/out-queue/peak-buffer-occupancy interfaces/interface/state/counters/out-queue/allocated-buffer-size
- IFL or Logical
Interfaces
interfaces/interface/subinterfaces/subinterface/state/counters/in-pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-octets interfaces/interface/subinterfaces/subinterface/state/counters/out-pkts interfaces/interface/subinterfaces/subinterface/state/counters/out-octets interfaces/interface/subinterfaces/subinterface/state/counters/in-unicast-pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-multicast-pkts interfaces/interface/subinterfaces/subinterface/state/counters/out-unicast-pkts interfaces/interface/subinterfaces/subinterface/state/counters/out-multicast-pkts
- IFL
Queues
interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/queue-number interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/bytes interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/tail-drop-pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/tail-drop-bytes interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/rl-drop-pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/rl-drop-bytes interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/red-drop-pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/red-drop-bytes interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/avg-buffer-occupancy interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/cur-buffer-occupancy interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/peak-buffer-occupancy interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/allocated-buffer-size interfaces/interface/subinterfaces/subinterface/state/counters/out-queue/queue-number interfaces/interface/subinterfaces/subinterface/state/counters/out-queue/pkts interfaces/interface/subinterfaces/subinterface/state/counters/out-queue/bytes interfaces/interface/subinterfaces/subinterface/state/counters/out-queue/tail-drop-pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/rl-drop-pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/rl-drop-bytes interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/red-drop-pkts interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/red-drop-bytes interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/avg-buffer-occupancy interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/cur-buffer-occupancy interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/peak-buffer-occupancy interfaces/interface/subinterfaces/subinterface/state/counters/in-queue/allocated-buffer-size interfaces/interface/subinterfaces/subinterface/state/counters/out-queue/queue-number interfaces/interface/subinterfaces/subinterface/state/counters/out-queue/pkts interfaces/interface/subinterfaces/subinterface/state/counters/out-queue/bytes interfaces/interface/subinterfaces/subinterface/state/counters/out-queue/tail-drop-pkts
Note:
- Leaf level support is applicable to both gRPC and gNMI transport modes.
- Leaf level subscription is not supported for leaves where configuration and exported paths are different.