> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Hub extractor

> Learn how to use the Cognite Event Hub extractor to connect to Azure Event Hub and extract data using the AMQP protocol.Cognite hosts the Event Hub extractor, so you don't have to download or install anything.

## Before you start

* Assign [access capabilities](/cdf/access/guides/capabilities#cognite-event-hub-extractor) to *create* an Event Hub extractor and for the extractor to *write* data points, time series, events, RAW rows, and instances in data models in the target CDF project.

<Tip>
  You can use OpenID Connect and your existing identity provider (IdP) framework to manage access to CDF data securely. [Read more](/cdf/integration/guides/extraction/admin_oidc).
</Tip>

## Deploy the extractor

<Steps>
  <Step title="Navigate to extractors">
    Navigate to <span class="ui-element">Data fusion</span> > <span class="ui-element">Integrate</span> > <span class="ui-element">Extractors</span>.
  </Step>

  <Step title="Set up the extractor">
    Locate the **Cognite Event Hub extractor** and select **Set up extractor**.
  </Step>

  <Step title="Get the connection string">
    Get a connection string that you'll need to set up the Event Hub extractor:

    1. Locate your Event Hub in Azure.
    2. Navigate to <span class="ui-element">Hub Settings</span> > <span class="ui-element">Built-in endpoints</span> > <span class="ui-element">Event Hub compatible endpoint</span>.
  </Step>
</Steps>

Typically, it's sufficient to create a single **job** per Event Hub **source**. An Event Hub is equivalent to a single **topic** on other streaming platforms. You can't filter data received from an Event Hub.

<Tip>
  When you connect to an Event Hub, you specify a **ConsumerGroup**. We recommend to create a new consumer group for each application that reads from your Event Hub.
</Tip>

## Message formats

<span class="ui-element">Azure Event Hub</span> is a data streaming service on Azure that supports payloads in any format. The <span class="ui-element">Cognite Event Hub extractor</span> supports several [predefined message formats](/cdf/integration/guides/extraction/hosted_extractors/hosted_extractors_mappings). If you want to define your own custom mapping of Event Hub messages, see [custom data formats for hosted extractors](/cdf/integration/guides/extraction/hosted_extractors/hosted_extractors_custom_mappings).
Custom formats used with Event Hub jobs will receive an `input` argument containing the message in a JSON format.