Skip to content

Commit 22fb05f

Browse files
authored
Merge pull request #110115 from spelluru/ehubkafkadevguide0402
Kafka Developer Guide for Event Hubs
2 parents 80f2cfe + 9393f34 commit 22fb05f

10 files changed

+108
-112
lines changed

articles/event-hubs/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -162,6 +162,8 @@
162162
maintainContext: true
163163
- name: Integrate with Apache Kafka
164164
items:
165+
- name: Kafka developer guide for Event Hubs
166+
href: apache-kafka-developer-guide.md
165167
- name: Mirror a Kafka broker in an event hub
166168
href: event-hubs-kafka-mirror-maker-tutorial.md
167169
- name: Connect Apache Spark to an event hub
Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
---
2+
title: Apache Kafka developer guide for Event Hubs
3+
description: This article provides links to articles that describe how to integrate your Kafka applications with Azure Event Hubs.
4+
services: event-hubs
5+
author: spelluru
6+
manager:
7+
ms.author: spelluru
8+
ms.date: 03/31/2020
9+
ms.topic: article
10+
ms.service: event-hubs
11+
---
12+
13+
# Apache Kafka developer guide for Azure Event Hubs
14+
This article provides links to articles that describe how to integrate your Apache Kafka applications with Azure Event Hubs.
15+
16+
## Overview
17+
Event Hubs provides a Kafka endpoint that can be used by your existing Kafka based applications as an alternative to running your own Kafka cluster. Event Hubs supports Apache Kafka protocol 1.0 and later, and works with your existing Kafka applications, including MirrorMaker. For more information, see [Event Hubs for Apache Kafka](event-hubs-for-kafka-ecosystem-overview.md)
18+
19+
## Quickstarts
20+
You can find quickstarts in GitHub and in this content set that helps you quickly ramp up on Event Hubs for Kafka.
21+
22+
### Quickstarts in GitHub
23+
See the following quickstarts in the **azure-event-hubs-for-kafka** repo:
24+
25+
| Client language/framework | Description |
26+
| ------------------------- | ----------- |
27+
| [.NET](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/quickstart/dotnet) | <p>This quickstart will show how to create and connect to an Event Hubs Kafka endpoint using an example producer and consumer written in C# using .NET Core 2.0.</p><p>This sample is based on [Confluent's Apache Kafka .NET client](https://github.com/confluentinc/confluent-kafka-dotnet), modified for use with Event Hubs for Kafka.</p> |
28+
| [Java](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/quickstart/java) | This quickstart will show how to create and connect to an Event Hubs Kafka endpoint using an example producer and consumer written in Java. |
29+
| [Node.js](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/quickstart/node) | <p>This quickstart will show how to create and connect to an Event Hubs Kafka endpoint using an example producer and consumer written in Node.</p><p>This sample uses the [node-rdkafka](https://github.com/Blizzard/node-rdkafka) library. </p>|
30+
| [Python](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/quickstart/python) | <p>This quickstart will show how to create and connect to an Event Hubs Kafka endpoint using an example producer and consumer written in python.</p><p>This sample is based on [Confluent's Apache Kafka Python client](https://github.com/confluentinc/confluent-kafka-python), modified for use with Event Hubs for Kafka.</p>|
31+
| [Go](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/quickstart/go) | <p>This quickstart will show how to create and connect to an Event Hubs Kafka endpoint using an example producer and consumer written in Go.</p><p>This sample is based on [Confluent's Apache Kafka Golang client](https://github.com/confluentinc/confluent-kafka-go), modified for use with Event Hubs for Kafka.</p>|
32+
| [Sarama kafka Go](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/quickstart/go-sarama-client) | This quickstart will show how to create and connect to an Event Hubs Kafka endpoint using an example producer and consumer written in Go using the [Sarama Kafka client](https://github.com/Shopify/sarama) library. |
33+
| [Kafka](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/quickstart/kafka-cli) | This quickstart will show how to create and connect to an Event Hubs Kafka endpoint using the CLI that comes bundled with the Apache Kafka distribution.|
34+
| [Kafkacat](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/quickstart/kafkacat) | kafkacat is a non-JVM command-line consumer and producer based on librdkafka, popular due to its speed and small footprint. This quickstart contains a sample configuration and several simple sample kafkacat commands. |
35+
36+
### Quickstarts in DOCS
37+
See the quickstart: [Data streaming with Event Hubs using the Kafka protocol](event-hubs-quickstart-kafka-enabled-event-hubs.md) in this content set, which provides step-by-step instructions on how to stream into Event Hubs. You learn how to use your producers and consumers to talk to Event Hubs with just a configuration change in your applications.
38+
39+
40+
## Tutorials
41+
42+
### Tutorials in GitHub
43+
See the following tutorials on GitHub:
44+
45+
| Tutorial | Description |
46+
| ------------------------- | ----------- |
47+
| [Akka](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/akka/java) | This tutorial shows how to connect Akka Streams to Kafka-enabled Event Hubs without changing your protocol clients or running your own clusters. There are two separate tutorials using **Java** and **Scala** programming languages. |
48+
| [Connect](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/connect) | This document will walk you through integrating Kafka Connect with Azure Event Hubs and deploying basic FileStreamSource and FileStreamSink connectors. While these connectors are not meant for production use, they demonstrate an end-to-end Kafka Connect Scenario where Azure Event Hubs masquerades as a Kafka broker.|
49+
| [Filebeat](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/filebeat) | This document will walk you through integrating Filebeat and Event Hubs via Filebeat's Kafka output. |
50+
| [Flink](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/flink) | This tutorial will show how to connect Apache Flink to Kafka-enabled Event Hubs without changing your protocol clients or running your own clusters. |
51+
| [FluentD](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/fluentd) | This document will walk you through integrating Fluentd and Event Hubs using the `out_kafka` output plugin for Fluentd. |
52+
| [Interop](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/interop) | This tutorial shows you how to exchange events between consumers and producers using different protocols. |
53+
| [Logstash](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/logstash) | This tutorial will walk you through integrating Logstash with Kafka-enabled Event Hubs using Logstash Kafka input/output plugins. |
54+
| [MirrorMaker](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/mirror-maker) | This tutorial shows how an event hub and Kafka MirrorMaker can integrate an existing Kafka pipeline into Azure by mirroring the Kafka input stream in the Event Hubs service. |
55+
| [NiFi](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/nifi) | This tutorial will show how to connect Apache NiFi to an Event Hubs namespace. |
56+
| [OAuth](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/oauth) | Quickstarts show you how to create and connect to an Event Hubs Kafka endpoint using an example producer and consumer written in Go and Java programming languages. |
57+
| [Confluent's Schema Registry](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/schema-registry) | This tutorial will walk you through integrating Schema Registry and Event Hubs for Kafka. |
58+
| [Spark](https://github.com/Azure/azure-event-hubs-for-kafka/tree/master/tutorials/spark) | This tutorial will show how to connect your Spark application to an event hub without changing your protocol clients or running your own Kafka clusters. |
59+
60+
### Tutorials in DOCS
61+
Also, see the tutorial: [Process Apache Kafka for Event Hubs events using Stream analytics](event-hubs-kafka-stream-analytics.md) in this content set, which shows how to stream data into Event Hubs and process it with Azure Stream Analytics.
62+
63+
## How-to guides
64+
See the following How-to guides in our documentation:
65+
66+
| Article | Description |
67+
| ------- | ----------- |
68+
| [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md) | Shows how to mirror a Kafka broker in an event hub using Kafka MirrorMaker. |
69+
| [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md) | Walks you through connecting your Spark application to Event Hubs for real-time streaming. |
70+
| [Connect Apache Flink to an event hub](event-hubs-kafka-flink-tutorial.md) | Shows you how to connect Apache Flink to an event hub without changing your protocol clients or running your own clusters. |
71+
| [Integrate Apache Kafka Connect with a event hub (Preview)](event-hubs-kafka-connect-tutorial.md) | Walks you through integrating Kafka Connect with an event hub and deploying basic FileStreamSource and FileStreamSink connectors. |
72+
| [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md) | Shows you how to connect Akka Streams to an event hub without changing your protocol clients or running your own clusters. |
73+
| [Use the Spring Boot Starter for Apache Kafka with Azure Event Hubs](/azure/java/spring-framework/configure-spring-cloud-stream-binder-java-app-kafka-azure-event-hub) | Demonstrates how to configure a Java-based Spring Cloud Stream Binder created with the Spring Boot Initializer to use Apache Kafka with Azure Event Hubs. |
74+
75+
## Next steps
76+
Review samples in the GitHub repo [azure-event-hubs-for-kafka](https://github.com/Azure/azure-event-hubs-for-kafka) under quickstart and tutorials folders.
77+

articles/event-hubs/event-hubs-for-kafka-ecosystem-overview.md

Lines changed: 1 addition & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -90,16 +90,6 @@ Here is the list of Kafka features that are not yet supported:
9090
* Kafka Streams
9191

9292
## Next steps
93-
94-
This article provided an introduction to Event Hubs for Kafka. To learn more, see the following links:
95-
96-
- [How to create an event hub](event-hubs-create.md)
97-
- [Stream into Event Hubs from your Kafka applications](event-hubs-quickstart-kafka-enabled-event-hubs.md)
98-
- [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md)
99-
- [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md)
100-
- [Connect Apache Flink to an event hub](event-hubs-kafka-flink-tutorial.md)
101-
- [Integrate Kafka Connect with an event hub](event-hubs-kafka-connect-tutorial.md)
102-
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
103-
- [Explore samples on our GitHub](https://github.com/Azure/azure-event-hubs-for-kafka)
93+
This article provided an introduction to Event Hubs for Kafka. To learn more, see [Apache Kafka developer guide for Azure Event Hubs](apache-kafka-developer-guide.md).
10494

10595

articles/event-hubs/event-hubs-kafka-akka-streams-tutorial.md

Lines changed: 4 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,13 @@ description: This article provides information on how to connect Akka Streams to
44
services: event-hubs
55
documentationcenter: ''
66
author: ShubhaVijayasarathy
7-
manager: timlt
87
editor: ''
98

109
ms.assetid: ''
1110
ms.service: event-hubs
1211
ms.devlang: na
13-
ms.topic: article
14-
ms.custom: seodec18
15-
ms.date: 12/06/2018
12+
ms.topic: how-to
13+
ms.date: 04/02/2020
1614
ms.author: shvija
1715

1816
---
@@ -137,22 +135,11 @@ If the event hub has events (for instance, if your producer is also running), th
137135
Check out the [Akka Streams Kafka Guide](https://doc.akka.io/docs/akka-stream-kafka/current/home.html) for more detailed information about Akka Streams.
138136

139137
## Next steps
140-
In this tutorial, you learned how to connect Akka Streams to the event hub without changing your protocol clients or running your own clusters. Azure Event Hubs for the Kafka supports [Apache Kafka version 1.0.](https://kafka.apache.org/10/documentation.html). You did the following actions as part of this tutorial:
138+
To learn more about Event Hubs for Kafka, see the following articles:
141139

142-
> [!div class="checklist"]
143-
> * Create an Event Hubs namespace
144-
> * Clone the example project
145-
> * Run Akka Streams producer
146-
> * Run Akka Streams consumer
147-
148-
To learn more about Event Hubs and Event Hubs for Kafka, see the following topic:
149-
150-
- [Learn about Event Hubs](event-hubs-what-is-event-hubs.md)
151-
- [Event Hubs for Apache Kafka](event-hubs-for-kafka-ecosystem-overview.md)
152-
- [How to create an event hub](event-hubs-create.md)
153-
- [Stream into Event Hubs from your Kafka applications](event-hubs-quickstart-kafka-enabled-event-hubs.md)
154140
- [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md)
155141
- [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md)
156142
- [Connect Apache Flink to an event hub](event-hubs-kafka-flink-tutorial.md)
157143
- [Integrate Kafka Connect with an event hub](event-hubs-kafka-connect-tutorial.md)
158144
- [Explore samples on our GitHub](https://github.com/Azure/azure-event-hubs-for-kafka)
145+
- [Apache Kafka developer guide for Azure Event Hubs](apache-kafka-developer-guide.md)

articles/event-hubs/event-hubs-kafka-connect-tutorial.md

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,9 @@ description: This article provides information on how to use Apache Spark with A
44
services: event-hubs
55
documentationcenter: .net
66
author: ShubhaVijayasarathy
7-
manager: timlt
87
ms.service: event-hubs
9-
ms.topic: tutorial
10-
ms.custom: seodec18
11-
ms.date: 12/06/2018
8+
ms.topic: how-to
9+
ms.date: 04/02/2020
1210
ms.author: shvija
1311

1412
---
@@ -155,14 +153,11 @@ Kafka Connect creates Event Hub topics to store configurations, offsets, and sta
155153

156154
## Next steps
157155

158-
To learn more about Event Hubs and Event Hubs for Kafka, see the following topic:
156+
To learn more about Event Hubs for Kafka, see the following articles:
159157

160-
- [Learn about Event Hubs](event-hubs-what-is-event-hubs.md)
161-
- [Event Hubs for Apache Kafka](event-hubs-for-kafka-ecosystem-overview.md)
162-
- [How to create an event hub](event-hubs-create.md)
163-
- [Stream into Event Hubs from your Kafka applications](event-hubs-quickstart-kafka-enabled-event-hubs.md)
164158
- [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md)
165159
- [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md)
166160
- [Connect Apache Flink to an event hub](event-hubs-kafka-flink-tutorial.md)
167-
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
168161
- [Explore samples on our GitHub](https://github.com/Azure/azure-event-hubs-for-kafka)
162+
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
163+
- [Apache Kafka developer guide for Azure Event Hubs](apache-kafka-developer-guide.md)

articles/event-hubs/event-hubs-kafka-flink-tutorial.md

Lines changed: 5 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,8 @@ author: ShubhaVijayasarathy
77
manager: timlt
88

99
ms.service: event-hubs
10-
ms.topic: article
11-
ms.custom: seodec18
12-
ms.date: 12/06/2018
10+
ms.topic: how-to
11+
ms.date: 04/02/2020
1312
ms.author: shvija
1413

1514
---
@@ -121,22 +120,11 @@ If the event hub has events (for example, if your producer is also running), the
121120
Check out [Flink's Kafka Connector Guide](https://ci.apache.org/projects/flink/flink-docs-stable/dev/connectors/kafka.html) for more detailed information about connecting Flink to Kafka.
122121

123122
## Next steps
124-
In this tutorial, your learned how to connect Apache Flink to Event Hubs without changing your protocol clients or running your own clusters. You performed the following steps as part of this tutorial:
123+
To learn more about Event Hubs for Kafka, see the following articles:
125124

126-
> [!div class="checklist"]
127-
> * Create an Event Hubs namespace
128-
> * Clone the example project
129-
> * Run Flink producer
130-
> * Run Flink consumer
131-
132-
To learn more about Event Hubs and Event Hubs for Kafka, see the following topic:
133-
134-
- [Learn about Event Hubs](event-hubs-what-is-event-hubs.md)
135-
- [Event Hubs for Apache Kafka](event-hubs-for-kafka-ecosystem-overview.md)
136-
- [Create an event hub](event-hubs-create.md)
137-
- [Stream into Event Hubs from your Kafka applications](event-hubs-quickstart-kafka-enabled-event-hubs.md)
138125
- [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md)
139126
- [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md)
140127
- [Integrate Kafka Connect with an event hub](event-hubs-kafka-connect-tutorial.md)
141-
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
142128
- [Explore samples on our GitHub](https://github.com/Azure/azure-event-hubs-for-kafka)
129+
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
130+
- [Apache Kafka developer guide for Azure Event Hubs](apache-kafka-developer-guide.md)

articles/event-hubs/event-hubs-kafka-mirror-maker-tutorial.md

Lines changed: 5 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,8 @@ author: ShubhaVijayasarathy
77
manager: timlt
88

99
ms.service: event-hubs
10-
ms.topic: conceptual
11-
ms.custom: seodec18
12-
ms.date: 12/06/2018
10+
ms.topic: how-to
11+
ms.date: 04/02/2020
1312
ms.author: shvija
1413

1514
---
@@ -124,23 +123,11 @@ See the following samples on GitHub:
124123
- [Azure Event Hubs Kafka MirrorMaker running on an Azure Container Instance](https://github.com/djrosanova/EventHubsMirrorMaker)
125124

126125
## Next steps
126+
To learn more about Event Hubs for Kafka, see the following articles:
127127

128-
In this tutorial, you learn how to:
129-
> [!div class="checklist"]
130-
> * Create an Event Hubs namespace
131-
> * Clone the example project
132-
> * Set up a Kafka cluster
133-
> * Configure Kafka MirrorMaker
134-
> * Run Kafka MirrorMaker
135-
136-
To learn more about Event Hubs and Event Hubs for Kafka, see the following topic:
137-
138-
- [Learn about Event Hubs](event-hubs-what-is-event-hubs.md)
139-
- [Event Hubs for Apache Kafka](event-hubs-for-kafka-ecosystem-overview.md)
140-
- [How to create an event hub](event-hubs-create.md)
141-
- [Stream into Event Hubs from your Kafka applications](event-hubs-quickstart-kafka-enabled-event-hubs.md)
142128
- [Connect Apache Spark to an event hub](event-hubs-kafka-spark-tutorial.md)
143129
- [Connect Apache Flink to an event hub](event-hubs-kafka-flink-tutorial.md)
144130
- [Integrate Kafka Connect with an event hub](event-hubs-kafka-connect-tutorial.md)
145-
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
146131
- [Explore samples on our GitHub](https://github.com/Azure/azure-event-hubs-for-kafka)
132+
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
133+
- [Apache Kafka developer guide for Azure Event Hubs](apache-kafka-developer-guide.md)

articles/event-hubs/event-hubs-kafka-spark-tutorial.md

Lines changed: 6 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,8 @@ documentationcenter: .net
66
author: ShubhaVijayasarathy
77
manager: timlt
88
ms.service: event-hubs
9-
ms.topic: tutorial
10-
ms.custom: seodec18
11-
ms.date: 12/06/2018
9+
ms.topic: how-to
10+
ms.date: 04/02/2020
1211
ms.author: shvija
1312

1413
---
@@ -96,24 +95,12 @@ df.writeStream
9695

9796

9897
## Next steps
98+
To learn more about Event Hubs and Event Hubs for Kafka, see the following articles:
9999

100-
In this tutorial, you learned how to stream using the Spark-Kafka connector and Event Hubs for Kafka. You took the following steps:
101-
102-
> [!div class="checklist"]
103-
> * Create an Event Hubs namespace
104-
> * Clone the example project
105-
> * Run Spark
106-
> * Read from Event Hubs for Kafka
107-
> * Write to Event Hubs for Kafka
108-
109-
To learn more about Event Hubs and Event Hubs for Kafka, see the following topic:
110-
111-
- [Learn about Event Hubs](event-hubs-what-is-event-hubs.md)
112-
- [Event Hubs for Apache Kafka](event-hubs-for-kafka-ecosystem-overview.md)
113-
- [Create an event hub](event-hubs-create.md)
114-
- [Stream into Event Hubs from your Kafka applications](event-hubs-quickstart-kafka-enabled-event-hubs.md)
115100
- [Mirror a Kafka broker in an event hub](event-hubs-kafka-mirror-maker-tutorial.md)
116101
- [Connect Apache Flink to an event hub](event-hubs-kafka-flink-tutorial.md)
117102
- [Integrate Kafka Connect with an event hub](event-hubs-kafka-connect-tutorial.md)
118-
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
119103
- [Explore samples on our GitHub](https://github.com/Azure/azure-event-hubs-for-kafka)
104+
- [Connect Akka Streams to an event hub](event-hubs-kafka-akka-streams-tutorial.md)
105+
- [Apache Kafka developer guide for Azure Event Hubs](apache-kafka-developer-guide.md)
106+

0 commit comments

Comments
 (0)