Service Bus: Client Identifier Support

[jsquire]

Summary

When creating one of the Service Bus client types, it can be useful for a host application to be able to uniquely identify the client instance. The Service Bus service also supports setting the identifier of an AMQP link, which it will associate with some error messages to make it easier to correlate errors with a given client instance.

Scope of Work

• The options for each Service Bus client type (sender, receiver, processor) should be extended with a string-based Identifier property, defaulting to null if not supplied by callers.

• The Service Bus client types should be extended with an Identifier property, mapping to the Identifer received as part of their client options. If the options do not specify an identifier, a unique one should be generated.

• When opening an AMQP link for receiving, the identifier should be added to a link property named com.microsoft:receiver-name so that it can be used by the service with error messages. (example)

• When opening an AMQP link for receiving, the identifier should be used as the Target in the link settings if doing so us supported by the transport. (example)

• When opening an AMQP link for sending, the identifier should be used as the Source in the link settings if doing so is supported by the transport. (example)

• There should be no change to the logic when opening an AMQP RequestResponse link for management purposes; the identifier is not supported in this context.

Success Criteria

• The API changes have been informally reviewed by the language architects and approved.

• The client options identified in the scope have been enhanced to include an Identifier property.

• The client types identifier in the scope have been enhanced to accept the identifier from the options, expose it via an Identifier property, and make use of it when creating links.

• The tests necessary for ensuring the feature works as intended have been created or adjusted and pass reliably.

• Existing tests continue to produce deterministic results and pass reliably.

References and Related

• Add client id as identifier to client and link