Skip to content

Clarify network throttling (rate) and bandwidth limits#639

Open
daviftorres wants to merge 7 commits into
apache:mainfrom
daviftorres:main
Open

Clarify network throttling (rate) and bandwidth limits#639
daviftorres wants to merge 7 commits into
apache:mainfrom
daviftorres:main

Conversation

@daviftorres
Copy link
Copy Markdown
Contributor

@daviftorres daviftorres commented Apr 2, 2026

Updated the explanation of network throttling in CloudStack, clarifying how network rate settings are applied and providing details on bandwidth limits for different offerings.

The existing documentation is wordy (no offense) and the discussion eventually re-appears.


📚 Documentation preview 📚: https://cloudstack-documentation--639.org.readthedocs.build/en/639/

Updated the explanation of network throttling in CloudStack, clarifying how network rate settings are applied and providing details on bandwidth limits for different offerings.
@sureshanaparti
Copy link
Copy Markdown
Contributor

@blueorangutan docbuild

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the “Network Throttling” section of the Admin Guide to clarify how CloudStack applies network rate settings and how defaults/fallbacks work across offering types and global configuration.

Changes:

  • Rewrote the introductory explanation of network throttling/network rate and where it can be defined.
  • Added clarification on NULL/default behavior and how system vs guest network defaults are treated.
  • Updated the illustrative example values for shared vs isolated networks.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread source/adminguide/service_offerings.rst Outdated
Comment thread source/adminguide/service_offerings.rst Outdated
Comment thread source/adminguide/service_offerings.rst Outdated
Comment thread source/adminguide/service_offerings.rst
Comment thread source/adminguide/service_offerings.rst Outdated
Comment thread source/adminguide/service_offerings.rst Outdated
@sureshanaparti
Copy link
Copy Markdown
Contributor

@blueorangutan docbuild

@blueorangutan
Copy link
Copy Markdown

@sureshanaparti a Jenkins job has been kicked to build the document. I'll keep you posted as I make progress.

@blueorangutan
Copy link
Copy Markdown

QA-Doc build preview: https://qa.cloudstack.cloud/builds/docs-build/pr/639. (QA-JID 513)

daviftorres and others added 5 commits April 3, 2026 09:59
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@daviftorres
Copy link
Copy Markdown
Contributor Author

Dear @sureshanaparti . Where do we stand on this?

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 3 comments.

Comment on lines +689 to +695
If the network rate is **NULL** at:

* The **Compute Offering**, it uses the ``vm.network.throttling.rate`` global setting.
* The **Network Offering**, it uses the ``network.throttling.rate`` global setting.

For system networks (Public, Storage, and Management), the rate
is set to 0. This implies unlimited bandwidth by default.
value is set to NULL for network offering, the value provided in the
network.throttling.rate global parameter is considered.
* ``cloud.network_offerings`` for Network Offerings.
* ``cloud.service_offering`` for System VMs.
in Mbps (Megabits Per Second) allowed in a guest network. It defines the
upper limits for network bandwidth.
In CloudStack, this is done using network rate settings. These settings
define the maximum data transfer speed (in Mbps) that guest instance's
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants