Skip to content

Commit c1fb2f1

Browse files
authored
Merge pull request #246635 from spelluru/ehubfreshness0728
Auto inflate - review, test, and update
2 parents 79758d7 + b3a3f88 commit c1fb2f1

File tree

1 file changed

+34
-43
lines changed

1 file changed

+34
-43
lines changed

articles/event-hubs/event-hubs-auto-inflate.md

Lines changed: 34 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -3,42 +3,40 @@ title: Automatically scale up throughput units in Azure Event Hubs
33
description: Enable Auto-inflate on a namespace to automatically scale up throughput units (standard tier).
44
ms.topic: article
55
ms.custom: devx-track-arm-template
6-
ms.date: 06/13/2022
6+
ms.date: 07/28/2023
77
---
88

99
# Automatically scale up Azure Event Hubs throughput units (standard tier)
10-
Azure Event Hubs is a highly scalable data streaming platform. As such, Event Hubs usage often increases after starting to use the service. Such usage requires increasing the predetermined [throughput units (TUs)](event-hubs-scalability.md#throughput-units) to scale Event Hubs and handle larger transfer rates. The **Auto-inflate** feature of Event Hubs automatically scales up by increasing the number of TUs, to meet usage needs. Increasing TUs prevents throttling scenarios, in which:
1110

12-
* Data ingress rates exceed set TUs
13-
* Data egress request rates exceed set TUs
11+
When you create a standard tier Event Hubs namespace, you specify the number of [throughput units (TUs)](event-hubs-scalability.md#throughput-units). These TUs may not be enough when the usage goes up later. When that happens, you could manually increase the number of TUs assigned to the namespace. However, it's better to have Event Hubs automatically increase (inflate) TUs based on the workload.
1412

15-
The Event Hubs service increases the throughput when load increases beyond the minimum threshold, without any requests failing with ServerBusy errors.
13+
The **Auto-inflate** feature of Event Hubs automatically scales up by increasing the number of TUs, to meet usage needs. Increasing TUs prevents throttling scenarios where data ingress or data egress rates exceed the rates allowed by the TUs assigned to the namespace. The Event Hubs service increases the throughput when load increases beyond the minimum threshold, without any requests failing with ServerBusy errors.
1614

1715
> [!NOTE]
1816
> The auto-inflate feature is currently supported only in the standard tier.
1917
2018
## How Auto-inflate works in standard tier
19+
2120
Event Hubs traffic is controlled by TUs (standard tier). For the limits such as ingress and egress rates per TU, see [Event Hubs quotas and limits](event-hubs-quotas.md). Auto-inflate enables you to start small with the minimum required TUs you choose. The feature then scales automatically to the maximum limit of TUs you need, depending on the increase in your traffic. Auto-inflate provides the following benefits:
2221

2322
- An efficient scaling mechanism to start small and scale up as you grow.
2423
- Automatically scale to the specified upper limit without throttling issues.
2524
- More control over scaling, because you control when and how much to scale.
2625

2726
> [!NOTE]
28-
> Auto-inflate does not *automatically* scale down the number of TUs when ingress or egress rates drop below the limits.
27+
> Auto-inflate doesn't **automatically scale down** the number of TUs when ingress or egress rates drop below the limits.
2928
3029
## Enable Auto-inflate on a namespace
31-
You can enable or disable Auto-inflate on a standard tier Event Hubs namespace by using either [Azure portal](https://portal.azure.com) or an [Azure Resource Manager template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.eventhub/eventhubs-create-namespace-and-enable-inflate).
3230

33-
> [!NOTE]
34-
> Basic tier Event Hubs namespaces do not support Auto-inflate.
31+
You can enable or disable Auto-inflate on a standard tier Event Hubs namespace by using either [Azure portal](https://portal.azure.com) or an [Azure Resource Manager template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.eventhub/eventhubs-create-namespace-and-enable-inflate).
3532

3633
## Use Azure portal
34+
3735
In the Azure portal, you can enable the feature when creating a standard Event Hubs namespace or after the namespace is created. You can also set TUs for the namespace and specify maximum limit of TUs
3836

3937
You can enable the Auto-inflate feature **when creating an Event Hubs namespace**. The following image shows you how to enable the auto-inflate feature for a standard tier namespace and configure TUs to start with and the maximum number of TUs.
4038

41-
:::image type="content" source="./media/event-hubs-auto-inflate/event-hubs-auto-inflate.png" alt-text="Screenshot of enabling auto inflate at the time event hub creation for a standard tier namespace":::
39+
:::image type="content" source="./media/event-hubs-auto-inflate/event-hubs-auto-inflate.png" alt-text="Screenshot of enabling auto inflate at the time event hub creation for a standard tier namespace.":::
4240

4341
With this option enabled, you can start small with your TUs and scale up as your usage needs increase. The upper limit for inflation doesn't immediately affect pricing, which depends on the number of TUs used per hour.
4442

@@ -61,51 +59,44 @@ You can enable the Auto-inflate feature during an Azure Resource Manager templat
6159
`isAutoInflateEnabled` property to **true** and set `maximumThroughputUnits` to 10. For example:
6260

6361
```json
64-
"resources": [
62+
{
63+
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
64+
"contentVersion": "1.0.0.0",
65+
"parameters": {
66+
"namespaceName": {
67+
"defaultValue": "fabrikamehubns",
68+
"type": "String"
69+
}
70+
},
71+
"variables": {},
72+
"resources": [
6573
{
66-
"apiVersion": "2017-04-01",
74+
"type": "Microsoft.EventHub/namespaces",
75+
"apiVersion": "2022-10-01-preview",
6776
"name": "[parameters('namespaceName')]",
68-
"type": "Microsoft.EventHub/Namespaces",
69-
"location": "[variables('location')]",
77+
"location": "East US",
7078
"sku": {
7179
"name": "Standard",
72-
"tier": "Standard"
80+
"tier": "Standard",
81+
"capacity": 1
7382
},
7483
"properties": {
84+
"minimumTlsVersion": "1.2",
85+
"publicNetworkAccess": "Enabled",
86+
"disableLocalAuth": false,
87+
"zoneRedundant": true,
7588
"isAutoInflateEnabled": true,
76-
"maximumThroughputUnits": 10
77-
},
78-
"resources": [
79-
{
80-
"apiVersion": "2017-04-01",
81-
"name": "[parameters('eventHubName')]",
82-
"type": "EventHubs",
83-
"dependsOn": [
84-
"[concat('Microsoft.EventHub/namespaces/', parameters('namespaceName'))]"
85-
],
86-
"properties": {},
87-
"resources": [
88-
{
89-
"apiVersion": "2017-04-01",
90-
"name": "[parameters('consumerGroupName')]",
91-
"type": "ConsumerGroups",
92-
"dependsOn": [
93-
"[parameters('eventHubName')]"
94-
],
95-
"properties": {}
96-
}
97-
]
98-
}
99-
]
89+
"maximumThroughputUnits": 10,
90+
"kafkaEnabled": true
91+
}
10092
}
101-
]
93+
]
94+
}
10295
```
10396

10497
For the complete template, see the [Create Event Hubs namespace and enable inflate](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.eventhub/eventhubs-create-namespace-and-enable-inflate) template on GitHub.
10598

10699

107100
## Next steps
108101

109-
You can learn more about Event Hubs by visiting the following links:
110-
111-
* [Event Hubs overview](./event-hubs-about.md)
102+
To learn more about Event Hubs, see [Event Hubs overview](./event-hubs-about.md)

0 commit comments

Comments
 (0)