Configure the Azure Event Hubs target

Complete the procedure below to configure the Azure Event Hubs target and test your connection to Azure Event Hubs.

Create the Azure Event Hubs. Create or identify the Azure Event Hubs shared access policy for PI Integrator for Business Analytics. The minimum permissions required is Send.

1. On the Administration page, click the Targets tab. Then select the target in the Publish Targets list.

   Note: If you have already selected your target, skip to the next step.

2. Retrieve the Azure Event Hubs connection string. The connection string format is shown below:

   Endpoint=sb://<NamespaceName>.servicebus.windows.net/;SharedAccessKeyName=<KeyName>;SharedAccessKey=<KeyValue>;EntityPath=<EventHubName>

   Note: This connection string is sourced from the Event Hub itself, not the Event Hubs parent Service Bus (which also has its own ConnectionString and is unsupported by the PI Integrator).

3. Configure the Azure Event Hubs with the following parameters:

   Parameter	Description
   Endpoint	The endpoint of the Event Hub which data is published to; this is the Endpoint value in the Event Hub connection string. Note: Ensure the entire string starts with "sb://" and the ending ".servicebus.windows.net" is used as the input.
   Shared Access Key Name	Used in combination with Shared Access Key to connect to the Event Hub. This is the SharedAccessKeyName value in the Event Hub connection string.
   Shared Access Key	Primary or secondary key of the Event Hub that is used in combination with Shared Access Key Name to connect to the Event Hub. This is the SharedAccessKey value in the Event Hub connection string.
   Entity Path	The Event Hub entity which data will be published to; this is the EntityPath value in the Event Hub connection string.
   Character Encoding	Character set in which data is encoded. Default: UTF-8. Other options are ASCII, UTF-7, UTF-32, and Unicode.

   The following screen capture shows where to find these parameters in Microsoft Azure Portal.

   

   Note: An existing Azure shared access policy for the Event Hubs that meets the minimum permissions may be used, or a new shared access policy can be created for this purpose. With subsequent portal updates, the screen may look different and the parameters may be located elsewhere.

4. Click Verify Event Hub Writer to verify that the Event Hubs is valid.

5. Click Save Changes.

6. Give users access to the Azure Event Hubs target. For more information, see Grant access to targets.