/azure-service-bus

name: azure-service-bus
description: Expert knowledge for Azure Service Bus development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when securing with Entra/SAS, configuring queues/topics, using sessions/forwarding, JMS/AMQP integration, or geo-DR, and other Azure Service Bus related development tasks. Not for Azure Event Hubs (use azure-event-hubs), Azure Queue Storage (use azure-queue-storage), Azure Notification Hubs (use azure-notification-hubs), Azure Relay (use azure-relay).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-01"
  generator: "docs2skills/1.0.0"

Azure Service Bus Skill

This skill provides expert guidance for Azure Service Bus. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

> **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file

> **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

This skill requires **network access** to fetch documentation content:

• **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.
• **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.

Category Index

| Category | Lines | Description | |----------|-------|-------------| | Troubleshooting | L37-L46 | Diagnosing and fixing Service Bus issues: AMQP errors, SDK/Resource Manager exceptions, legacy error codes, and tracing end-to-end operations for debugging. | | Best Practices | L47-L61 | Designing reliable, high-performance Service Bus messaging: message design, filters, locks/settlement, duplicate detection, prefetch, timeouts/retries, metrics, and maintenance to avoid loss/duplicates. | | Decision Making | L62-L71 | Guidance for choosing Service Bus vs other messaging options, selecting tiers and SDKs, and planning geo-disaster recovery and migrations (Standard→Premium) for your workloads. | | Architecture & Design Patterns | L72-L82 | Patterns for designing resilient, geo-replicated, multi-namespace, and partitioned Service Bus architectures, including federation, autoforwarding chains, and message replication with NServiceBus. | | Limits & Quotas | L83-L90 | Details on Service Bus quotas, metrics, throttling limits, and FAQs about capacity, message size, throughput, and how throttling behaves and is reported. | | Security | L91-L115 | Securing Service Bus with Entra ID, SAS, keys, TLS, networking (VNet, Private Link, firewalls), policies, compliance, and best practices for auth, encryption, and secure access. | | Configuration | L116-L142 | Configuring Service Bus behavior: scaling, partitioning, sessions, forwarding, TTL/dead-lettering, filters/actions, AMQP/HTTP settings, monitoring, automation, and local emulation. | | Integrations & Coding Patterns | L143-L155 | Patterns and code for integrating Service Bus with JMS (1.1/2.0), ActiveMQ, RabbitMQ, Event Grid, Logic Apps, Functions, plus batch message deletion and interoperability over AMQP. | | Deployment | L156-L165 | Deploying Service Bus namespaces and entities (queues, topics, subscriptions, rules) using ARM/Bicep templates, and moving namespaces across Azure regions. |

Troubleshooting

| Topic | URL | |-------|-----| | Troubleshoot AMQP errors in Azure Service Bus | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-troubleshoot | | Trace and diagnose end-to-end Azure Service Bus operations | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-end-to-end-tracing | | Interpret legacy Azure Service Bus messaging errors | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-exceptions | | Handle Azure Service Bus messaging exceptions (current SDK) | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-exceptions-latest | | Diagnose Azure Service Bus Resource Manager exceptions | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-exceptions | | Diagnose and fix common Azure Service Bus issues | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-troubleshooting-guide |

Best Practices

| Topic | URL | |-------|-----| | Configure duplicate message detection in Service Bus | https://learn.microsoft.com/en-us/azure/service-bus-messaging/duplicate-detection | | Retrieve and use Service Bus message count metrics | https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-counters | | Use sequencing and timestamps in Service Bus messages | https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sequencing | | Handle message locks and settlement in Service Bus | https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-transfers-locks-settlement | | Prepare Service Bus namespaces for planned maintenance | https://learn.microsoft.com/en-us/azure/service-bus-messaging/prepare-for-planned-maintenance | | Define and apply Service Bus subscription filters | https://learn.microsoft.com/en-us/azure/service-bus-messaging/