Getting Started
Architecture
NServiceBus
Transports
Persistence
ServiceInsight
ServicePulse
ServiceControl
Monitoring
Samples

Selecting a transport

This document provides guidance for deciding which transport may best suit a specific scenario.

This guide does not provide definitive answers for all scenarios. Every decision has trade-offs, some of which are described in the documentation for each transport. If it is unclear what the best choice is, or there are very specific constraints, contact Particular Software.

Broker versus federated

The queueing technologies behind most transports take the form of a central message broker that handles physical message routing. The transports which use these queueing technologies rely on the broker to send and receive messages. It is important that the broker be highly available. If it cannot be reached, the system will be unable to send or receive messages. Note that, although a broker is involved, this is still a "bus" architecture and not a "broker" architecture. See bus versus broker architecture for a discussion on the distinction.

Other queueing technologies are "federated" and deployed on every machine that sends or receives messages. The only supported transport using federated queueing technology is MSMQ. The MSMQ transport uses a "store and forward" delivery strategy. When a message is sent, it is stored locally and delivered to the remote machine only when that machine is reachable. That means messages can be sent even if the remote machine is unreachable, although they won’t be delivered until the remote machine is reachable.

Supported transports

Each of the following sections describes the advantages and disadvantages of each supported transport and some reasons for choosing that transport.

For transports that use a cloud hosted queueing technology the quality of the network connection between the applications and cloud provider is important. If the connection is problematic, it may not be possible to send messages. For example, this may result in problems capturing data from a user interface. If applications are running the same data centre as the queueing technology, this risk is mitigated.

This is a basic flowchart for selecting a supported transport. Where more than one transport is listed, refer to the sections below. They describe the advantages and disadvantages of each transport in more detail.

graph TD S((Start))-->Q{<center>Targeting<br/>the cloud?</center>} Q-->|Yes|Y{<center>Preferred<br/>cloud provider?</center>} Q-->|No|N{<center>Is interop<br/>with existing<br/>systems needed?</center>} Y-->|Azure/no preferences|Y1[<center>Azure Service Bus/<br/>Azure Storage Queues</center>] Y-->|Amazon|Y2[Amazon SQS] N-->|Yes|NY{<center>Do those systems<br/>use SQL Server?</center>} N-->|No|NN{<center>Is high message<br/>throughput, e.g.<br/>500 msg/s,<br/>expected?</center>} NY-->|Yes|NYY[SQL Server] NY-->|No|NYN[<center>RabbitMQ/<br/>SQL Server</center>] NN-->|Yes|NNY[<center>RabbitMQ</center>] NN-->|No|NNN{<center>Is business<br/>data stored<br/>in SQL Server?</center>} NNN-->|Yes|NNNY[SQL Server] NNN-->|No|NNNN[<center>RabbitMQ/<br/>SQL Server</center>]

Learning

The learning transport should not be used in production.

This transport is intended to learn how to work with NServiceBus. It does not require the installation of a queueing technology and works "out of the box". This is done by storing sent and received messages as files on disk.

Azure Service Bus

Azure provides multiple messaging technologies. One of the most advanced and reliable is Azure Service Bus.

Advantages

  • Fully managed, turn-key infrastructure
  • Ease of scaling
  • Ease of feature selection
  • Supports message transactions. Other Azure queueing technologies do not
  • Up to 100MB message size on the Premium tier. See Large messages support for more information
  • More native capabilities, such as delayed message delivery, which requires an outbox when using some other transports

Disadvantages

  • Requires careful monitoring of costs, although the transport does provide features for throttling throughput
  • On-premises development and testing is not possible
  • Message processing time is limited to 5 minutes
  • Relies on TCP, which may require opening additional ports in a firewall

When to select this transport

  • When the application is running on Windows Azure
  • For enterprise messaging features such as additional reliability
  • When messages are too large for Azure Storage Queues
  • When elastic scaling is required

Azure Storage Queues

Azure Storage Queues has fewer features than Azure Service Bus but can be more cost effective.

Advantages

  • Fully managed, turn-key infrastructure
  • Can store a very large number of messages (up to the 200 TB limit of the related Azure Storage account), although this should not be required in most scenarios
  • Low price per message
  • High level of availability

Disadvantages

  • The size of a single message is limited to 64 KB including headers and body. NServiceBus uses headers for metadata, which could consume a lot of the message overall size.
  • Atomic message receive and data manipulation requires an outbox.
  • Does not offer a native publish-subscribe mechanism. A database is required for storing event subscriptions (via NServiceBus persistence). Explicit routing for publish/subscribe must also be specified.
  • Significant latency when receiving messages, due to polling over HTTP for new messages.

When to select this transport

  • When the application is running on Windows Azure and the additional features of Azure Service Bus are not worth the cost
  • When high throughput is not required
  • When scale-out is not required. Scaling out requires Azure Service Bus

SQL Server

The SQL Server transport implements queues using relational database tables. Each row of a queue table holds one message with an ID, headers, and body, plus additional columns for backward compatibility.

Advantages

  • SQL Server is already present in many organizations. This could result in lower licensing and training costs, as well as a reduction in operational risk, since the skills and knowledge required to run SQL Server are already present.
  • Mature tooling, such as SQL Server Management Studio (SSMS) and Azure Data Studio
  • Free to start with the SQL Server Express or Developer editions
  • Easy scale-out through competing consumers. Multiple instances of the same endpoint consume messages from a single queue.
  • Supports distributed transactions, allowing atomic message processing and data manipulation in database systems which also support distributed transactions (e.g. SQL Server), using the Microsoft Distributed Transaction Coordinator (MSDTC)
  • Can store both queues and business data in a single backup, making it easier to restore a system to a consistent state

Disadvantages

  • Adds pressure to the database server due to polling for new messages
  • Depending on throughput, can add significant load to an existing SQL Server installation
  • Can have significant costs in Production for high throughput systems where extra servers or cores are required to support the load
  • Inherently not designed as a messaging broker which can lead to lower performance and connection limitations when utilized for a larger system with many endpoints

When to select this transport

  • When it's not possible to introduce a native queueing technology
  • When the benefits of introducing a native queueing technology are outweighed by the cost of licensing, training, and ongoing maintenance compared with using existing SQL Server infrastructure
  • For integration with a legacy application that uses SQL Server, using database triggers
  • When the system has a small number of endpoints or a medium number of endpoints with low throughput.

PostgreSQL

Similar to SQL Server, the PostgreSQL transport implements queues using relational database tables. Each row of a queue table holds one message with an ID, headers, and body.

Advantages

  • PostgreSQL is already present in many organizations, as a relational database that doesn't have the licensing limitations of a commercial solution such as SQL Server or Oracle. This could result in lower licensing and training costs, as well as a reduction in operational risk, since the skills and knowledge required to run PostgreSQL are already present.
  • Mature tooling, such as pgAdmin and Azure Data Studio
  • Easy scale-out through competing consumers. Multiple instances of the same endpoint consume messages from a single queue.
  • Can store both queues and business data in a single backup, making it easier to restore a system to a consistent state

Disadvantages

  • Adds pressure to the database server due to polling for new messages
  • Depending on throughput, can add significant load to an existing PostgreSQL installation
  • Inherently not designed as a messaging broker which can lead to lower performance and connection limitations when utilized for a larger system with many endpoints.

When to select this transport

  • When it's not possible to introduce a native queueing technology
  • When the benefits of introducing a native queueing technology are outweighed by the cost of licensing, training, and ongoing maintenance compared with using existing PostgreSQL infrastructure
  • For integration with a legacy application that uses PostgreSQL, using database triggers
  • When the system has a small number of endpoints.

RabbitMQ

RabbitMQ is a popular message broker used with many platforms. It can be used both on-premises and in the cloud.

Advantages

  • Highly adopted, with a large community of users and contributors
  • Provides native reliability and high-availability features
  • Offers a native publish-subscribe mechanism. Does not require a database for storing event subscriptions (via NServiceBus persistence). Explicit routing for publish/subscribe is not required
  • Ease of integration with applications running on other platforms through a wide range of supported clients
  • Native support for the competing consumer pattern. Messages are received by instances in a round-robin fashion without additional configuration

Disadvantages

  • Running RabbitMQ in a cluster, which is strongly recommended, requires deeper operational knowledge of RabbitMQ. Not all companies have the same level of expertise as with other technologies, such as SQL Server. This may require additional training.
  • Doesn’t handle network partitions well; partitioning across a WAN requires the use of specific features.
  • Requires careful consideration for duplicate messages, e.g. using the outbox feature or making all endpoints idempotent.
  • Might require covering additional costs of commercial RabbitMQ license and support.

When to select this transport

  • For native integration with other platforms.
  • When RabbitMQ is already used in the organization and the benefit of introducing another queueing technology is outweighed by the cost of licenses, training, and ongoing maintenance.

Amazon SQS

This is a popular transport for systems hosted in AWS, the Amazon cloud offering.

Advantages

  • Fully managed, turn-key infrastructure
  • Automatic, elastic scaling
  • Can be used as a gateway between endpoints that cannot communicate directly with each other

Disadvantages

  • Can be expensive in a high throughput scenario
  • Less adoption on the .NET platform; can be more difficult to find relevant resources

When to select this transport

  • When the application targets AWS
  • For integration with other systems that are already running on Amazon SQS

MSMQ

The MSMQ transport uses the native Windows queueing technology, MSMQ, to send and deliver messages. MSMQ is a distributed or "federated" system consisting of multiple processes, one on each machine. The client only interacts with the local MSMQ process, which stores the messages on disk. The messages are forwarded to the remote machine in the background.

Advantages

  • Built-in component of the Windows operating system (though not installed by default)
  • Supports distributed transactions, allowing atomic message processing and data manipulation in database systems which also support distributed transactions (e.g. SQL Server), using the Microsoft Distributed Transaction Coordinator (MSDTC)
  • Uses a store and forward mechanism that allows sending messages even when the destination machine is unavailable due to network issues or other problems

Disadvantages

  • Does not offer a native publish-subscribe mechanism. A database is required for storing event subscriptions (via NServiceBus persistence). Explicit routing for publish/subscribe must also be specified.
  • Scaling out requires setting up sender-side distribution to distribute messages across the destination queues of the scaled-out instances. With a broker-based transport, all scaled-out instances communicate with the centralized broker.

When to select this transport

  • For a better guarantee that the queueing technology is available for applications to send messages
  • When running a Windows environment on-premises and unable to invest in licenses or training for other technologies
  • When distributed transactions are required to guarantee consistency of data for message handling