AI agents: use the documentation index at llms.txt to locate machine-readable pages. This section is indexed by https://docs.particular.net/persistence/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.

Performance Tuning

Target Version:
NServiceBus 7.x
Standard support for version 7.x of NServiceBus has expired. For more information see our Support Policy.

General guidelines

Microsoft's Azure Storage Performance Checklist should be considered for performance tips and design guidelines.

Opting out of the compatibility mode

By default the persister runs with the compatibility mode enabled. The consequences of that is for sagas that are correlated by the correlation property value an additional lookup by the secondary index property might happen for sagas that use a secondary index. It is possible to disable the compatibility mode by calling DisableSecondaryKeyLookupForSagasCorrelatedByProperties.

When targeting Azure Cosmos DB Table API, the saga persister secondary lookups might fail due to an empty row key. In such a case, the persister automatically falls back to do a second retrieve attempt assuming the RowKey equal to the PartitionKey. It is possible to opt-out and always assume RowKey = PartitionKey by specifying AssumeSecondaryKeyUsesANonEmptyRowKeySetToThePartitionKey

Related Articles

In this article