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 using queues/topics, sessions, autoforwarding chains, JMS/RabbitMQ clients, or geo-disaster recovery, and other Azure Service Bus related development tasks. Not for Azure Event Hubs (use azure-event-hubs), Azure Relay (use azure-relay), Azure Queue Storage (use azure-queue-storage), Azure Web PubSub (use azure-web-pubsub).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","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

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 resolving Azure Service Bus errors and exceptions (AMQP, .NET, Resource Manager), configuring tracing, and fixing common messaging and connectivity issues.
Best Practices	L47-L59	Guidance on reliable, high-throughput messaging: duplicate detection, ordering/sessions, timestamps, maintenance prep, loss/duplicate prevention, serialization, prefetch, timeouts, and retries.
Decision Making	L60-L68	Guidance on choosing Service Bus vs other messaging options, configuring geo-disaster recovery/replication, Java/JMS client choices, and migrating from Standard to Premium.
Architecture & Design Patterns	L69-L78	Patterns and topologies for resilient, partitioned, and federated Service Bus architectures, including autoforwarding chains, multi-namespace designs, and message replication with NServiceBus.
Limits & Quotas	L79-L86	Service Bus message size, entity and namespace quotas, Premium large message handling, and how throttling, limits, and related behaviors affect throughput and reliability.
Security	L87-L109	Securing Service Bus: auth with Entra ID/SAS/managed identities, network isolation (VNet, Private Link, firewalls, perimeters), encryption/CMK, TLS policies, and compliance/Azure Policy.
Configuration	L110-L135	Configuring Service Bus behavior: scaling, partitions, sessions, forwarding, TTL/dead-lettering, filters/actions, monitoring/metrics, geo-replication, and management via ARM, PowerShell, and emulator.
Integrations & Coding Patterns	L136-L151	Patterns and code for integrating Service Bus with JMS (1.1/2.0), RabbitMQ, Event Grid/Logic Apps/Functions, subscription filters/actions, replication tasks, and batch message deletion.
Deployment	L152-L161	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
Configure end-to-end tracing for Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-end-to-end-tracing
Diagnose and resolve Azure Service Bus .NET exceptions	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 Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/duplicate-detection
Use sequencing and timestamps in Service Bus messages	https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sequencing
Implement FIFO and request-response with Service Bus sessions	https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sessions
Prepare Service Bus namespaces for planned maintenance	https://learn.microsoft.com/en-us/azure/service-bus-messaging/prepare-for-planned-maintenance
Prevent message loss and duplicates in Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-message-loss-and-duplicates
Handle messages and serialization in Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messages-payloads
Optimize Azure Service Bus performance and throughput	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-performance-improvements
Optimize Azure Service Bus performance with prefetch	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-prefetch
Configure Service Bus timeouts and retry policies	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-timeouts-retries

Decision Making

Topic	URL
Choose between Azure Event Grid, Event Hubs, and Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/compare-messaging-services
Decide between Azure Storage queues and Service Bus queues	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-azure-and-service-bus-queues-compared-contrasted
Set up Service Bus Geo-Disaster Recovery	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-dr
Choose between JMS and native Java SDK for Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-jms-versus-native-sdk
Migrate Azure Service Bus from Standard to Premium	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-standard-premium

Architecture & Design Patterns

Topic	URL
Build message-driven systems on Service Bus with NServiceBus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/build-message-driven-apps-nservicebus
Use autoforwarding to chain Service Bus entities	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-auto-forwarding
Design Service Bus federation and replication topologies	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-overview
Implement Service Bus message replication patterns	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-patterns
Design multi-namespace Service Bus for resilience	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-outages-disasters
Design and create partitioned Service Bus queues and topics	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-partitioning

Limits & Quotas

Topic	URL
Azure Service Bus FAQ with limits and behaviors	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-faq
Use Azure Service Bus Premium for large messages	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-premium-messaging
Reference Azure Service Bus quotas and limits	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-quotas
Understand Azure Service Bus throttling limits and behavior	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-throttling

Security

Topic	URL
Authenticate applications to Azure Service Bus with Entra ID	https://learn.microsoft.com/en-us/azure/service-bus-messaging/authenticate-application
Enable confidential computing for Service Bus Premium	https://learn.microsoft.com/en-us/azure/service-bus-messaging/confidential-computing
Configure customer-managed keys for Service Bus encryption	https://learn.microsoft.com/en-us/azure/service-bus-messaging/configure-customer-managed-key
Disable SAS local authentication for Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/disable-local-authentication
Configure network security for Azure Service Bus namespaces	https://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security
Secure Azure Service Bus with network security perimeters	https://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security-perimeter
Use built-in Azure Policy definitions for Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/policy-reference
Secure Azure Service Bus with Private Link Service	https://learn.microsoft.com/en-us/azure/service-bus-messaging/private-link-service
Apply regulatory compliance policies to Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/security-controls-policy
Configure authentication and authorization for Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-authentication-and-authorization

Configuration

Topic	URL
Configure autoscale for Service Bus messaging units	https://learn.microsoft.com/en-us/azure/service-bus-messaging/automate-update-messaging-units
Map classic Service Bus management APIs to ARM	https://learn.microsoft.com/en-us/azure/service-bus-messaging/deprecate-service-bus-management
Configure auto-forwarding for Service Bus queues and subscriptions	https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-auto-forward
Enable dead-lettering for Service Bus queues and subscriptions	https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-dead-letter
Configure duplicate message detection in Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-duplicate-detection
Enable and configure Service Bus message sessions	https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-message-sessions
Enable partitioning for Service Bus queues and topics	https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-partitions-basic-standard
Suspend and reactivate Azure Service Bus entities	https://learn.microsoft.com/en-us/azure/service-bus-messaging/entity-suspend
Use Azure Service Bus message browsing and peek operations	https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-browsing
Retrieve Service Bus queue and subscription message counts	https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-counters
Configure message expiration and TTL in Azure Service Bus

Integrations & Coding Patterns

Topic	URL
Programmatically delete Service Bus messages in batches	https://learn.microsoft.com/en-us/azure/service-bus-messaging/batch-delete
Use JMS 2.0 API with Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/how-to-use-java-message-service-20
Develop Azure Service Bus clients using JMS 2.0	https://learn.microsoft.com/en-us/azure/service-bus-messaging/jms-developer-guide
Migrate JMS apps from ActiveMQ to Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/migrate-jms-activemq-to-servicebus
Use legacy .NET Service Bus library with AMQP	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-dotnet
Build Service Bus replication tasks with Azure Functions	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-replicator-functions
Define Azure Service Bus subscription filters and actions	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-filter-examples
Integrate RabbitMQ with Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-integrate-with-rabbitmq
Use JMS 1.1 with AMQP on Service Bus Standard	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-java-how-to-use-jms-api-amqp
Integrate Azure Service Bus with Event Grid	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-concept

Deployment

Topic	URL
Move an Azure Service Bus namespace across regions	https://learn.microsoft.com/en-us/azure/service-bus-messaging/move-across-regions
Create a Service Bus namespace with ARM template	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace
Deploy Service Bus namespace and queue via ARM template	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-queue
Deploy Service Bus namespace and queue using Bicep	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-queue-bicep
Deploy Service Bus namespace, topic, and subscription via ARM	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-topic
Deploy Service Bus topic, subscription, and rule via ARM	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-topic-with-rule
Deploy Service Bus resources using ARM templates	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-overview