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.

Decommissioning Endpoints

Endpoint decommissioning is the process of permanently shutting down an endpoint instance. This can be done for various reasons, such as:

  • Dividing the endpoint's responsibility among other endpoints
  • Scaling down endpoint instances
  • Other (like removing certain functionality from the system)

When decommissioning endpoints, several aspects should be considered:

  1. Routing should be adjusted to make sure that no new messages will be delivered to that endpoint.
  2. All messages in the endpoint's queue should be processed.
  3. Subscriptions for the events the endpoint receives should be removed.
  4. In NServiceBus version 7 and earlier, endpoints that use the timeout manager store timeouts that should be rerouted to other endpoint instances, if applicable. In version 8 and later, the timeout manager is removed, and any remaining timeouts can be migrated using the timeouts migration tool.
  5. If messages for the decommissioned endpoint fail, use ServicePulse redirects to retry them against another endpoint.
  6. Remove the decommissioned endpoint instances from ServicePulse. See removing endpoint instances.

In this article