Skip to content

Commit

Permalink
Merge branch '512-last-minute' into ania-stage
Browse files Browse the repository at this point in the history
  • Loading branch information
cumulusAnia committed Jan 31, 2025
2 parents 60778a9 + f85dcbc commit 3be826a
Show file tree
Hide file tree
Showing 3 changed files with 31 additions and 7 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -1382,7 +1382,7 @@ cumulus@leaf01:~$

## BGP Prefix Independent Convergence

BGP prefix independent convergence (PIC) reduces convergence times and improves unicast traffic convergence for remote link and node failures (when the BGP next hop fails) regardless of route scale. A remote link is a link between a spine and a remote leaf, or a spine and the super spine layer.
BGP prefix independent convergence (PIC) reduces convergence times and improves unicast traffic convergence for remote link and node failures (when the BGP next hop fails) on an individual prefix basis, regardless of route scale. A remote link is a link between a spine and a remote leaf, or a spine and the super spine layer.

When you configure BGP PIC, Cumulus Linux assigns one next hop group for each source and the remote leaf advertises a route with a prefix derived from the router ID. The remote leaf tags prefix routes with a route-origin extended community (SOO) so that the local leaf recognizes the routes. When the network topology changes, the local leaf obtains the router ID route with the updated ECMP, allowing a O (1) next hop group replace operation for all prefixes from the remote leaf without waiting for individual BGP updates.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -280,19 +280,43 @@ By default, OTLP export is in **secure** mode that requires a certificate. For c

### Customize Export

By default, the switch exports all statistics enabled {{<link url="#configure-open-telemetry" text="globally">}} (with the `nv set system telemetry <statistics>` command) to all configured OTLP destinations. If you want to export different metrics to different OTLP destinations, you can customize the export by specifying a statistics group (`interface-stats`, `platform-stats`, `histogram-stats`, or `routing-stats`) for a destination.
By default, the switch exports all statistics enabled {{<link url="#configure-open-telemetry" text="globally">}} (with the `nv set system telemetry <statistics>` command) to all configured OTLP destinations. If you want to export different metrics to different OTLP destinations, you can customize the export by specifying a statistics group to control which statistics you export and the sample interval for a destination.

The following example exports all platform statistics to the destination IP address 10.1.1.100:
{{%notice note%}}
Statistics groups inherit global OTLP export configurations by default. More specific configuration under a statistics group, such as enabling or disabling a statistic type or changing the sample interval overrides any global OTLP configuration.
{{%/notice%}}

The following example:
- Configures STAT-GROUP1 to export all platform statistics (`platform-stats`) but not interface statistics (`interface-stats`).
- Applies the STAT-GROUP1 configuration to the OTLP destination 10.1.1.100.

```
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP1 platform-stats export state enabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP1 interface-stats export state disabled
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.100 stats-group STAT-GROUP1
cumulus@switch:~$ nv config apply
```

The following example:
- Configures STAT-GROUP2 to inherit all statistic configuration from the global telemetry configuration, but changes the sample interval of `router` statistics to 100:
- Applies the STAT-GROUP2 configuration to the OTLP destination 10.1.1.200.

```
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.100 stats-group platform-stats
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP2 router sample-interval 100
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.200 stats-group STAT-GROUP2
cumulus@switch:~$ nv config apply
```

The following example exports all routing statistics to the destination IP address 10.1.1.200:
The following example:
- Configures STAT-GROUP3 to disable histogram (`histogram`) and buffer (`buffer-stats`) statistics, and enables all platform statistics(`platform-stats`) except for disk state:
- Applies the STAT-GROUP3 configuration to the OTLP destination 10.1.1.30.

```
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.200 stats-group routing
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 buffer-stats export state disabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 histogram export state disabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 platform-stats export state enabled
cumulus@switch:~$ nv set system telemetry stats-group STAT-GROUP3 platform-stats class disk state disabled
cumulus@switch:~$ nv set system telemetry export otlp grpc destination 10.1.1.30 stats-group STAT-GROUP3
cumulus@switch:~$ nv config apply
```

Expand Down
2 changes: 1 addition & 1 deletion content/cumulus-linux-512/Whats-New/foss.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Cumulus Linux 5.12 contains the following core switch package versions:

| Package | Version | Description |
| --- | ----| ----------- |
| SDK (`sx-sdk-eth`) | 4.7.3036 | Switch SDK package. Legal Notices and 3rd Party Licenses: {{<exlink url="https://content.mellanox.com/Legal/3rdPartyUnifyNotice_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK 3rd Party Unify Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/3rdPartyNotice_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK 3rd Party Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/license_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK License">}} |
| SDK (`sx-sdk-eth`) | 4.7.3056 | Switch SDK package. Legal Notices and 3rd Party Licenses: {{<exlink url="https://content.mellanox.com/Legal/3rdPartyUnifyNotice_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK 3rd Party Unify Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/3rdPartyNotice_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK 3rd Party Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/license_SDK_sx_sdk_4_7_3000_4.7.2948-010.pdf" text="SDK License">}} |
| MFT (`kernel-mft-dkms`) | 4.30.2-23 | Switch MFT package. Legal Notices and 3rd Party Licenses: {{<exlink url="https://content.mellanox.com/Legal/3rdPartyNotice_MFT_LINUX_4_30_2_mft-4.30.2.pdf" text="MFT 3rd Party Notice">}}; {{<exlink url="https://content.mellanox.com/Legal/license_MFT_LINUX_4_30_2_mft-4.30.2.pdf" text="MFT License">}} |
| Hardware management (`hw-management`) | 7.0040.3005 | Hardware management package.|
| NVUE (`python3-nvue`) | 1.8.0.70 | NVUE core package. |
Expand Down

0 comments on commit 3be826a

Please sign in to comment.