Skip to content

[CORE-11848] Update QoS controls docs #2857

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
coutinhop wants to merge 1 commit into
base: main
Choose a base branch
from
+16 −12
Open

[CORE-11848] Update QoS controls docs #2857

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 16 additions & 4 deletions calico-cloud/networking/configuring/qos-controls.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,6 @@ Additionally, it allows configuring Differentiated Services (DiffServ) on egress
With QoS controls, $[prodname] enforces network resource limits (bandwidth, packet rate, connections) for Kubernetes pods and OpenStack VMs, ensuring fair resource allocation and preventing performance degradation for other workloads.
$[prodname] can also apply DiffServ on egress traffic to allow upstream devices to prioritise forwarding accordingly.

## Limitations

* Configuring limits for established connections is not supported on installations that use the eBPF data plane.

## Concepts

### Quality of Service Controls
Expand Down Expand Up @@ -130,3 +126,19 @@ spec:
|---------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `qos.projectcalico.org/dscp` | Specifies the DSCP value of egress traffic toward an endpoint outside cluster or another host in cluster.<br/>Min value: `0`<br/>Max value: `63`<br/>String values: DF, EF, AF11, AF12, AF13, AF21, AF22, AF23, AF31, AF32, AF33, AF41, AF42, AF43, CS0, CS1, CS2, CS3, CS4, CS5, CS6 |

## Troubleshooting

### Bandwidth is not enforced on eBPF

If you use the eBPF data plane and bandwidth limits aren't being enforced, check the calico-node logs to see if `tcx` is supported by the operating system.
`tcx` is present in the Linux kernel version 6.6 and later, and it is required for bandwidth limits to work with the eBPF data plane.

The following example shows logs that indicate an unsupported kernel version:

```
$ kubectl logs -n calico-system ds/calico-node | grep tcx
Found 4 pods, using pod/calico-node-j9z5d
Defaulted container "calico-node" out of: calico-node, flexvol-driver (init), ebpf-bootstrap (init), install-cni (init)
bird: libbpf: prog 'cali_tcx_test': failed to attach to tcx: Invalid argument
2025-10-15 16:31:48.522 [INFO][81] felix/bpf_ep_mgr.go 595: tcx is not supported. Falling back to tc
```
4 changes: 0 additions & 4 deletions calico-enterprise/networking/configuring/qos-controls.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,10 +18,6 @@ $[prodname] can also apply DiffServ on egress traffic to allow upstream devices

* If you use the eBPF data plane, your Linux nodes must be running kernel version 6.6 or higher in order to configure bandwidth QoS controls.

## Limitations

* Configuring limits for established connections is not supported on installations that use the eBPF data plane.

## Concepts

### Quality of Service Controls
Expand Down
4 changes: 0 additions & 4 deletions calico/networking/configuring/qos-controls.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,10 +26,6 @@ $[prodname] can also apply DiffServ on egress traffic to allow upstream devices

* If you use the eBPF data plane, your Linux nodes must be running kernel version 6.6 or higher in order to configure bandwidth QoS controls.

## Limitations

* Configuring limits for established connections is not supported on installations that use the eBPF data plane.

## Concepts

### Quality of Service Controls
Expand Down
Loading