VMware ESXi and vSphere Cluster Management

Configure Traffic Shaping Policies on VMware ESXi Standard Switches

Learn how to configure outbound VM bandwidth limits on an ESXi standard vSwitch or port group using Average Bandwidth, Peak Bandwidth, and Burst Size.

ESXi standard-switch traffic shaping controls how quickly virtual machine network traffic is transmitted toward the physical network. This lesson explains the policy scope, bandwidth settings, burst behavior, configuration workflow, planning process, and troubleshooting steps.

What ESXi Traffic Shaping Does

A standard virtual switch, or standard vSwitch, is an ESXi host-local switch that connects virtual machines, VMkernel adapters, and physical network uplinks. A VM's virtual NIC (vNIC) connects to a port group, while a physical NIC (pNIC) provides an uplink toward the external network.

Without traffic shaping, a vNIC can transmit at the rate supported by available virtual-switch and uplink capacity. One busy workload can therefore consume capacity needed by other workloads. Traffic shaping adds a bandwidth-control policy that defines a sustained rate, a temporary peak rate, and a burst allowance.

Traffic shaping is disabled until an administrator explicitly enables and configures it. Common objectives include:

  • Preventing one workload from monopolizing uplink capacity.
  • Reducing noisy-neighbor behavior between VM workloads.
  • Allocating planned bandwidth to development, backup, replication, or application traffic.

Scope and Direction on a Standard vSwitch

The standard-vSwitch traffic shaping policy described here applies to outbound traffic: traffic transmitted from the ESXi virtual-switch context toward the physical network. It is not an inbound bandwidth limiter for traffic arriving at a VM.

You can configure the policy at either of two locations:

  • Standard vSwitch level: establishes a policy for the switch's attached port groups.
  • Port group level: establishes a more specific policy for workloads connected to that port group.

Policy inheritance means that a port group normally uses the setting inherited from its parent standard vSwitch. If the port group has its own traffic-shaping configuration, that configuration takes precedence over the inherited switch setting.

Configuration LocationAffected ObjectsPrecedenceAppropriate Use
Standard vSwitchAttached port groups using the inherited policyParent defaultUse when one baseline is suitable for all attached workloads.
Port groupVMs and other adapters connected to that port groupOverrides the vSwitch settingUse for workload classes with distinct bandwidth requirements.

Traffic Shaping Parameters

The three settings use different units. Average Bandwidth and Peak Bandwidth are rates in kilobits per second (Kbps). Burst Size is a data allowance in kilobytes (KB). Bits and bytes are not interchangeable: eight bits equal one byte, so unit conversion is required when comparing these settings with application or physical-link measurements.

SettingUnitWhat It ControlsConfiguration Rule
Average BandwidthKbpsThe sustained permitted transmission rate for a port.Set it to the workload's normal long-term requirement.
Peak BandwidthKbpsThe maximum permitted transmission rate while a burst is available.It must be greater than or equal to Average Bandwidth.
Burst SizeKBThe amount of data available for temporary burst transmission.A larger value permits a larger short-lived burst, subject to the peak rate.

How the Values Work Together

  • Average Bandwidth establishes the long-term allowance.
  • Peak Bandwidth caps short-term transmission when the workload accelerates.
  • Burst Size determines how much data can use that temporary acceleration.

A workload may briefly need more throughput than its normal average, such as when an application returns a group of responses or a backup job sends a short block of data. Burst capacity allows that temporary increase, but it is not a permanent higher-bandwidth entitlement.

A small burst size limits how long the workload can accelerate. A larger burst size permits a larger short-term transfer, but the transfer remains subject to Peak Bandwidth, physical uplink capacity, and competition from other traffic. A burst setting cannot guarantee that the physical network will deliver the configured peak.

Choose the Policy Scope

Use a vSwitch-level policy when all attached port groups should share the same baseline objective. This is useful when the switch serves a consistent class of traffic.

Use a port group-level policy when workloads have different service requirements. For example, development traffic may need a modest limit, while an application port group may need a higher sustained rate and controlled short bursts.

Map port groups to recognizable workload classes such as development, backup, replication, or application traffic. Document every port group override because it supersedes the standard vSwitch setting and can make apparently similar workloads behave differently.

Configure Traffic Shaping in the vSphere Client

  1. Open the target ESXi host in the vSphere client.
  2. Go to the host's networking management area. The exact labels can vary by vSphere version.
  3. Select the target standard vSwitch for a switch-wide policy, or select the relevant port group for a workload-specific override.
  4. Open Edit Settings for the selected networking object.
  5. Locate the Traffic Shaping section.
  6. Enable traffic shaping.
  7. Enter Average Bandwidth in Kbps.
  8. Enter Peak Bandwidth in Kbps. Ensure that it is not lower than Average Bandwidth.
  9. Enter Burst Size in KB.
  10. Save the configuration.
  11. Recheck the selected object and the effective port group setting to verify the intended scope and inheritance behavior.

For background on building the networking object, see Create Standard Switches. If VLAN-backed port groups are involved, review Configure VLANs.

Plan Values Before Applying the Policy

  1. Confirm the speed and actual available capacity of the physical NIC and upstream network.
  2. Identify whether the measurement is in bits or bytes. The ESXi bandwidth fields use Kbps, while Burst Size uses KB.
  3. Set Average Bandwidth to the workload's normal sustained operating requirement rather than its occasional maximum.
  4. Set Peak Bandwidth at or above Average Bandwidth and within a reasonable share of available uplink capacity.
  5. Choose a Burst Size large enough for useful short spikes but not so large that many workloads can contend aggressively at once.
  6. Test the policy with representative outbound traffic and monitor network performance after saving it.
Workload TypeAverage Rate GoalPeak Rate GoalBurst Size GoalReasoning
Development or test workloadModest normal-use rateControlled increase above averageLimitedRestricts noncritical workloads while allowing brief test activity.
General application workloadAligned with normal application trafficModerately above the baselineEnough for short response spikesSupports normal bursts without unrestricted sustained throughput.
Short-burst workloadLower long-term rateHigher, but within uplink capacitySelected for the expected transfer sizeAllows brief acceleration while preserving the long-term allocation.

Example: Default Policy with an Exception

Suppose a standard vSwitch receives a general policy suitable for most port groups. A replication port group then receives its own policy because replication has a different bandwidth requirement. VMs on that port group use the replication policy, not the inherited vSwitch policy. Record this override in the network design and operational documentation.

Example: Invalid Rate Relationship

If Average Bandwidth is set to 10,000 Kbps and Peak Bandwidth is set to 8,000 Kbps, the configuration is invalid. A peak ceiling cannot be below the sustained allowance. Increase Peak Bandwidth to at least 10,000 Kbps, or reduce Average Bandwidth.

Validate Direction and Effective Behavior

Generate outbound traffic from a VM connected to the target port group and compare its measured throughput with the configured values. Observe both the sustained rate and short-lived spikes. Also check host and network performance counters during the test.

Then distinguish traffic arriving at the VM from traffic transmitted by it. High inbound traffic does not show that outbound shaping failed; the standard-vSwitch policy covered here controls the outbound direction. Use an appropriate upstream physical-network policy or another supported design when inbound control is required.

Troubleshooting

The VM Is Not Rate-Limited

  • Verify that traffic shaping is enabled, not merely populated with values.
  • Confirm that the VM's vNIC is connected to the intended port group.
  • Check whether the port group has an explicit setting that overrides the vSwitch policy.
  • Verify that the measured traffic is outbound from the shaped ESXi switching context.
  • Confirm that you are inspecting the correct ESXi host and standard vSwitch.

The Configuration Cannot Be Saved

  • Check that Peak Bandwidth is not lower than Average Bandwidth.
  • Confirm that all entries are valid positive numeric values.
  • Recheck units: bandwidth is Kbps and burst size is KB.
  • Verify that your account has permission to edit host networking settings. See Assign Permissions if access is the issue.

The Workload Does Not Reach the Configured Peak

  • Determine whether the burst allowance has been exhausted or the burst size is too small for the test pattern.
  • Check pNIC speed, physical uplink capacity, contention, and upstream network limits.
  • Confirm that the workload can generate enough outbound traffic to exercise the policy.
  • Check guest operating-system limits and other external network controls.

Incoming Traffic Remains High

Confirm that the expected result is inbound limiting. The standard-vSwitch shaping behavior covered here is outbound only. Select a control point that supports inbound policy, such as an upstream physical network policy or another supported network design.

Settings Differ Between Workloads

  • Compare the standard vSwitch and each relevant port group configuration.
  • Identify port groups with explicit overrides.
  • Document which workloads share each port group.
  • Confirm that the selected policy scope matches the intended design.

Operational Cautions

  • Physical network capacity and competing traffic still limit the result, regardless of configured burst or peak values.
  • Direction, policy placement, and vSwitch type all matter when evaluating observed throughput.
  • A standard vSwitch is host-local, so review the policy on every relevant host when the same design spans multiple hosts.
  • Distributed switches can have different management workflows and capabilities. Check the documentation for the exact vSphere and ESXi version when working with distributed-switch traffic management or automation interfaces. For architectural background, see Distributed Switches Explained.

Exam-Relevant Notes

  • Standard-vSwitch traffic shaping controls outbound traffic.
  • Traffic shaping must be enabled before its values take effect.
  • Average Bandwidth and Peak Bandwidth use Kbps; Burst Size uses KB.
  • Peak Bandwidth must be greater than or equal to Average Bandwidth.
  • A port group-specific policy takes precedence over the inherited standard vSwitch policy.
  • Traffic shaping controls transmission; it does not add physical bandwidth or replace upstream quality-of-service design.

For broader ESXi administration practice, continue with the VMware ESXi Online Course.