Skip to content

Commit ad998fa

Browse files
msmbaldwinCopilot
andcommitted
Fix Acrolinx issues in tutorial-configure-event-hub.md
- Remove minimizing language (simply) - Replace Since with Because at sentence start - Replace jargon (upsert, sink, peek) with standard terms - Update ms.date not needed (already current) Co-authored-by: Copilot <[email protected]>
1 parent ea5961e commit ad998fa

1 file changed

Lines changed: 26 additions & 26 deletions

File tree

articles/cloud-hsm/tutorial-configure-event-hub.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Tutorial - Configure Event Hub for Azure Cloud HSM
2+
title: Tutorial - Configure Event Hubs for Azure Cloud HSM
33
description: Learn how to configure Azure Event Hubs as a destination for Azure Cloud HSM operation event logs for real-time streaming and downstream processing.
44
author: keithp
55
manager: keithp
@@ -9,34 +9,34 @@ ms.date: 04/08/2026
99
ms.author: keithp
1010
ai-usage: ai-assisted
1111

12-
#Customer Intent: As an IT pro, I want to stream Azure Cloud HSM operation logs to Event Hub for real-time processing and integration with downstream systems.
12+
#Customer Intent: As an IT pro, I want to stream Azure Cloud HSM operation logs to Event Hubs for real-time processing and integration with downstream systems.
1313

1414
---
1515

16-
# Tutorial: Configure Event Hub for Azure Cloud HSM
16+
# Tutorial: Configure Event Hubs for Azure Cloud HSM
1717

18-
If you configured operation event logging for Azure Cloud HSM, you already have a working diagnostic setting on your Cloud HSM cluster that routes `HsmServiceOperations` logs to Storage and Log Analytics. Adding Event Hub is simply adding a third destination to that same diagnostic setting or creating a new one that targets Event Hub.
18+
If you configured operation event logging for Azure Cloud HSM, you already have a working diagnostic setting on your Cloud HSM cluster that routes `HsmServiceOperations` logs to Storage and Log Analytics. To add Event Hubs as a destination, add a third destination to that same diagnostic setting or create a new one that targets Event Hubs.
1919

20-
Azure Monitor diagnostic settings support multiple destinations simultaneously. Since your Log Analytics pipeline already proves that log emission from Cloud HSM is working, Event Hub becomes another sink receiving the same `HsmServiceOperations` category.
20+
Azure Monitor diagnostic settings support multiple destinations simultaneously. Because your Log Analytics pipeline already proves that log emission from Cloud HSM is working, Event Hubs becomes another destination receiving the same `HsmServiceOperations` category.
2121

2222
In this tutorial, you:
2323

2424
> [!div class="checklist"]
2525
>
2626
> - Create an Event Hub namespace and event hub for Cloud HSM logs.
2727
> - Configure authorization rules with least-privilege permissions.
28-
> - Update diagnostic settings to stream logs to Event Hub.
29-
> - Verify that Event Hub receives Cloud HSM operation events.
28+
> - Update diagnostic settings to stream logs to Event Hubs.
29+
> - Verify that Event Hubs receives Cloud HSM operation events.
3030
3131
## Prerequisites
3232

33-
- An Azure Cloud HSM resource that's deployed and activated. For more information, see the [Azure Cloud HSM onboarding guide](onboarding-guide.md).
33+
- A deployed and activated Azure Cloud HSM resource. For more information, see the [Azure Cloud HSM onboarding guide](onboarding-guide.md).
3434
- Diagnostic settings emitting operation event logs to Storage and Log Analytics. For more information, see [Configure and query operation event logging for Azure Cloud HSM](tutorial-operation-event-logging.md).
3535
- `Contributor` or `Monitoring Contributor` role on the Cloud HSM resource group.
3636

3737
## Verify the logs resource group exists
3838

39-
Event Hub should deploy into the same resource group that contains your storage account and Log Analytics workspace for operational event logging. If you didn't set up operational event logging, first follow the guidance in [Configure and query operation event logging for Azure Cloud HSM](tutorial-operation-event-logging.md).
39+
Event Hubs should deploy into the same resource group that contains your storage account and Log Analytics workspace for operational event logging. If you didn't set up operational event logging, first follow the guidance in [Configure and query operation event logging for Azure Cloud HSM](tutorial-operation-event-logging.md).
4040

4141
Verify that your targeted resource group exists:
4242

@@ -87,12 +87,12 @@ New-AzEventHubNamespace `
8787
Key options:
8888

8989
- **Standard SKU**: The Basic tier doesn't support diagnostic settings as a destination.
90-
- **Capacity 1**: One throughput unit (1 MB/s ingress, 2 MB/s egress) is sufficient for HSM audit logs.
91-
- **Auto-inflate disabled**: HSM log volume is low, so auto-inflate isn't necessary.
90+
- **Capacity 1**: One throughput unit (1-MB/s ingress, 2-MB/s egress) is sufficient for HSM audit logs.
91+
- **Autoinflate disabled**: HSM log volume is low, so autoinflate isn't necessary.
9292

9393
## Create an event hub inside the namespace
9494

95-
Create an event hub (topic) to receive the Cloud HSM logs.
95+
To receive the Cloud HSM logs, create an event hub inside the namespace.
9696

9797
# [Azure CLI](#tab/azure-cli)
9898

@@ -123,7 +123,7 @@ New-AzEventHub `
123123
Key options:
124124

125125
- **Partition count 2**: Two partitions are sufficient for HSM audit log throughput.
126-
- **Retention time 168 hours**: Keep messages for 7 days (the maximum for Standard tier).
126+
- **Retention time 168 hours**: Keep messages for seven days (the maximum for Standard tier).
127127
- **Cleanup policy Delete**: Delete messages after the retention period expires.
128128

129129
## Create a consumer group
@@ -179,7 +179,7 @@ New-AzEventHubAuthorizationRule `
179179
---
180180

181181
> [!NOTE]
182-
> This rule grants only `Send` permission, not `Listen` or `Manage`. Follow the principle of least privilege. Your downstream consumers (such as Azure Functions or Stream Analytics) should use a separate rule with `Listen` permission.
182+
> This rule grants only `Send` permission, not `Listen`, or `Manage`. Follow the principle of least privilege. Your downstream consumers (such as Azure Functions or Stream Analytics) should use a separate rule with `Listen` permission.
183183
184184
## Get the authorization rule resource ID
185185

@@ -213,13 +213,13 @@ Write-Host "Auth Rule ID: $authRuleId"
213213

214214
Save this value for use in the next step.
215215

216-
## Update the diagnostic setting to add Event Hub
216+
## Update the diagnostic setting to add Event Hubs
217217

218-
You have two options for adding Event Hub as a destination:
218+
You have two options for adding Event Hubs as a destination:
219219

220220
### Option A: Update the existing diagnostic setting (recommended)
221221

222-
This approach updates your existing diagnostic setting to add Event Hub while keeping Storage and Log Analytics.
222+
This approach updates your existing diagnostic setting to add Event Hubs while keeping Storage and Log Analytics.
223223

224224
# [Azure CLI](#tab/azure-cli)
225225

@@ -312,11 +312,11 @@ New-AzDiagnosticSetting `
312312
---
313313

314314
> [!IMPORTANT]
315-
> Both CLI and PowerShell commands perform an upsert operation. If the name matches an existing setting, it replaces the setting entirely. You must include the storage account and workspace again, or those destinations are removed.
315+
> Both CLI and PowerShell commands replace the entire diagnostic setting if the name matches an existing one. You must include the storage account and workspace again, or those destinations are removed.
316316
317-
### Option B: Create a separate diagnostic setting for Event Hub only
317+
### Option B: Create a separate diagnostic setting for Event Hubs only
318318

319-
If you prefer to keep your existing setting unchanged and add a second one:
319+
If you prefer to keep your existing setting unchanged and add a second one,
320320

321321
# [Azure CLI](#tab/azure-cli)
322322

@@ -377,17 +377,17 @@ New-AzDiagnosticSetting `
377377
> [!NOTE]
378378
> Azure supports up to five diagnostic settings per resource. A second setting is valid and keeps concerns separated.
379379
380-
## Verify Event Hub is receiving messages
380+
## Verify Event Hubs is receiving messages
381381

382-
After you configure the diagnostic setting, verify that Event Hub is receiving Cloud HSM logs.
382+
After you configure the diagnostic setting, verify that Event Hubs is receiving Cloud HSM logs.
383383

384384
### Check the diagnostic setting in the portal
385385

386386
1. In the Azure portal, go to your Cloud HSM cluster.
387387
1. Under **Monitoring**, select **Diagnostic settings**.
388-
1. Confirm that Event Hub is listed as a destination.
388+
1. Confirm that Event Hubs is listed as a destination.
389389

390-
### Check Event Hub metrics
390+
### Check Event Hubs metrics
391391

392392
Run the following command to check incoming messages over the last hour:
393393

@@ -423,7 +423,7 @@ Get-AzMetric `
423423

424424
---
425425

426-
### Peek at messages (optional)
426+
### View messages (optional)
427427

428428
If you want to read a few messages to confirm content, create a **Listen** rule:
429429

@@ -466,7 +466,7 @@ $keys.PrimaryConnectionString
466466

467467
---
468468

469-
You can use this connection string with Azure Event Hub Explorer, the VS Code Event Hub extension, or a Python script to peek at messages.
469+
You can use this connection string with Azure Event Hubs Explorer, the Visual Studio Code Event Hubs extension, or a Python script to view messages.
470470

471471
## Related content
472472

0 commit comments

Comments
 (0)