IBM Cloud Docs
About bandwidth allocation for instance profiles

About bandwidth allocation for instance profiles

Instance profiles inform the available instance bandwidth of an instance.

Bandwidth allocation for resources that are attached to an instance

When you provision an instance, the total instance bandwidth is allocated between attached volumes and networking. The maximum bandwidth capacity is determined by the x86-64 instance profile that you select during instance provisioning. For example, a bx2-2x8 balanced server profile allows a total instance bandwidth of 4,000 Mbps (4 Gbps). The initial volume and network bandwidth allocation depends on the bandwidth that you set by using the API or by the instance profile you selected. If you do not specify the initial volume and network bandwidth allocation, then 25% of total instance bandwidth is allocated to volume bandwidth and 75% is allocated to network bandwidth.

You can see bandwidth allocations with the /instance/profiles endpoint in the API. You can also see the bandwidth allocations in the profile information during instance creation in the UI.

For example, for the bx2-2x8 profile you might have:

  • Volumes: 1,000 Mbps
  • Network: 3,000 Mbps

The maximum bandwidth of a volume is the highest potential bandwidth that can be allocated to the volume when attached to an instance. If the total maximum bandwidth of attached volumes exceeds the amount available on the instance, the bandwidth for each attached volume is set proportionally based on each volume's maximum bandwidth.

To ensure reasonable boot times, a minimum of 393 Mbps of volume bandwidth is allocated to the boot volume. In the example that has the instance's total volume bandwidth of 1,000 Mbps, the remaining 607 Mbps is allocated to any secondary volumes that you attach, up to the maximum bandwidth of the volume. For example, if you have one data volume with 500 Mbps, you can expect to get that level of performance.

Adjusting bandwidth allocation

The allocation of the instance's total bandwidth can be adjusted, balancing between network bandwidth and volume bandwidth. Both volume and network bandwidth must be at least 500 Mbps each. Before you change the bandwidth ratio, make sure that you evaluate your instance's network bandwidth requirements. Make sure that the new bandwidth allocation does not have negative effects on your instance’s network performance.

For example, to allow more volume bandwidth, you might apportion the previous example in equal allocations:

  • Volumes: 2,000 Mb/s
  • Network: 2,000 Mb/s

The volume bandwidth available to the instance is apportioned on a per-volume basis. The bandwidth is assigned per volume, not shared between volumes. For example, if four identical volumes are attached to an instance but are using only one volume, then that volume can get only the bandwidth assigned to it. The volume in use can't access extra bandwidth that is assigned to the unused volumes.

Optimizing network bandwidth allocation for profiles

Profiles can have a total maximum bandwidth of up to 80 Gbps. That bandwidth is split between Network and Storage traffic. The network bandwidth allocation is distributed evenly across network interfaces, and each network interface has a cap of 25 Gbps. You might need to attach multiple network interfaces to your virtual server instance to optimize network performance.

For example, if you choose the bx2-32x128 profile, the total bandwidth that is assigned for the instance is 64 Gbps. The default network cap is 48 Gbps for network and 16 Gbps for storage, but this amount can be adjusted. If you use the default bandwidth allocation and a single network interface on the instance, that vNIC has a port speed of 25 Gbps. If two network interfaces are on the system, each network interface has a port speed of 24 Gbps, for a total aggregate network bandwidth for 48 Gbps. The remaining bandwidth (16 Gbps) is allocated to your storage volumes.

The following table illustrates this allocation for three different profile examples. If you are using the same default values that were used for these calculations, you can match other instance profiles to the table below by matching the bandwidth cap value to the overall bandwidth in the table. For more information about instance profiles, including network performance information, see x86-64 instance profiles.

Table 11 Example profile bandwidth
Profile names bx2-16x64 bx2-32x128 bx2-48-192
Overall bandwidth 32 Gbps 64 Gbps 80 Gbps
Default storage bandwidth allocation (25%) 8 Gbps 16 Gbps 20 Gbps
Default total network bandwidth allocation (75%) 24 Gbps 48 Gbps 60 Gbps
vNIC speed with 1 vNIC attached 24 Gbps 25 Gbps 25 Gbps
vNIC speed with 2 vNICs attached 2x12 Gbps 2x24 Gbps 2x25 Gbps
vNIC speed with 3 vNICs attached 3x8 Gbps 3x16 Gbps 3x20 Gbps

The network bandwidth cap applies separately to egress (transmitted) and ingress (received) traffic. That is, even if an instance that is capped at 4 Gbps reaches its transmit cap of 4 Gbps it can still receive up to its ingress cap of 4 Gbps.

Next steps

For more information, see the following topics: