Microsoft Azure Event Hubs

Send Airship user-level event data into Azure using our Event Hubs integration.

By integrating with Microsoft Azure Event Hubs, you can store events from your airship project in Microsoft Azure. With Azure, you can store events for long term analysis and pass data to real-time analytics providers, making it easy to take advantage of your Airship engagement data in external business intelligence platforms.

As a part of this integration, you must create an event hub to receive and store events from Airship. An event hub exists within a namespace belonging to a resource group. This setup assumes that you've already set up a resource group and a namespace to contain your Airship Real-Time Data Streaming event hub. If you have not already done so, create your resource group and namespace before you begin.

Create an Airship Event Hub

  1. Go to the Azure Portal and select Event Hubs. If Event Hubs is not in your Favorites menu, you can click All Services and find it from there.
  2. Select the namespace in which to create your Airship event hub.
  3. Select Event Hubs in your namespace page.
  4. Click Event Hub.
  5. Type a name for your event hub, then click Create. You can check the status of the event hub creation in alerts. When complete, your new event hub appears in the list.

Get Keys from your Shared Access Policy

A shared-access policy contains the keys you'll provide to Airship to authenticate with your Azure Event Hub.

  1. Go to the Azure Portal and select Event Hubs. If Event Hubs is not in your Favorites menu, you can click All Services and find it from there.
  2. In the list of event hubs, select the namespace containing your Airship event hub.
  3. Click Shared Access Policies.
  4. Select a shared access policy in the list of policies. The default policy is RootManageSharedAccessPolicy. If you add a new policy, it must have at least the send (write) permission.
  5. Copy the Policy Name and Primary Key. These are the Access Signature Key and Access Signature Key Name respectively — essentially the username and password that you will provide to Airship to authenticate with your Azure event hub.
 Note

You can also copy the Connection string-primary key, which contains both the Access Signature Key and Key Name.

Setup the Integration in Airship

Before you configure your Azure integration, you must have configured a namespace and a specific event hub to store events from Airship. To setup your Microsoft Azure Event Hub integration, you will need the Policy Name and Connection string-primary key from a shared access policy in the namespace containing your event hub.

  1. Open your messaging project in Airship and go to Settings » Real-time Data Streaming.
  2. Select Microsoft Azure.
  3. Enter a Name and Description for this integration. This will help you identify the integration later.
  4. Enter your event hub details:
    • Event Hub Namespace Name
    • Event Hub Name
    • Shared Access Signature Key Name: This is the Policy Name of a shared access policy in your Event Hub namespace.
    • Shared Access Signature Key: This is the Primary Key for your shared access policy.
  5. Select the event types you want to send to your event hub.
  6. Click Activate.