eventhubs-integration

page_type	languages	products	description	urlFragment
sample	java	azure-event-hubs	Azure Spring Cloud Sample project for Event Hub Integration client library	azure-spring-integration-eventhubs-sample

Spring Cloud Azure Event Hub Integration Code Sample shared library for Java

Key concepts

This code sample demonstrates how to use Spring Integration for Azure Event Hub.

Getting started

Running this sample will be charged by Azure. You can check the usage and bill at this link.

Create Azure resources

1. Create Azure Event Hubs. Please note Basic tier is unsupported. After creating the Azure Event Hub, you can create your own Consumer Group or use the default "$Default" Consumer Group.

2. Create Azure Storage for checkpoint use.

3. [Optional] if you want to use service principal, please follow create service principal from Azure CLI to create one.

4. [Optional] if you want to use managed identity, please follow create managed identity to set up managed identity.

Examples

1. Update application.yaml. If you choose to use service principal or managed identity, update the application-sp.yaml or application-mi.yaml respectively.

   spring:
     cloud:
       azure:
         eventhub:
           connection-string: [eventhub-namespace-connection-string]
           checkpoint-storage-account: [checkpoint-storage-account]
           checkpoint-access-key: [checkpoint-access-key]
           checkpoint-container: [checkpoint-container]

2. Update event hub name and consumer group in ReceiveController and SendController.

3. Run the mvn spring-boot:run in the root of the code sample to get the app running.

4. Send a POST request

   $ curl -X POST http://localhost:8080/messages?message=hello
   

5. Verify in your app’s logs that a similar message was posted:

   New message received: 'hello'
   Message 'hello' successfully checkpointed
   

6. Delete the resources on Azure Portal to avoid unexpected charges.

Troubleshooting

Next steps

Contributing