ServiceControl can be configured to use one of the supported transports listed below using the ServiceControl Management application:
- Azure Service Bus
- Azure Storage Queues
- Amazon Simple Queue Service (SQS)
- Microsoft Message Queuing (MSMQ)
- RabbitMQ - Conventional routing topology
- RabbitMQ - Direct routing topology
- SQL Server
Transport-specific features
Transport adapters
Certain transport features are not supported natively by ServiceControl and will require a transport adapter. Contact support@particular.net for further guidance.
Configuring third-party transports through the ServiceControl Management application is not supported.
MSMQ
To configure MSMQ as the transport, ensure the MSMQ service has been installed and configured as outlined in MSMQ configuration.
RabbitMQ
In addition to the connection string options of the transport the following ServiceControl specific options are available in versions 4.4 and above:
UseExternalAuthMechanism=true|false(default)
- Specifies that an external authentication mechanism should be used for client authentication.DisableRemoteCertificateValidation=true|false(default)
- Allows ServiceControl to connect to the broker even if the remote server certificate is invalid.
Azure Service Bus
In addition to the connection string options of the transport the following ServiceControl specific options are available in versions 4.4 and above:
TransportType=AmqpWebSockets
- Configures the transport to use AMQP over websockets.TopicName=
- Specifies the topic name to be used by the instance. The default value is<topic-bundle-name> bundle-1
.QueueLengthQueryDelayInterval=
- Specifies the delay between queue length refresh queries for queue length monitoring. The default value is 500 ms.<value_in_milliseconds>
As of version 4.21.8, the following options can be used to enable Managed Identity authentication:
- Setting the connection string to a fully-qualified namespace (eg.
my-namespace.
)servicebus. windows. net - With this setting, a
DefaultAzureCredential
will be used. - No connection string options can be used when using a fully-qualified namespace.
- With this setting, a
- Specifying the connection string option
Authentication=Managed Identity
- The fully-qualified namespace will be parsed from the
Endpoint=sb:/
connection string option/ my-namespace. servicebus. windows. net/ - When specifying managed identity for the connection string, a
ManagedIdentityCredential
will be used. - Set the
ClientId=some-client-id
connectionstring option to use a specific user-assigned identity
- The fully-qualified namespace will be parsed from the
SQL
In addition to the connection string options of the transport the following ServiceControl specific options are available in versions 4.4 and above:
Queue Schema=
- Specifies custom schema for the ServiceControl input queue.<schema_name> Subscriptions Table=
- Specifies SQL subscription table name.<subscription_table_name>
Amazon SQS
The following ServiceControl connection string options are available:
AccessKeyId=
- AssessKeyId value,<value> SecretAccessKey=
- SecretAccessKey value,<value> Region=
- Region transport option,<value> QueueNamePrefix=
- Queue name prefix transport option,<value> TopicNamePrefix=
- Topic name prefix transport option<value> S3BucketForLargeMessages=
- S3 bucket for large messages option,<value> S3KeyPrefix=
- S3 key prefix option.<value> DoNotWrapOutgoingMessages=true
- Do not wrap outgoing messages option.