[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74PYKRQV89P2CSMFVM156F2":3,"skill-same:01M74PYKRQV89P2CSMFVM156F2":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":5,"forksCount":14,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":6,"updatedAt":34,"install":35,"resources":48},"01M74PYKRQV89P2CSMFVM156F2","azure-eventhub-dotnet",null,"Azure Event Hubs SDK for .NET. Use for high-throughput event streaming: sending events (EventHubProducerClient, EventHubBufferedProducerClient), receiving events (EventProcessorClient with checkpointing), partition management, and real-time data ingestion. Triggers: \"Event Hubs\", \"event streaming\", \"EventHubProducerClient\", \"EventProcessorClient\", \"send events\", \"receive events\", \"checkpointing\", \"partition\".","SamuelChien\u002Fmega-skills-collection","SamuelChien","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F4652114?v=4","01M74KK34WVHA0P5ZYSJRDDFMG","Samuel Chien","01M74KK35FQN1N9VZ9EPTH3P2S",0,"MIT","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fazure-eventhub-dotnet\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: azure-eventhub-dotnet\ndescription: |\n  Azure Event Hubs SDK for .NET. Use for high-throughput event streaming: sending events (EventHubProducerClient, EventHubBufferedProducerClient), receiving events (EventProcessorClient with checkpointing), partition management, and real-time data ingestion. Triggers: \"Event Hubs\", \"event streaming\", \"EventHubProducerClient\", \"EventProcessorClient\", \"send events\", \"receive events\", \"checkpointing\", \"partition\".\nlicense: MIT\nmetadata:\n  author: Microsoft\n  version: \"1.0.0\"\n  package: Azure.Messaging.EventHubs\n---\n\n# Azure.Messaging.EventHubs (.NET)\n\nHigh-throughput event streaming SDK for sending and receiving events via Azure Event Hubs.\n\n## Installation\n\n```bash\n# Core package (sending and simple receiving)\ndotnet add package Azure.Messaging.EventHubs\n\n# Processor package (production receiving with checkpointing)\ndotnet add package Azure.Messaging.EventHubs.Processor\n\n# Authentication\ndotnet add package Azure.Identity\n\n# For checkpointing (required by EventProcessorClient)\ndotnet add package Azure.Storage.Blobs\n```\n\n**Current Versions**: Azure.Messaging.EventHubs v5.12.2, Azure.Messaging.EventHubs.Processor v5.12.2\n\n## Environment Variables\n\n```bash\nEVENTHUB_FULLY_QUALIFIED_NAMESPACE=\u003Cnamespace>.servicebus.windows.net  # Required: Event Hubs fully qualified namespace\nEVENTHUB_NAME=\u003Cevent-hub-name>  # Required: Event Hub name\nBLOB_STORAGE_CONNECTION_STRING=\u003Cstorage-connection-string>  # Alternative to Entra ID auth\nBLOB_CONTAINER_NAME=\u003Ccheckpoint-container>  # Required: checkpoint container name\nEVENTHUB_CONNECTION_STRING=Endpoint=sb:\u002F\u002F\u003Cnamespace>.servicebus.windows.net\u002F;SharedAccessKeyName=...  # Alternative to Entra ID auth\nAZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production\n```\n\n## Authentication\n\n```csharp\nusing Azure.Identity;\nusing Azure.Messaging.EventHubs;\nusing Azure.Messaging.EventHubs.Producer;\n\n\u002F\u002F Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>\nvar credential = new DefaultAzureCredential(\n    DefaultAzureCredential.DefaultEnvironmentVariableName\n);\n\u002F\u002F Or use a specific credential directly in production:\n\u002F\u002F See https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Foverview\u002Fazure\u002Fidentity-readme?view=azure-dotnet#credential-classes\n\u002F\u002F var credential = new ManagedIdentityCredential();\n\nvar fullyQualifiedNamespace = Environment.GetEnvironmentVariable(\"EVENTHUB_FULLY_QUALIFIED_NAMESPACE\");\nvar eventHubName = Environment.GetEnvironmentVariable(\"EVENTHUB_NAME\");\n\nvar producer = new EventHubProducerClient(\n    fullyQualifiedNamespace,\n    eventHubName,\n    credential);\n```\n\n**Required RBAC Roles**:\n- **Sending**: `Azure Event Hubs Data Sender`\n- **Receiving**: `Azure Event Hubs Data Receiver`\n- **Both**: `Azure Event Hubs Data Owner`\n\n## Client Types\n\n| Client | Purpose | When to Use |\n|--------|---------|-------------|\n| `EventHubProducerClient` | Send events immediately in batches | Real-time sending, full control over batching |\n| `EventHubBufferedProducerClient` | Automatic batching with background sending | High-volume, fire-and-forget scenarios |\n| `EventHubConsumerClient` | Simple event reading | Prototyping only, NOT for production |\n| `EventProcessorClient` | Production event processing | **Always use this for receiving in production** |\n\n## Core Workflow\n\n### 1. Send Events (Batch)\n\n```csharp\nusing Azure.Identity;\nusing Azure.Messaging.EventHubs;\nusing Azure.Messaging.EventHubs.Producer;\n\nawait using var producer = new EventHubProducerClient(\n    fullyQualifiedNamespace,\n    eventHubName,\n    new DefaultAzureCredential());\n\n\u002F\u002F Create a batch (respects size limits automatically)\nusing EventDataBatch batch = await producer.CreateBatchAsync();\n\n\u002F\u002F Add events to batch\nvar events = new[]\n{\n    new EventData(BinaryData.FromString(\"{\\\"id\\\": 1, \\\"message\\\": \\\"Hello\\\"}\")),\n    new EventData(BinaryData.FromString(\"{\\\"id\\\": 2, \\\"message\\\": \\\"World\\\"}\"))\n};\n\nforeach (var eventData in events)\n{\n    if (!batch.TryAdd(eventData))\n    {\n        \u002F\u002F Batch is full - send it and create a new one\n        await producer.SendAsync(batch);\n        batch = await producer.CreateBatchAsync();\n        \n        if (!batch.TryAdd(eventData))\n        {\n            throw new Exception(\"Event too large for empty batch\");\n        }\n    }\n}\n\n\u002F\u002F Send remaining events\nif (batch.Count > 0)\n{\n    await producer.SendAsync(batch);\n}\n```\n\n### 2. Send Events (Buffered - High Volume)\n\n```csharp\nusing Azure.Messaging.EventHubs.Producer;\n\nvar options = new EventHubBufferedProducerClientOptions\n{\n    MaximumWaitTime = TimeSpan.FromSeconds(1)\n};\n\nawait using var producer = new EventHubBufferedProducerClient(\n    fullyQualifiedNamespace,\n    eventHubName,\n    new DefaultAzureCredential(),\n    options);\n\n\u002F\u002F Handle send success\u002Ffailure\nproducer.SendEventBatchSucceededAsync += args =>\n{\n    Console.WriteLine($\"Batch sent: {args.EventBatch.Count} events\");\n    return Task.CompletedTask;\n};\n\nproducer.SendEventBatchFailedAsync += args =>\n{\n    Console.WriteLine($\"Batch failed: {args.Exception.Message}\");\n    return Task.CompletedTask;\n};\n\n\u002F\u002F Enqueue events (sent automatically in background)\nfor (int i = 0; i \u003C 1000; i++)\n{\n    await producer.EnqueueEventAsync(new EventData($\"Event {i}\"));\n}\n\n\u002F\u002F Flush remaining events before disposing\nawait producer.FlushAsync();\n```\n\n### 3. Receive Events (Production - EventProcessorClient)\n\n```csharp\nusing Azure.Identity;\nusing Azure.Messaging.EventHubs;\nusing Azure.Messaging.EventHubs.Consumer;\nusing Azure.Messaging.EventHubs.Processor;\nusing Azure.Storage.Blobs;\n\n\u002F\u002F Blob container for checkpointing\nvar blobClient = new BlobContainerClient(\n    Environment.GetEnvironmentVariable(\"BLOB_STORAGE_CONNECTION_STRING\"),\n    Environment.GetEnvironmentVariable(\"BLOB_CONTAINER_NAME\"));\n\nawait blobClient.CreateIfNotExistsAsync();\n\n\u002F\u002F Create processor\nvar processor = new EventProcessorClient(\n    blobClient,\n    EventHubConsumerClient.DefaultConsumerGroup,\n    fullyQualifiedNamespace,\n    eventHubName,\n    new DefaultAzureCredential());\n\n\u002F\u002F Handle events\nprocessor.ProcessEventAsync += async args =>\n{\n    Console.WriteLine($\"Partition: {args.Partition.PartitionId}\");\n    Console.WriteLine($\"Data: {args.Data.EventBody}\");\n    \n    \u002F\u002F Checkpoint after processing (or batch checkpoints)\n    await args.UpdateCheckpointAsync();\n};\n\n\u002F\u002F Handle errors\nprocessor.ProcessErrorAsync += args =>\n{\n    Console.WriteLine($\"Error: {args.Exception.Message}\");\n    Console.WriteLine($\"Partition: {args.PartitionId}\");\n    return Task.CompletedTask;\n};\n\n\u002F\u002F Start processing\nawait processor.StartProcessingAsync();\n\n\u002F\u002F Run until cancelled\nawait Task.Delay(Timeout.Infinite, cancellationToken);\n\n\u002F\u002F Stop gracefully\nawait processor.StopProcessingAsync();\n```\n\n### 4. Partition Operations\n\n```csharp\n\u002F\u002F Get partition IDs\nstring[] partitionIds = await producer.GetPartitionIdsAsync();\n\n\u002F\u002F Send to specific partition (use sparingly)\nvar options = new SendEventOptions\n{\n    PartitionId = \"0\"\n};\nawait producer.SendAsync(events, options);\n\n\u002F\u002F Use partition key (recommended for ordering)\nvar batchOptions = new CreateBatchOptions\n{\n    PartitionKey = \"customer-123\"  \u002F\u002F Events with same key go to same partition\n};\nusing var batch = await producer.CreateBatchAsync(batchOptions);\n```\n\n## EventPosition Options\n\nControl where to start reading:\n\n```csharp\n\u002F\u002F Start from beginning\nEventPosition.Earliest\n\n\u002F\u002F Start from end (new events only)\nEventPosition.Latest\n\n\u002F\u002F Start from specific offset\nEventPosition.FromOffset(12345)\n\n\u002F\u002F Start from specific sequence number\nEventPosition.FromSequenceNumber(100)\n\n\u002F\u002F Start from specific time\nEventPosition.FromEnqueuedTime(DateTimeOffset.UtcNow.AddHours(-1))\n```\n\n## ASP.NET Core Integration\n\n```csharp\n\u002F\u002F Program.cs\nusing Azure.Identity;\nusing Azure.Messaging.EventHubs.Producer;\nusing Microsoft.Extensions.Azure;\n\nbuilder.Services.AddAzureClients(clientBuilder =>\n{\n    clientBuilder.AddEventHubProducerClient(\n        builder.Configuration[\"EventHub:FullyQualifiedNamespace\"],\n        builder.Configuration[\"EventHub:Name\"]);\n    \n    clientBuilder.UseCredential(new DefaultAzureCredential());\n});\n\n\u002F\u002F Inject in controller\u002Fservice\npublic class EventService\n{\n    private readonly EventHubProducerClient _producer;\n    \n    public EventService(EventHubProducerClient producer)\n    {\n        _producer = producer;\n    }\n    \n    public async Task SendAsync(string message)\n    {\n        using var batch = await _producer.CreateBatchAsync();\n        batch.TryAdd(new EventData(message));\n        await _producer.SendAsync(batch);\n    }\n}\n```\n\n## Best Practices\n\n1. **Use `EventProcessorClient` for receiving** — Never use `EventHubConsumerClient` in production\n2. **Checkpoint strategically** — After N events or time interval, not every event\n3. **Use partition keys** — For ordering guarantees within a partition\n4. **Reuse clients** — Create once, use as singleton (thread-safe)\n5. **Use `await using`** — Ensures proper disposal\n6. **Handle `ProcessErrorAsync`** — Always register error handler\n7. **Batch events** — Use `CreateBatchAsync()` to respect size limits\n8. **Use buffered producer** — For high-volume scenarios with automatic batching\n\n## Error Handling\n\n```csharp\nusing Azure.Messaging.EventHubs;\n\ntry\n{\n    await producer.SendAsync(batch);\n}\ncatch (EventHubsException ex) when (ex.Reason == EventHubsException.FailureReason.ServiceBusy)\n{\n    \u002F\u002F Retry with backoff\n    await Task.Delay(TimeSpan.FromSeconds(5));\n}\ncatch (EventHubsException ex) when (ex.IsTransient)\n{\n    \u002F\u002F Transient error - safe to retry\n    Console.WriteLine($\"Transient error: {ex.Message}\");\n}\ncatch (EventHubsException ex)\n{\n    \u002F\u002F Non-transient error\n    Console.WriteLine($\"Error: {ex.Reason} - {ex.Message}\");\n}\n```\n\n## Checkpointing Strategies\n\n| Strategy | When to Use |\n|----------|-------------|\n| Every event | Low volume, critical data |\n| Every N events | Balanced throughput\u002Freliability |\n| Time-based | Consistent checkpoint intervals |\n| Batch completion | After processing a logical batch |\n\n```csharp\n\u002F\u002F Checkpoint every 100 events\nprivate int _eventCount = 0;\n\nprocessor.ProcessEventAsync += async args =>\n{\n    \u002F\u002F Process event...\n    \n    _eventCount++;\n    if (_eventCount >= 100)\n    {\n        await args.UpdateCheckpointAsync();\n        _eventCount = 0;\n    }\n};\n```\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Azure.Messaging.EventHubs` | Core sending\u002Freceiving | `dotnet add package Azure.Messaging.EventHubs` |\n| `Azure.Messaging.EventHubs.Processor` | Production processing | `dotnet add package Azure.Messaging.EventHubs.Processor` |\n| `Azure.ResourceManager.EventHubs` | Management plane (create hubs) | `dotnet add package Azure.ResourceManager.EventHubs` |\n| `Microsoft.Azure.WebJobs.Extensions.EventHubs` | Azure Functions binding | `dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs` |\n","# Azure.Messaging.EventHubs (.NET)\n\nHigh-throughput event streaming SDK for sending and receiving events via Azure Event Hubs.\n\n## Installation\n\n```bash\n# Core package (sending and simple receiving)\ndotnet add package Azure.Messaging.EventHubs\n\n# Processor package (production receiving with checkpointing)\ndotnet add package Azure.Messaging.EventHubs.Processor\n\n# Authentication\ndotnet add package Azure.Identity\n\n# For checkpointing (required by EventProcessorClient)\ndotnet add package Azure.Storage.Blobs\n```\n\n**Current Versions**: Azure.Messaging.EventHubs v5.12.2, Azure.Messaging.EventHubs.Processor v5.12.2\n\n## Environment Variables\n\n```bash\nEVENTHUB_FULLY_QUALIFIED_NAMESPACE=\u003Cnamespace>.servicebus.windows.net  # Required: Event Hubs fully qualified namespace\nEVENTHUB_NAME=\u003Cevent-hub-name>  # Required: Event Hub name\nBLOB_STORAGE_CONNECTION_STRING=\u003Cstorage-connection-string>  # Alternative to Entra ID auth\nBLOB_CONTAINER_NAME=\u003Ccheckpoint-container>  # Required: checkpoint container name\nEVENTHUB_CONNECTION_STRING=Endpoint=sb:\u002F\u002F\u003Cnamespace>.servicebus.windows.net\u002F;SharedAccessKeyName=...  # Alternative to Entra ID auth\nAZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production\n```\n\n## Authentication\n\n```csharp\nusing Azure.Identity;\nusing Azure.Messaging.EventHubs;\nusing Azure.Messaging.EventHubs.Producer;\n\n\u002F\u002F Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>\nvar credential = new DefaultAzureCredential(\n    DefaultAzureCredential.DefaultEnvironmentVariableName\n);\n\u002F\u002F Or use a specific credential directly in production:\n\u002F\u002F See https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Foverview\u002Fazure\u002Fidentity-readme?view=azure-dotnet#credential-classes\n\u002F\u002F var credential = new ManagedIdentityCredential();\n\nvar fullyQualifiedNamespace = Environment.GetEnvironmentVariable(\"EVENTHUB_FULLY_QUALIFIED_NAMESPACE\");\nvar eventHubName = Environment.GetEnvironmentVariable(\"EVENTHUB_NAME\");\n\nvar producer = new EventHubProducerClient(\n    fullyQualifiedNamespace,\n    eventHubName,\n    credential);\n```\n\n**Required RBAC Roles**:\n- **Sending**: `Azure Event Hubs Data Sender`\n- **Receiving**: `Azure Event Hubs Data Receiver`\n- **Both**: `Azure Event Hubs Data Owner`\n\n## Client Types\n\n| Client | Purpose | When to Use |\n|--------|---------|-------------|\n| `EventHubProducerClient` | Send events immediately in batches | Real-time sending, full control over batching |\n| `EventHubBufferedProducerClient` | Automatic batching with background sending | High-volume, fire-and-forget scenarios |\n| `EventHubConsumerClient` | Simple event reading | Prototyping only, NOT for production |\n| `EventProcessorClient` | Production event processing | **Always use this for receiving in production** |\n\n## Core Workflow\n\n### 1. Send Events (Batch)\n\n```csharp\nusing Azure.Identity;\nusing Azure.Messaging.EventHubs;\nusing Azure.Messaging.EventHubs.Producer;\n\nawait using var producer = new EventHubProducerClient(\n    fullyQualifiedNamespace,\n    eventHubName,\n    new DefaultAzureCredential());\n\n\u002F\u002F Create a batch (respects size limits automatically)\nusing EventDataBatch batch = await producer.CreateBatchAsync();\n\n\u002F\u002F Add events to batch\nvar events = new[]\n{\n    new EventData(BinaryData.FromString(\"{\\\"id\\\": 1, \\\"message\\\": \\\"Hello\\\"}\")),\n    new EventData(BinaryData.FromString(\"{\\\"id\\\": 2, \\\"message\\\": \\\"World\\\"}\"))\n};\n\nforeach (var eventData in events)\n{\n    if (!batch.TryAdd(eventData))\n    {\n        \u002F\u002F Batch is full - send it and create a new one\n        await producer.SendAsync(batch);\n        batch = await producer.CreateBatchAsync();\n        \n        if (!batch.TryAdd(eventData))\n        {\n            throw new Exception(\"Event too large for empty batch\");\n        }\n    }\n}\n\n\u002F\u002F Send remaining events\nif (batch.Count > 0)\n{\n    await producer.SendAsync(batch);\n}\n```\n\n### 2. Send Events (Buffered - High Volume)\n\n```csharp\nusing Azure.Messaging.EventHubs.Producer;\n\nvar options = new EventHubBufferedProducerClientOptions\n{\n    MaximumWaitTime = TimeSpan.FromSeconds(1)\n};\n\nawait using var producer = new EventHubBufferedProducerClient(\n    fullyQualifiedNamespace,\n    eventHubName,\n    new DefaultAzureCredential(),\n    options);\n\n\u002F\u002F Handle send success\u002Ffailure\nproducer.SendEventBatchSucceededAsync += args =>\n{\n    Console.WriteLine($\"Batch sent: {args.EventBatch.Count} events\");\n    return Task.CompletedTask;\n};\n\nproducer.SendEventBatchFailedAsync += args =>\n{\n    Console.WriteLine($\"Batch failed: {args.Exception.Message}\");\n    return Task.CompletedTask;\n};\n\n\u002F\u002F Enqueue events (sent automatically in background)\nfor (int i = 0; i \u003C 1000; i++)\n{\n    await producer.EnqueueEventAsync(new EventData($\"Event {i}\"));\n}\n\n\u002F\u002F Flush remaining events before disposing\nawait producer.FlushAsync();\n```\n\n### 3. Receive Events (Production - EventProcessorClient)\n\n```csharp\nusing Azure.Identity;\nusing Azure.Messaging.EventHubs;\nusing Azure.Messaging.EventHubs.Consumer;\nusing Azure.Messaging.EventHubs.Processor;\nusing Azure.Storage.Blobs;\n\n\u002F\u002F Blob container for checkpointing\nvar blobClient = new BlobContainerClient(\n    Environment.GetEnvironmentVariable(\"BLOB_STORAGE_CONNECTION_STRING\"),\n    Environment.GetEnvironmentVariable(\"BLOB_CONTAINER_NAME\"));\n\nawait blobClient.CreateIfNotExistsAsync();\n\n\u002F\u002F Create processor\nvar processor = new EventProcessorClient(\n    blobClient,\n    EventHubConsumerClient.DefaultConsumerGroup,\n    fullyQualifiedNamespace,\n    eventHubName,\n    new DefaultAzureCredential());\n\n\u002F\u002F Handle events\nprocessor.ProcessEventAsync += async args =>\n{\n    Console.WriteLine($\"Partition: {args.Partition.PartitionId}\");\n    Console.WriteLine($\"Data: {args.Data.EventBody}\");\n    \n    \u002F\u002F Checkpoint after processing (or batch checkpoints)\n    await args.UpdateCheckpointAsync();\n};\n\n\u002F\u002F Handle errors\nprocessor.ProcessErrorAsync += args =>\n{\n    Console.WriteLine($\"Error: {args.Exception.Message}\");\n    Console.WriteLine($\"Partition: {args.PartitionId}\");\n    return Task.CompletedTask;\n};\n\n\u002F\u002F Start processing\nawait processor.StartProcessingAsync();\n\n\u002F\u002F Run until cancelled\nawait Task.Delay(Timeout.Infinite, cancellationToken);\n\n\u002F\u002F Stop gracefully\nawait processor.StopProcessingAsync();\n```\n\n### 4. Partition Operations\n\n```csharp\n\u002F\u002F Get partition IDs\nstring[] partitionIds = await producer.GetPartitionIdsAsync();\n\n\u002F\u002F Send to specific partition (use sparingly)\nvar options = new SendEventOptions\n{\n    PartitionId = \"0\"\n};\nawait producer.SendAsync(events, options);\n\n\u002F\u002F Use partition key (recommended for ordering)\nvar batchOptions = new CreateBatchOptions\n{\n    PartitionKey = \"customer-123\"  \u002F\u002F Events with same key go to same partition\n};\nusing var batch = await producer.CreateBatchAsync(batchOptions);\n```\n\n## EventPosition Options\n\nControl where to start reading:\n\n```csharp\n\u002F\u002F Start from beginning\nEventPosition.Earliest\n\n\u002F\u002F Start from end (new events only)\nEventPosition.Latest\n\n\u002F\u002F Start from specific offset\nEventPosition.FromOffset(12345)\n\n\u002F\u002F Start from specific sequence number\nEventPosition.FromSequenceNumber(100)\n\n\u002F\u002F Start from specific time\nEventPosition.FromEnqueuedTime(DateTimeOffset.UtcNow.AddHours(-1))\n```\n\n## ASP.NET Core Integration\n\n```csharp\n\u002F\u002F Program.cs\nusing Azure.Identity;\nusing Azure.Messaging.EventHubs.Producer;\nusing Microsoft.Extensions.Azure;\n\nbuilder.Services.AddAzureClients(clientBuilder =>\n{\n    clientBuilder.AddEventHubProducerClient(\n        builder.Configuration[\"EventHub:FullyQualifiedNamespace\"],\n        builder.Configuration[\"EventHub:Name\"]);\n    \n    clientBuilder.UseCredential(new DefaultAzureCredential());\n});\n\n\u002F\u002F Inject in controller\u002Fservice\npublic class EventService\n{\n    private readonly EventHubProducerClient _producer;\n    \n    public EventService(EventHubProducerClient producer)\n    {\n        _producer = producer;\n    }\n    \n    public async Task SendAsync(string message)\n    {\n        using var batch = await _producer.CreateBatchAsync();\n        batch.TryAdd(new EventData(message));\n        await _producer.SendAsync(batch);\n    }\n}\n```\n\n## Best Practices\n\n1. **Use `EventProcessorClient` for receiving** — Never use `EventHubConsumerClient` in production\n2. **Checkpoint strategically** — After N events or time interval, not every event\n3. **Use partition keys** — For ordering guarantees within a partition\n4. **Reuse clients** — Create once, use as singleton (thread-safe)\n5. **Use `await using`** — Ensures proper disposal\n6. **Handle `ProcessErrorAsync`** — Always register error handler\n7. **Batch events** — Use `CreateBatchAsync()` to respect size limits\n8. **Use buffered producer** — For high-volume scenarios with automatic batching\n\n## Error Handling\n\n```csharp\nusing Azure.Messaging.EventHubs;\n\ntry\n{\n    await producer.SendAsync(batch);\n}\ncatch (EventHubsException ex) when (ex.Reason == EventHubsException.FailureReason.ServiceBusy)\n{\n    \u002F\u002F Retry with backoff\n    await Task.Delay(TimeSpan.FromSeconds(5));\n}\ncatch (EventHubsException ex) when (ex.IsTransient)\n{\n    \u002F\u002F Transient error - safe to retry\n    Console.WriteLine($\"Transient error: {ex.Message}\");\n}\ncatch (EventHubsException ex)\n{\n    \u002F\u002F Non-transient error\n    Console.WriteLine($\"Error: {ex.Reason} - {ex.Message}\");\n}\n```\n\n## Checkpointing Strategies\n\n| Strategy | When to Use |\n|----------|-------------|\n| Every event | Low volume, critical data |\n| Every N events | Balanced throughput\u002Freliability |\n| Time-based | Consistent checkpoint intervals |\n| Batch completion | After processing a logical batch |\n\n```csharp\n\u002F\u002F Checkpoint every 100 events\nprivate int _eventCount = 0;\n\nprocessor.ProcessEventAsync += async args =>\n{\n    \u002F\u002F Process event...\n    \n    _eventCount++;\n    if (_eventCount >= 100)\n    {\n        await args.UpdateCheckpointAsync();\n        _eventCount = 0;\n    }\n};\n```\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Azure.Messaging.EventHubs` | Core sending\u002Freceiving | `dotnet add package Azure.Messaging.EventHubs` |\n| `Azure.Messaging.EventHubs.Processor` | Production processing | `dotnet add package Azure.Messaging.EventHubs.Processor` |\n| `Azure.ResourceManager.EventHubs` | Management plane (create hubs) | `dotnet add package Azure.ResourceManager.EventHubs` |\n| `Microsoft.Azure.WebJobs.Extensions.EventHubs` | Azure Functions binding | `dotnet add package Microsoft.Azure.WebJobs.Extensions.EventHubs` |\n",{"name":5,"license":15,"metadata":24,"description":28},{"author":25,"package":26,"version":27},"Microsoft","Azure.Messaging.EventHubs","1.0.0","Azure Event Hubs SDK for .NET. Use for high-throughput event streaming: sending events (EventHubProducerClient, EventHubBufferedProducerClient), receiving events (EventProcessorClient with checkpointing), partition management, and real-time data ingestion. Triggers: \"Event Hubs\", \"event streaming\", \"EventHubProducerClient\", \"EventProcessorClient\", \"send events\", \"receive events\", \"checkpointing\", \"partition\".\n","main","c2b1fdccc779e99ac814e55fb69ca8d71215dd0f","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection","https:\u002F\u002Fgithub.com\u002FSamuelChien","http:\u002F\u002Fsamuelchien.com\u002F","2026-05-26 08:27:14",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add SamuelChien\u002Fmega-skills-collection --skill azure-eventhub-dotnet",{"tool":41,"command":42},"bunx","bunx skills add SamuelChien\u002Fmega-skills-collection --skill azure-eventhub-dotnet",{"tool":44,"command":45},"pnpm","pnpm dlx skills add SamuelChien\u002Fmega-skills-collection --skill azure-eventhub-dotnet","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fazure-eventhub-dotnet\u002FSKILL.md",true,[],[50,58,65,72,79,87],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":57},"01M76R4WZQZAXGGXMQCA0FZ716","zustand-store-ts","Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state\u002Faction separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzustand-store-ts\u002FSKILL.md",[],[],"2026-11-12 13:55:43",{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":57},"01M76R4T9KENDH7FENGZQHBW4G","zustand-store-creator","Zustand Store Creator - Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":57},"01M76R3YWN84B7SANJ52X799ZE","zero-trust-config-helper","Zero Trust Config Helper - Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":57},"01M76R3HNSV2AEYSKHM915GJ58","zapier-integration-helper","Zapier Integration Helper - Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":83,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":57},"01M76R3DJSKAT4FA7DV4BF3GCE","zai-cli","Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP.\nUse when user needs image\u002Fvideo analysis, OCR, UI-to-code conversion, error diagnosis,\nreal-time web search, web page to markdown extraction, or GitHub code exploration.\nTrigger with phrases like \"analyze this image\", \"search the web for\", \"read this page\",\n\"explore this repo\", or \"use zai\". Requires Z_AI_API_KEY.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fzai-cli\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":57},"01M76R2KAM699XE9AJVAWE4H2E","yt-research","Research competitor YouTube channels, niches, and trending topics for your content strategy.\nUse this skill whenever the user says \"research channels\", \"analyze competitors\", \"find trending topics\",\n\"niche analysis\", \"competitive research\", \"what are other creators doing\", \"scrape YouTube channels\",\nor wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.","https:\u002F\u002Fgithub.com\u002FSamuelChien\u002Fmega-skills-collection\u002Fblob\u002Fmain\u002Fyt-research\u002FSKILL.md",[],[]]