Azure Event Hubs

AIRSHIP MAINTAINED INTEGRATION

This integration is maintained by Airship. Please contact Airship for support.

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.

Azure Integration Requirements

This integration requires these accounts:

  1. Azure
  2. Airship — Must include both:

Creating an Airship Event Hub

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

Getting Keys from your Shared Access Policy

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

  1. Go to the Azure Portal and select Event Hubs. If Event Hubs is not in your Favorites menu, select All Services and locate it from there.

  2. In the list of Event Hubs, select the namespace containing your Airship Event Hub.

  3. Select Shared Access Policies.

  4. Select a policy from the list. 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 that you will provide to Airship to authenticate with your Azure Event Hub.

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

Configuring 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 configure your Microsoft Azure Event Hubs integration in Airship, you will need:

  • Event Hub namespace name
  • Event Hub name
  • Shared access signature key name — This is the Policy Name of a shared access policy in the namespace containing your Event Hub.
  • Shared access signature key — This is the Connection string-primary key from a shared access policy in the namespace containing your Event Hub.

In Airship:

  1. Go to Settings.
  2. Under Project Configuration, select Manage for Partner Integrations.
  3. Select Microsoft Azure.
  4. Select Configure for the outbound integration and follow the onscreen instructions to:
    • Enter your Event Hub information.
    • Select the Airship events to send to your Event Hub.