Getting Started


These step-by-step tutorials help you learn how to use NServiceBus. Tutorials include concepts and detailed instructions for how to build a sample project in addition to a downloadable solution with a completed example.

NServiceBus Quick Start

It is very difficult to build a distributed software system correctly from scratch. You could read all 736 pages of the Enterprise Integration Patterns book (an excellent though very dry reference) and then spend months creating, testing, and documenting a communication framework so that different services can talk to each other. Or instead, you could use a framework that incorporates all those design patterns and guides you straight into the pit of success.

NServiceBus combines decades of distributed systems design experience and expertise and distills it into one easy-to-use framework. In this tutorial, you'll see how NServiceBus takes all the grunt work out of system design by handling all of the infrastructure complexity for you, taking system design best practices like reliability, failure recovery, and extensibility and baking them right into the software, guiding you toward the pit of success.

You'll also see how the additional tools in the Particular Service Platform make it easy to manage, monitor, and debug.

NServiceBus Step-by-step

Learn the basics of NServiceBus, from sending messages between message endpoints to using publish/subscribe. In five short step-by-step lessons, you'll build a back-end for a retail e-commerce system. You'll learn how to send asynchronous messages between processes, how to use the publish/subscribe pattern to decouple business processes, and the advantages of using recoverability features to enable automatic retries after processing failures.

NServiceBus Sagas

Learn to master NServiceBus sagas to model complex, long-running business processes. Learn how to model saga data, correlate messages to sagas, use timeouts to model time in your business processes, and how to integrate with third-party systems.

Message replay

One of the most powerful features of NServiceBus is its ability to replay a message that has failed. Often, message failures are introduced by bugs that aren't found until the code is deployed. When this happens, failed messages can flood into the error queue all at once.

In this tutorial, we'll see how to use ServiceControl to monitor an NServiceBus system, and use ServicePulse to replay a failed message.

Monitoring NServiceBus demo walkthrough

This sample demonstrates the monitoring capabilities of the Particular Service Platform. It contains four sample endpoints along with the necessary platform components pre-configured to monitor or display various metrics, including the throughput rate, the processing time, and the critical time of each endpoint. Each endpoint comes with a console application to tweak certain parameters to show how it will affect the metrics.

Monitoring NServiceBus tutorial

A step-by-step guide that shows how to configure the Particular Service Platform to monitor your system.