AzureSender Section

The "AzureSender" section provides configuration settings for a native Azure EventHubs client. The Azure EventHubs namespace must have been set up previously with individual Event Hubs defined for each topic to be used.

"AzureSender" : {
  "EventHubsNamespace" : "<event-hubs-connection-namespace>",
  "NumberOfSenders": 3,
  "Authentication" : {
    "Type" : "AzureClientSecret",
    "TenantId" : "<azure-ad-tenant-id>",
    "ClientId" : "<azure-ad-client-id>",
    "ClientSecret" : "<azure-ad-client-secret>" }

The "AzureSender" parameters are listed in the following table.

Parameter Description
EventHubsNamespace The fully‑qualified namespace for the EventHubs Namespace. (Not required if the Authentication parameter is "ConnectionString".)
NumberOfSenders

The number of events able to be sent to an EventHub simultaneously. The optimum number of senders is determined by the partition count of an EventHub and also the distribution of EventHubs.

If all events are being sent to the same EventHub, setting the number of senders to more than the partition count may not improve performance. The NumberOfSenders parameter value must be in the range 1 through 32 (inclusive). The default value is 1.
Authentication

The AzureSender section Authentication parameter Type can be one of the following.

  • ConnectionString

  • AzureLogin

  • AzureClientSecret

  • AzureEnvironment

  • AzureManagedIdentity

  • SharedAccessKey

For details, see "Type‑Specific Parameters", later in this chapter.

An example of the "ConnectionString" parameter is as follows.

"AzureSender" : {
  "EventHubsNamespace" : "<event-hubs-connection-namespace>",
  "NumberOfSenders": 3,
  "Authentication" : {
    "Type" : "ConnectionString", 
    "ConnectionString" : "Endpoint=sb://myeventhubs.servicebus.windows.net/;
                         SharedAccessKeyName=RootManageSharedAccessKey;
                         SharedAccessKey=abc123..." }