MMP.Herald.Sinks.AzureEventHub
0.2.2
dotnet add package MMP.Herald.Sinks.AzureEventHub --version 0.2.2
NuGet\Install-Package MMP.Herald.Sinks.AzureEventHub -Version 0.2.2
<PackageReference Include="MMP.Herald.Sinks.AzureEventHub" Version="0.2.2" />
<PackageVersion Include="MMP.Herald.Sinks.AzureEventHub" Version="0.2.2" />
<PackageReference Include="MMP.Herald.Sinks.AzureEventHub" />
paket add MMP.Herald.Sinks.AzureEventHub --version 0.2.2
#r "nuget: MMP.Herald.Sinks.AzureEventHub, 0.2.2"
#:package MMP.Herald.Sinks.AzureEventHub@0.2.2
#addin nuget:?package=MMP.Herald.Sinks.AzureEventHub&version=0.2.2
#tool nuget:?package=MMP.Herald.Sinks.AzureEventHub&version=0.2.2
Herald.Sinks.AzureEventHub
Publishes Herald log events as messages to an Azure Event Hubs partition via EventHubProducerClient. Drop-in for Serilog.Sinks.AzureEventHub. Pairs with Herald.Sinks.Kafka for multi-cloud streaming setups.
Part of Herald — high-performance structured logging for .NET 8, 9, and 10.
Install
dotnet add package Herald.Sinks.AzureEventHub
The sink auto-registers into LogSinkProviderRegistry.Default via a [ModuleInitializer] on assembly load. No manual RegisterAll(...) or With*SinkProviders() call is required — dotnet add package is the whole workflow.
Sink kind: azure_event_hub (the identifier the Dashboard form and JSON config use to reference this sink).
Capabilities
- EventDataBatch with TryAdd → split-and-resend on 1 MB ceiling
- DefaultAzureCredential overload for managed-identity scenarios
- level / category copied to AMQP application-properties for routing
- JSON body with ContentType=application/json
- Code-first overload accepts a pre-built EventHubProducerClient
Limitations
- Synchronous Send (.GetAwaiter().GetResult around async API)
- No partition-key routing in 1.0
- No SAS-only auth helper — feed via connection string
Tier & runtime
- Edition: Community — works on the free Apache 2.0 Herald.Core. No license key required.
- AOT-compatible: yes
- Targets: .NET 8 / 9 / 10
- Thread safety: Thread-safe — EventHubProducerClient is thread-safe per Azure SDK contract.
Vendor
Microsoft Azure — https://learn.microsoft.com/azure/event-hubs/
Configuration
Per-sink config form lives in configuration*.mmpform at the package root and inside the assembly as an embedded resource. The Herald Dashboard renders it at runtime; JSON config follows the same shape. See CAPABILITY.yaml shipped at the package root for the full manifest (schema reference: CAPABILITY-SCHEMA.md).
License
Apache 2.0. Copyright (c) 2026 MMPWorks LLC. See LICENSE shipped at the package root.
Generated from CAPABILITY.yaml. Re-run Modules/Herald.Sinks/tools/generate-readmes.cjs after manifest edits to refresh.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Azure.Identity (>= 1.13.2)
- Azure.Messaging.EventHubs (>= 5.11.5)
- Herald.OSS (>= 0.13.0)
- Herald.Sinks.Batching (>= 0.2.2)
-
net8.0
- Azure.Identity (>= 1.13.2)
- Azure.Messaging.EventHubs (>= 5.11.5)
- Herald.OSS (>= 0.13.0)
- Herald.Sinks.Batching (>= 0.2.2)
-
net9.0
- Azure.Identity (>= 1.13.2)
- Azure.Messaging.EventHubs (>= 5.11.5)
- Herald.OSS (>= 0.13.0)
- Herald.Sinks.Batching (>= 0.2.2)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.2.2 | 108 | 8/7/2026 |
| 0.2.1 | 120 | 5/30/2026 |
| 0.2.0 | 113 | 5/26/2026 |
| 0.2.0-alpha.3 | 71 | 5/13/2026 |
| 0.2.0-alpha.2 | 64 | 5/13/2026 |
| 0.2.0-alpha.1 | 67 | 5/13/2026 |