bitpulse / azure-event-hubs-dotnet

☁️ .NET Standard client library for Azure Event Hubs



Microsoft Azure Event Hubs Client for .NET

Build/Package	Status
master
dev
Microsoft.Azure.EventHubs
Microsoft.Azure.EventHubs.Processor

This library is built using .NET Standard 1.3. For more information on what platforms are supported see .NET Platforms Support.

Azure Event Hubs is a highly scalable publish-subscribe service that can ingest millions of events per second and stream them into multiple applications. This lets you process and analyze the massive amounts of data produced by your connected devices and applications. Once Event Hubs has collected the data, you can retrieve, transform and store it by using any real-time analytics provider or with batching/storage adapters.

Refer to the online documentation to learn more about Event Hubs in general.

How to provide feedback

See our Contribution Guidelines.

Overview

The .NET client library for Azure Event Hubs allows for both sending events to and receiving events from an Azure Event Hub.

An event publisher is a source of telemetry data, diagnostics information, usage logs, or other log data, as part of an emvbedded device solution, a mobile device application, a game title running on a console or other device, some client or server based business solution, or a web site.

An event consumer picks up such information from the Event Hub and processes it. Processing may involve aggregation, complex computation and filtering. Processing may also involve distribution or storage of the information in a raw or transformed fashion. Event Hub consumers are often robust and high-scale platform infrastructure parts with built-in analytics capabilites, like Azure Stream Analytics, Apache Spark, or Apache Storm.

Most applications will act either as an event publisher or an event consumer, but rarely both. The exception are event consumers that filter and/or transform event streams and then forward them on to another Event Hub; an example for such is Azure Stream Analytics.

Getting Started

To get started sending events to an Event Hub refer to Get started sending messages to Event Hubs in .NET Core.

To get started receiving events with the EventProcessorHost refer to Get started receiving messages with the EventProcessorHost in .NET Core.

Running the unit tests

In order to run the unit tests, you will need to do the following:

1. Create an Event Hub

2. Create a consumer group on that Event Hub called cgroup1 in addition to the default consumer group.

3. Create a storage account

4. Add the following Environment Variables with the corresponding connection strings:

5. EVENTHUBCONNECTIONSTRING - The EntityPath is required in this string.

6. EVENTPROCESSORSTORAGECONNECTIONSTRING