New and Updated Telemetry Metrics
The following tables list the new, updated, and deprecated gNMI and OTEL metrics in Cumulus Linux 5.19.
New gNMI Metrics
| Name | Description |
|---|---|
/frr-bgp-peer:lib/vrf[id=<vrf-id>]/ipv4-unreach-prefix-count |
Number of IPv4 prefixes in the BGP unreachability table. |
/frr-bgp-peer:lib/vrf[id=<vrf-id>]/ipv6-unreach-prefix-count |
Number of IPv6 prefixes in the BGP unreachability table. |
/frr-zebra:lib/vrf[id=<vrf-id>]/ipv4-lldp-exception/exception-count |
Number of unreachable IPv4 prefixes the switch holds to export to LLDP, excluding the default route exception. |
/frr-zebra:lib/vrf[id=<vrf-id>]/ipv4-lldp-exception/default-exception-active |
Whether the IPv4 default route exception is active. |
/frr-zebra:lib/vrf[id=<vrf-id>]/ipv6-lldp-exception/exception-count |
Number of unreachable IPv6 prefixes the switch holds to export to LLDP, excluding the default route exception. |
/frr-zebra:lib/vrf[id=<vrf-id>]/ipv6-lldp-exception/default-exception-active |
Whether the IPv6 default route exception is active. |
/frr-zebra:lib/lldp-export-stats/exception-add-total |
Number of unreachable prefixes sent to LLDP since the routing service started, including resynchronization replays. |
/frr-zebra:lib/lldp-export-stats/exception-remove-total |
Number of unreachable prefix withdrawals sent to LLDP since the routing service started. |
/frr-zebra:lib/lldp-export-stats/default-exception-add-total |
Number of default route exceptions sent to LLDP since the routing service started, counted separately for each VRF and address family. |
/frr-zebra:lib/lldp-export-stats/default-exception-remove-total |
Number of default route exception withdrawals sent to LLDP since the routing service started. |
/frr-zebra:lib/debug/lldp-export-channel/connected |
Whether the LLDP export channel is up. |
/frr-zebra:lib/debug/lldp-export-channel/errors-total |
Number of unreachable prefix updates that failed to reach LLDP since the routing service started. |
| Name | Description |
|---|---|
/components/component[name]/state/name |
Component instance name. Cumulus Linux 5.19 adds the name for the ASIC and for transceivers. |
/components/component[name]/state/type |
OpenConfig component type. Cumulus Linux 5.19 adds the type for the ASIC, transceivers, fans, storage disks, and temperature and leakage sensors. |
| Name | Description |
|---|---|
/interfaces/interface[name=<interface-id>]/step-time-estimation/state/step-time-estimate |
Estimated step time, in seconds, of the AI training workload running on the interface. Requires step time estimation. |
| Name | Description |
|---|---|
/performance/interfaces/interface[name]/histograms/microburst/direction[dir][quantity] |
Per-interface microburst telemetry container. dir is rx or tx; quantity is packets or bytes. |
/performance/interfaces/interface[name]/histograms/microburst/direction[dir][quantity]/bin[upper-boundary]/count |
Histogram bin count for the most recent collection window. The value covers a single collection window and resets on read. |
/performance/interfaces/interface[name]/histograms/microburst/direction[dir][quantity]/score |
Burstiness score computed as σ² × μ in bin-index space. |
/performance/interfaces/interface[name]/histograms/microburst/direction[dir][quantity]/mean-bin-index |
Mean bin index μ over the current window. |
/performance/interfaces/interface[name]/histograms/microburst/direction[dir][quantity]/distribution-variance |
Bin-index variance σ² over the current window. |
/performance/interfaces/interface[name]/histograms/microburst/direction[dir][quantity]/peak-value |
Raw max_watermark value for the current window. Interpretation depends on quantity. |
/performance/interfaces/interface[name]/histograms/microburst/direction[dir][quantity]/threshold-state |
Operational threshold state for the configured score threshold. |
/performance/interfaces/interface[name]/histograms/microburst/direction[dir][quantity]/last-triggered |
Last time the threshold entered triggered state. Absent or unset if never triggered. |
The telemetry model names the packets or bytes selector quantity, where the NVUE command that configures it is unit. The two names refer to the same setting; quantity avoids a collision with the standard OTEL instrument descriptor field.
For information about gNMI, refer to gNMI Streaming.
New OTEL Metrics
| Name | Description |
|---|---|
nvswitch_wjh_total_events |
The total number of WJH drop-trap events received on the channel, before aggregation. |
nvswitch_wjh_channel_trigger |
Which triggers are enabled for each channel. |
| Name | Description |
|---|---|
nvrouting_bgp_unreach_prefix_count |
Number of prefixes in the BGP unreachability table. |
nvrouting_lldp_exception_count |
Number of unreachable prefixes the switch holds to export to LLDP, excluding the default route exception. |
nvrouting_lldp_default_exception_active_count |
Whether the default route exception is active. |
nvrouting_lldp_exception_add_total |
Number of unreachable prefixes sent to LLDP since the routing service started, including resynchronization replays. |
nvrouting_lldp_exception_remove_total |
Number of unreachable prefix withdrawals sent to LLDP since the routing service started. |
nvrouting_lldp_default_exception_add_total |
Number of default route exceptions sent to LLDP since the routing service started, counted separately for each VRF and address family. |
nvrouting_lldp_default_exception_remove_total |
Number of default route exception withdrawals sent to LLDP since the routing service started. |
nvrouting_lldp_export_channel_connected |
Whether the LLDP export channel is up. |
nvrouting_lldp_export_channel_errors_total |
Number of unreachable prefix updates that failed to reach LLDP since the routing service started. |
| Name | Description |
|---|---|
node_radius_auth_request_total |
Access-Request packets sent to the RADIUS server to authenticate an interactive user login, including retransmissions. |
node_radius_auth_accept_total |
Access-Accept messages received from the RADIUS server. |
node_radius_auth_reject_total |
Access-Reject messages received from the RADIUS server. |
node_radius_auth_timeout_total |
Access-Request messages that timed out and required retransmission. |
node_radius_auth_retransmit_total |
Retransmitted Access-Request messages. |
node_radius_auth_connection_error_total |
Login authentication attempts for which the switch could not reach the RADIUS server. |
node_radius_auth_bad_response_total |
Malformed or otherwise invalid RADIUS responses received during an interactive login. |
Each metric carries a single server label holding the RADIUS server address. For information about the counters behind these metrics, refer to Show and Clear RADIUS Counters.
| Name | Description |
|---|---|
nvswitch_interface_step_time_estimate |
Estimated step time, in seconds, of the AI training workload running on an interface. |
This metric is a gauge carrying a single interface label holding the interface name. The switch exports a data point only for an interface for which the algorithm produces an estimate, and exports no metric at all when it produces no estimate for any interface. For information about the feature behind this metric, refer to Step Time Estimation.
| Name | Description |
|---|---|
nvswitch_histogram_interface_microburst |
Per-window microburst histogram distribution. Bucket counts are exported after each poll cycle; temporality is delta. The values are the packet-delta or byte-delta per sampling window, depending on the value of quantity. |
nvswitch_histogram_interface_microburst_score |
Burstiness score σ² × μ for the current window. |
nvswitch_histogram_interface_microburst_mean_bin_index |
Mean bin index μ for the current window. |
nvswitch_histogram_interface_microburst_distribution_variance |
Bin-index variance σ² for the current window. |
nvswitch_histogram_interface_microburst_peak_value |
Peak raw watermark for the current window (packets or bytes, depending on quantity). Omitted when no valid watermark is available for the window. |
nvswitch_histogram_interface_microburst_threshold_state |
Threshold state for the configured score threshold. Omitted when no threshold is configured. |
nvswitch_histogram_interface_microburst_last_triggered |
(Unix epoch) timestamp of the last transition into triggered state. Omitted when the threshold has never triggered. |
Each microburst metric carries an interface label, a direction label (rx or tx), and a quantity label (packets or bytes). The telemetry model names this selector quantity, where the NVUE command that configures it is unit; the two names refer to the same setting. nvswitch_histogram_interface_microburst is a histogram and the rest are gauges, with threshold_state reporting 0 for clear and 1 for triggered. For information about the feature behind these metrics, refer to Microburst Histogram.
For information about OTEL, refer to OTEL Telemetry Export.
Updated OTEL Metrics
| Old Metric | New Metric |
|---|