Skip to content

Commit 187c400

Browse files
authored
Merge pull request #277022 from paulth1/event-hubs-articles-batch2
[AQ] edit pass: event-hubs-articles-batch2
2 parents 59d40ee + 4148052 commit 187c400

File tree

5 files changed

+101
-94
lines changed

5 files changed

+101
-94
lines changed

articles/event-hubs/compare-tiers.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,25 @@
11
---
22
title: Compare Azure Event Hubs tiers
3-
description: This article compares supported tiers of Azure Event Hubs.
3+
description: This article compares supported tiers of Azure Event Hubs.
44
ms.topic: article
55
ms.date: 02/15/2024
66
---
77

8-
# Compare Azure Event Hubs tiers
8+
# Compare Azure Event Hubs tiers
9+
910
This article compares tiers of Azure Event Hubs.
1011

1112
> [!NOTE]
12-
> This article compares only features and quotas of tiers. For pricing information, see [Azure Event Hubs pricing](https://azure.microsoft.com/pricing/details/event-hubs/)
13+
> This article compares only features and quotas of tiers. For pricing information, see [Azure Event Hubs pricing](https://azure.microsoft.com/pricing/details/event-hubs/).
1314
1415
## Features
16+
1517
[!INCLUDE [event-hubs-tier-features](./includes/event-hubs-tier-features.md)]
1618

1719
## Quotas
20+
1821
[!INCLUDE [event-hubs-tier-limits](./includes/event-hubs-tier-limits.md)]
1922

20-
## Next steps
21-
For pricing information for each tier, see [Azure Event Hubs pricing](https://azure.microsoft.com/pricing/details/event-hubs/)
23+
## Related content
24+
25+
For pricing information for each tier, see [Azure Event Hubs pricing](https://azure.microsoft.com/pricing/details/event-hubs/).
Lines changed: 25 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,52 @@
11
---
2-
title: Azure Quickstart - Send and receive large messages with Azure Event Hubs (Preview)
2+
title: 'Quickstart: Send and receive large messages with Azure Event Hubs (preview)'
33
description: In this quickstart, you learn how to send and receive large messages with Azure Event Hubs.
44
ms.topic: quickstart
55
ms.author: Saglodha
66
ms.date: 5/6/2024
77
---
88

9-
# QuickStart: Send and receive large messages with Azure Event Hubs (Preview)
9+
# Quickstart: Send and receive large messages with Azure Event Hubs (preview)
1010

11-
In this quickstart, you learn how to send and receive large messages (up to 20 MB) using Azure Event Hubs. If you're new to Azure Event Hubs, see [Event Hubs overview](event-hubs-about.md) before you go through this quickstart.
11+
In this quickstart, you learn how to send and receive large messages (up to 20 MB) by using Azure Event Hubs. If you're new to Event Hubs, see [Event Hubs overview](event-hubs-about.md) before you go through this quickstart.
1212

1313
### Prerequisites
1414

15-
To complete this QuickStart, you need the following prerequisites:
15+
To complete this quickstart, you need the following prerequisites:
1616

17-
- Microsoft Azure subscription. To use Azure services, including Azure Event Hubs, you need a subscription. If you don't have an existing Azure account, you can sign up for a [free trial](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) or use your MSDN subscriber benefits when you [create an account](https://azure.microsoft.com/).
18-
19-
- Create [Self-serve scalable dedicated cluster](event-hubs-dedicated-cluster-create-portal.md), event hubs namespace and an event hub. The first step is to use the Azure portal to create a Dedicated cluster and namespace inside a cluster. To create an event hub, see [QuickStart: Create an event hub using Azure portal. ](event-hubs-create.md). You can skip this step if you already have a self-serve scalable dedicated cluster.
17+
- An Azure subscription. To use Azure services, including Event Hubs, you need a subscription. If you don't have an existing Azure account, you can sign up for a [free trial](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) or use your MSDN subscriber benefits when you [create an account](https://azure.microsoft.com/).
18+
- A [self-serve scalable dedicated cluster](event-hubs-dedicated-cluster-create-portal.md), an event hubs namespace, and an event hub. The first step to meet this prerequisite is to use the Azure portal to create a dedicated cluster and namespace inside a cluster. To create an event hub, see [Quickstart: Create an event hub by using the Azure portal](event-hubs-create.md). You can skip this step if you already have a self-serve scalable dedicated cluster.
2019

2120
> [!NOTE]
22-
> Large Message Support, currently in Public Preview, is exclusively available with certain Event Hubs self-serve dedicated clusters. Streaming large messages with these clusters incurs no extra charges.
21+
> Large message support, currently in public preview, is exclusively available with certain Event Hubs self-serve dedicated clusters. Streaming large messages with these clusters incurs no extra charges.
22+
23+
## Configure an Event Hubs dedicated cluster
2324

24-
## Configuring Event Hubs Dedicated Cluster
25+
To stream large messages, you must configure your self-serve scalable dedicated cluster.
2526

26-
To stream large messages, you must configure your self-serve scalable dedicated cluster. You could follow below steps below:
27+
In the Azure portal, go to the **Settings** section for the dedicated cluster. Under **Settings**, select the **Quota** tab.
2728

28-
- On Azure portal, navigate to the ‘Settings’ section for Dedicated cluster and select the ‘Quota’ tab under Settings.
29-
30-
:::image type="content" source="./media/event-hubs-quickstart-stream-large-messages/large-message-configuration-for-dedicated-cluster.png" alt-text="Screenshot showing the Quota blade for Dedicated Cluster.":::
29+
:::image type="content" source="./media/event-hubs-quickstart-stream-large-messages/large-message-configuration-for-dedicated-cluster.png" alt-text="Screenshot that shows the Quota pane for a dedicated cluster.":::
3130

32-
- Validate that the value for read-only key **supportslargemessages** is set to true.
33-
- You could update the key: **eventhubmaxmessagesizeinbytes** to suitable value in bytes. Acceptable range for this value is between 1048576 and 20971520 bytes.
31+
- Validate that the value for the read-only key `supportslargemessages` is set to `True`.
32+
- You can update the key `eventhubmaxmessagesizeinbytes` to a suitable value in bytes. An acceptable range for this value is between 1,048,576 and 20,971,520 bytes.
3433

35-
Once the configuration is saved, you're all set to stream Large messages with event hubs.
34+
After the configuration is saved, you're ready to stream large messages with Event Hubs.
3635

3736
> [!IMPORTANT]
38-
> Large message streaming is only supported with Self-serve scalable dedicated clusters built out of latest infrastructure. This capability is reflected by the “Supportslargemessages” key.
39-
> If its value is false, the cluster will not support large message streaming. To enable this feature, you must recreate the cluster.
37+
> Large message streaming is only supported with self-serve scalable dedicated clusters built out of the latest infrastructure. This capability is reflected by the `Supportslargemessages` key.
38+
>
39+
> If a cluster value is false, it won't support large message streaming. To enable this feature, you must re-create the cluster.
4040
41-
## Streaming Large messages with Azure Event hubs
41+
## Stream large messages with Event Hubs
4242

43-
Azure Event Hubs allows streaming of large messages up to 20 MB, both in batches and as individual publications. Being able to stream large messages or events requires no client code changes apart from the change in message or event itself. You could continue sending/receiving messages using any existing event hubs SDK/ Kafka API to stream large messages to event hub. This allows you to stream large messages to the event hub in the same manner as you would for messages of size less than 1 MB.
44-
Know more [here](event-hubs-dotnet-standard-getstarted-send.md)
43+
Event Hubs allows streaming of large messages up to 20 MB, both in batches and as individual publications. The ability to stream large messages or events requires no client code changes apart from the change in the message or event itself. You can continue sending or receiving messages by using any existing Event Hubs SDK or Kafka API to stream large messages to Event Hubs. This way you can stream large messages to Event Hubs in the same manner as you would for messages of sizes less than 1 MB.
4544

45+
For more information, see [Send events to and receive events from Event Hubs by using .NET](event-hubs-dotnet-standard-getstarted-send.md).
4646

4747
> [!TIP]
48-
> Make sure to review any Event Hubs AMQP client or Kafka client configuration that could be limiting maximum message size that you stream into event hubs.You must update Client timeout to higher value to be able to stream large messages. By default, AMQP client prefetch count is 300. You should lower this value to avoid client side memory issues when dealing with large messages.
49-
50-
For complete .NET library reference, see our [SDK documentation](/dotnet/api/overview/azure/event-hubs).
48+
> Make sure to review any Event Hubs Advanced Message Queuing Protocol (AMQP) client or Kafka client configuration that might limit the maximum message size that you stream into Event Hubs. You must update client timeout to a higher value to stream large messages.
49+
>
50+
>By default, the AMQP client prefetch count is 300. Lower this value to avoid client-side memory issues when you deal with large messages.
5151
52+
For the complete .NET library reference, see the [SDK documentation](/dotnet/api/overview/azure/event-hubs).

articles/event-hubs/includes/event-hubs-tier-features.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,23 +10,23 @@ ms.custom: "include file","fasttrack-edit","iot","event-hubs"
1010

1111
---
1212

13-
The following table shows the list of features that are available (or not available) in a specific tier of Azure Event Hubs.
13+
The following table shows the list of features that are available (or not available) in a specific tier of Azure Event Hubs.
1414

15-
| Feature | Basic | Standard | Premium | Dedicated |
15+
| Feature | Basic | Standard | Premium | Dedicated |
1616
| ------- | ------| -------- | ------- | --------- |
1717
| Tenancy | Multitenant | Multitenant | Multitenant with resource isolation | Exclusive single tenant |
1818
| Private link | N/A | Yes | Yes | Yes |
19-
| Customer-managed key <br/>(Bring your own key) | N/A | N/A | Yes | Yes |
19+
| Customer-managed key <br/>(bring your own key) | N/A | N/A | Yes | Yes |
2020
| Capture | N/A | Priced separately | Included | Included |
21-
| Dynamic Partition scale out | N/A | N/A | Yes | Yes |
21+
| Dynamic partition scale-out | N/A | N/A | Yes | Yes |
2222
| Ingress events | Pay per million events | Pay per million events | Included | Included |
2323
| Runtime audit logs | N/A | N/A | Yes | Yes |
24-
| Availability Zone | Yes | Yes | Yes | Yes |
25-
| Geo disaster | N/A | Yes | Yes | Yes |
26-
| IP Firewall | N/A | Yes | Yes | Yes |
24+
| Availability zone | Yes | Yes | Yes | Yes |
25+
| Geo-disaster | N/A | Yes | Yes | Yes |
26+
| IP firewall | N/A | Yes | Yes | Yes |
2727

2828
> [!NOTE]
29-
> **Included** in the table means the feature is available and there's no separate charge for using it.
29+
> *Included* in the table means the feature is available and there's no separate charge for using it.
3030
3131

3232

articles/event-hubs/includes/event-hubs-tier-limits.md

Lines changed: 20 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -10,35 +10,33 @@ ms.custom: "include file","fasttrack-edit","iot","event-hubs"
1010

1111
---
1212

13-
The following table shows limits that are different for basic, standard, premium, and dedicated tiers.
13+
The following table shows limits that are different for Basic, Standard, Premium, and Dedicated tiers.
1414

1515
> [!NOTE]
16-
> - In the table, CU is [capacity unit](../event-hubs-dedicated-overview.md), PU is [processing unit](../event-hubs-scalability.md#processing-units), and TU is [throughput unit](../event-hubs-scalability.md#throughput-units).
17-
> - You can configure [TUs](../event-hubs-auto-inflate.md#use-azure-portal) for a basic or standard tier namespace or [PUs](../configure-processing-units-premium-namespace.md) for a premium tier namespace.
18-
> - When you [create a dedicated cluster](../event-hubs-dedicated-cluster-create-portal.md#create-an-event-hubs-dedicated-cluster), 1 CU is assigned to the cluster. If you enable the **Support Scaling** option while creating the cluster, you'll be able to scale out by increasing CUs or scale in by decreasing CUs for the cluster yourself. For step-by-step instructions, see [Scale dedicated cluster](../event-hubs-dedicated-cluster-create-portal.md#scale-a-dedicated-cluster). For clusters that don't support the **Support Scaling** feature, [submit a ticket](../event-hubs-dedicated-cluster-create-portal.md#submit-a-support-request) To adjust CUs for the cluster.
16+
> - In the table, CU is [capacity unit](../event-hubs-dedicated-overview.md), PU is [processing unit](../event-hubs-scalability.md#processing-units), and TU is [throughput unit](../event-hubs-scalability.md#throughput-units).
17+
> - You can configure [TUs](../event-hubs-auto-inflate.md#use-azure-portal) for a Basic or Standard tier namespace or [PUs](../configure-processing-units-premium-namespace.md) for a Premium tier namespace.
18+
> - When you [create a dedicated cluster](../event-hubs-dedicated-cluster-create-portal.md#create-an-event-hubs-dedicated-cluster), one CU is assigned to the cluster. If you enable the **Support scaling** option while you create the cluster, you can scale out by increasing CUs or scale in by decreasing CUs for the cluster yourself. For step-by-step instructions, see [Scale dedicated cluster](../event-hubs-dedicated-cluster-create-portal.md#scale-a-dedicated-cluster). For clusters that don't support the **Support scaling** feature, [submit a ticket](../event-hubs-dedicated-cluster-create-portal.md#submit-a-support-request) to adjust CUs for the cluster.
1919
20-
| Limit | Basic | Standard | Premium | Dedicated |
20+
| Limit | Basic | Standard | Premium | Dedicated |
2121
| ----- | ----- | -------- | -------- | --------- |
22-
| Maximum size of Event Hubs publication | 256 KB | 1 MB | 1 MB | 1 MB |
23-
| Number of consumer groups per event hub | 1 | 20 | 100 | 1000<br/>No limit per CU |
24-
| Number of Kafka consumer groups per Namespace | NA | 1000 | 1000 | 1000 |
25-
| Number of brokered connections per namespace | 100 | 5,000 | 10000 per PU<br/><br/>For example, if the namespace is assigned 3 PUs, the limit is 30000. | 100, 000 per CU |
22+
| Maximum size of Event Hubs publication | 256 KB | 1 MB | 1 MB | 1 MB |
23+
| Number of consumer groups per event hub | 1 | 20 | 100 | 1,000<br/>No limit per CU |
24+
| Number of Kafka consumer groups per namespace | NA | 1,000 | 1,000 | 1,000 |
25+
| Number of brokered connections per namespace | 100 | 5,000 | 10,000 per PU<br/><br/>For example, if the namespace is assigned 3 PUs, the limit is 30,000. | 100,000 per CU |
2626
| Maximum retention period of event data | 1 day | 7 days | 90 days | 90 days |
27-
| Event storage for retention | 84 GB per TU | 84 GB per TU | 1 TB per PU | 10 TB per CU |
27+
| Event storage for retention | 84 GB per TU | 84 GB per TU | 1 TB per PU | 10 TB per CU |
2828
| Maximum TUs or PUs or CUs | 40 TUs | 40 TUs | 16 PUs | 20 CUs |
29-
| Number of partitions per event hub | 32 | 32 | 100 per event hub, but there's a limit of 200 per PU at the namespace level.<br/><br/> For example, if a namespace is assigned 2 PUs, the limit for total number of partitions in all event hubs in the namespace is 2 * 200 = 400. | 1024 per event hub<br/> 2000 per CU |
30-
| Number of namespaces per subscription | 1000 | 1000 | 1000 | 1000 (50 per CU) |
31-
| Number of event hubs per namespace | 10 | 10 | 100 per PU | 1000 |
29+
| Number of partitions per event hub | 32 | 32 | 100 per event hub, but there's a limit of 200 per PU at the namespace level.<br/><br/> For example, if a namespace is assigned 2 PUs, the limit for total number of partitions in all event hubs in the namespace is 2 * 200 = 400. | 1,024 per event hub<br/> 2,000 per CU |
30+
| Number of namespaces per subscription | 1,000 | 1,000 | 1,000 | 1,000 (50 per CU) |
31+
| Number of event hubs per namespace | 10 | 10 | 100 per PU | 1,000 |
3232
| Capture | N/A | Pay per hour | Included | Included |
33-
| Size of compacted event hub | N/A | 1 GB per partition | 250 GB per partition | 250 GB per partition |
34-
| Size of the schema registry (namespace) in mega bytes | N/A | 25 | 100 | 1024 |
35-
| Number of schema groups in a schema registry or namespace | N/A | 1 - excluding the default group | 100 <br/>1 MB per schema | 1000<br/>1 MB per schema |
36-
| Number of schema versions across all schema groups | N/A | 25 | 1000 | 10000 |
37-
| Throughput per unit | Ingress - 1 MB/s or 1000 events per second<br/>Egress2 MB/s or 4,096 events per second | Ingress - 1 MB/s or 1000 events per second<br/>Egress2 MB/s or 4,096 events per second | No limits per PU * | No limits per CU * |
33+
| Size of compacted event hub | N/A | 1 GB per partition | 250 GB per partition | 250 GB per partition |
34+
| Size of the schema registry (namespace) in megabytes | N/A | 25 | 100 | 1,024 |
35+
| Number of schema groups in a schema registry or namespace | N/A | 1: excluding the default group | 100 <br/>1 MB per schema | 1,000<br/>1 MB per schema |
36+
| Number of schema versions across all schema groups | N/A | 25 | 1,000 | 10,000 |
37+
| Throughput per unit | Ingress: 1 MB/sec or 1000 events per second<br/>Egress: 2 MB/sec or 4,096 events per second | Ingress: 1 MB/sec or 1,000 events per second<br/>Egress: 2 MB/sec or 4,096 events per second | No limits per PU * | No limits per CU * |
3838

39-
\* Depends on various factors such as resource allocation, number of partitions, storage, and so on.
40-
39+
\* Depends on factors such as resource allocation, number of partitions, and storage.
4140

4241
> [!NOTE]
43-
> You can publish events individually or batched.
44-
> The publication limit (according to SKU) applies regardless of whether it is a single event or a batch. Publishing events larger than the maximum threshold will be rejected.
42+
> You can publish events individually or batched. The publication limit (according to SKU) applies regardless of whether it's a single event or a batch. Publishing events larger than the maximum threshold will be rejected.

0 commit comments

Comments
 (0)