如何用C#通过Azure Service Bus .NET SDK读取主题及订阅的死信数量

核心限制说明 #

• Azure Monitor为Service Bus提供了Incoming、Outgoing、Active等多项消息指标，可查询全局总消息数
• DeadletteredMessages 死信指标仅支持按EntityName（队列或主题）维度获取计数，原生不支持订阅级别的指标查询

实测可行解决方案 #

以下两种方案均可稳定获取订阅级别的死信及各类消息计数，满足监控需求：

方法1：使用Azure Resource Graph批量查询 #

无需额外开发，可直接在Azure门户的Resource Graph Explorer中运行以下Kusto查询，一次性拉取全量订阅的消息计数：

resources
| where type == "microsoft.servicebus/namespaces/topics/subscriptions"
| extend 
    deadLetterCount = properties.countDetails.deadLetterMessageCount,
    activeCount = properties.countDetails.activeMessageCount,
    topicName = split(id, '/')[8],
    namespaceName = split(id, '/')[6]
| project namespaceName, topicName, subscriptionName = name, deadLetterCount, activeCount

• 适用场景：批量统计所有Service Bus的主题、订阅消息计数，快速排查死信异常
• 数据时效性：准实时，延迟通常小于1分钟

方法2：调用Service Bus管理SDK/API（适合自定义监控集成） #

如果需要将计数能力嵌入自研监控、告警系统，可直接调用Service Bus的管理接口拉取指定订阅的明细计数，以C# SDK为例，核心代码如下：

// 引用Azure.Messaging.ServiceBus NuGet包
var adminClient = new ServiceBusAdministrationClient("<你的Service Bus连接字符串>");
var subscriptionInfo = await adminClient.GetSubscriptionAsync("<目标主题名>", "<目标订阅名>");

// 直接获取各类消息计数
var deadLetterCount = subscriptionInfo.Value.CountDetails.DeadLetterMessageCount;
var activeMessageCount = subscriptionInfo.Value.CountDetails.ActiveMessageCount;
var scheduledMessageCount = subscriptionInfo.Value.CountDetails.ScheduledMessageCount;

• 适用场景：自定义监控埋点、触发式告警规则、专属监控大盘开发
• 注意事项：请合理控制接口调用频率，避免触发Service Bus限流规则

补充说明 #

两种方案均避开了Azure Monitor的指标维度限制，获取的计数数据与Service Bus门户展示的订阅级数据完全一致
如果需要统计队列级别的消息计数，可直接调整Resource Graph查询的资源类型，或调用队列的管理接口即可实现

内容的提问来源于stack exchange，提问作者Samadhan