Microsoft Azure extension overview
In Microsoft Azure, Event Hubs is a highly scalable, real-time data ingress service that allows you to process and analyze the massive amounts of data produced by your connected devices and applications. Once data is collected into an event hub, it can be transformed and stored using any real-time analytics provider or batching/storage adapters.
The Microsoft Azure event forwarding extension leverages Event Hubs to send events from the Adobe Experience Platform Edge Network to Azure for further processing. This guide covers how to install the extension and employ its capabilities in an event forwarding rule.
Prerequisites
In order to use this extension, you must have a valid Azure account with access to Event Hubs. You must also create an event hub using the Azure portal before following the steps below.
Install the extension
To install the Microsoft Azure extension, navigate to the Data Collection UI or Experience Platform UI and select Event Forwarding from the left navigation. From here, select a property to add the extension to, or create a new property instead.
Once you have selected or created the desired property, select Extensions in the left navigation, then select the Catalog tab. Search for the Microsoft Azure card, then select Install.
Since the extension does not have any configuration properties, it is immediately added to the list of installed extensions. You can now start using Event Hub action types when configuring event forwarding rules.
Configure an event forwarding rule rule
Start creating a new event forwarding rule and configure its conditions as desired. When selecting the actions for the rule, select Microsoft Azure for the extension, then select Send Data to Event Hubs for action type.
The right panel updates to show configuration options for how the data should be sent. Specifically, you must assign data elements to the various properties that represent your Event Hub configuration.
Event Hub Details
Data
When finished, select Keep Changes to add the action to the rule configuration. When you are satisfied with the rule, select Save to Library.
Finally, publish a new event forwarding build to enable the changes to the library.
Next steps
This guide covered how to send data to Event Hubs using the Microsoft Azure event forwarding extension. For more information on event forwarding capabilities in Experience Platform, refer to the event forwarding overview.
Appendix: Obtain SAS authorization values sas
External applications are granted access to Event Hubs through shared access signatures (SAS). Each Event Hubs namespace and event hub instance has a default SAS authorization rule automatically assigned on creation, but you can also create additional policies for each resource if you wish.
When configuring an event forwarding rule using the Azure extension, you must provide the name and the primary key for the authorization rule governing the namespace or specific event hub you want to send data to. For details on how to obtain these values from the Azure portal, refer to the following sections in the Azure documentation:
Once you have the required values, the authorization rule name can be provided directly as a string in the config input or you can create a string-type data element to reference it instead. The primary key, however, must first be contained inside of an event forwarding secret before it can be supplied in the rule configuration in order to protect your data security.
Within the event forwarding UI, create a new secret and select Token as the secret type. For the token value itself, provide the primary key you copied earlier. After creating the secret, create a data element with the type Secret and select the Event Hubs secret from the list. Once the secret data element has been set up, you can reference that data element in the SAS Access Key field.