AI agents: use the documentation index at llms.txt to locate machine-readable pages. This section is indexed by https://docs.particular.net/nservicebus/llms.txt. The markdown version of this page is served as plain text. An MCP server at /mcp serves the same content via the search_docs and read_doc tools; it is read-only and needs no credentials. Markdown versions of documentation pages are available by appending .md to the page URL. Directory URLs use index.md. They are served as text/plain because some retrieval backends reject text/markdown.

Upgrade from ServiceControl.Plugin.NsbX.SagaAudit to NServiceBus.SagaAudit

Connecting to ServiceControl

The NServiceBus.SagaAudit package replaces the ServiceControl.Plugin.Nsb5.SagaAudit and ServiceControl.Plugin.Nsb6.SagaAudit packages. It also introduces a new version compatible with NServiceBus version 7.

To update, remove the deprecated package and install the NServiceBus.SagaAudit package.

Uninstall-Package ServiceControl.Plugin.Nsb6.SagaAudit
Install-Package NServiceBus.SagaAudit -Version 2.0.0

Configuration

The deprecated packages allowed configuration of the ServiceControl queue via a convention in which an application setting ServiceControl/Queue was picked up automatically. The new package requires explicit configuration. When upgrading, the following code needs to be added to the endpoint configuration code to retrieve the ServiceControl queue from the configuration file and pass it to the plugin.

var endpointConfiguration = new EndpointConfiguration("MyEndpoint");

var setting = ConfigurationManager.AppSettings["ServiceControl/Queue"];

endpointConfiguration.AuditSagaStateChanges(
    serviceControlQueue: setting);

Related Articles