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

The experimental queue length metrics feature based on an estimation algorithm has been replaced by the native queue length metric. This document describes the migration path for systems using the old metrics.

Upgrading the monitoring instance

ServiceControl should be upgraded to version 1.48.0+. Upgrading endpoints first will prevent old monitoring instance versions from processing new, unsupported metric reports. Also, new monitoring instances produce WARN log entries when receiving legacy queue length reports:

Legacy queue length report received from instance of .

That enables identification of the endpoints running NServiceBus.Metrics.ServiceControl packages that do not support the native queue length metric.

Upgrading ServicePulse

ServicePulse should be upgraded to the latest version. This step ensures compatibility with the updated version of the monitoring instance and ServicePulse.

Upgrading endpoints

All endpoints that send monitoring data must be upgraded to the latest version of NServiceBus.Metrics.ServiceControl. The exact version depends on the NServiceBus endpoint's version. The table below shows the version ranges.

NServiceBusNServiceBus.Metrics.ServiceControl
5.*[1.3.0, 2.0)
6.*[2.1.0, 3.0)
7.*[3.0,)

In this article