← LeaderboardThe Skill Leaderboard

azure-service-bus

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).

Published by MicrosoftDocs ↗MicrosoftDocs/Agent-Skills

Try your first task

A source-grounded starter task has not been verified for this skill yet.

SKILL.md

name: azure-service-busdescription: 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

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

CategoryLinesDescription
TroubleshootingL37-L46Diagnosing and fixing Service Bus issues: AMQP errors, SDK/Resource Manager exceptions, legacy error codes, and tracing end-to-end operations for debugging.
Best PracticesL47-L61Designing reliable, high-performance Service Bus messaging: message design, filters, locks/settlement, duplicate detection, prefetch, timeouts/retries, metrics, and maintenance to avoid loss/duplicates.
Decision MakingL62-L71Guidance 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 PatternsL72-L82Patterns for designing resilient, geo-replicated, multi-namespace, and partitioned Service Bus architectures, including federation, autoforwarding chains, and message replication with NServiceBus.
Limits & QuotasL83-L90Details on Service Bus quotas, metrics, throttling limits, and FAQs about capacity, message size, throughput, and how throttling behaves and is reported.
SecurityL91-L115Securing Service Bus with Entra ID, SAS, keys, TLS, networking (VNet, Private Link, firewalls), policies, compliance, and best practices for auth, encryption, and secure access.
ConfigurationL116-L142Configuring Service Bus behavior: scaling, partitioning, sessions, forwarding, TTL/dead-lettering, filters/actions, AMQP/HTTP settings, monitoring, automation, and local emulation.
Integrations & Coding PatternsL143-L155Patterns 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.
DeploymentL156-L165Deploying Service Bus namespaces and entities (queues, topics, subscriptions, rules) using ARM/Bicep templates, and moving namespaces across Azure regions.

Troubleshooting

TopicURL
Troubleshoot AMQP errors in Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-troubleshoot
Trace and diagnose end-to-end Azure Service Bus operationshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-end-to-end-tracing
Interpret legacy Azure Service Bus messaging errorshttps://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 exceptionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-exceptions
Diagnose and fix common Azure Service Bus issueshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-troubleshooting-guide

Best Practices

TopicURL
Configure duplicate message detection in Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/duplicate-detection
Retrieve and use Service Bus message count metricshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-counters
Use sequencing and timestamps in Service Bus messageshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sequencing
Handle message locks and settlement in Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-transfers-locks-settlement
Prepare Service Bus namespaces for planned maintenancehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/prepare-for-planned-maintenance
Define and apply Service Bus subscription filtershttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-filter-examples
Prevent message loss and duplicates in Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-message-loss-and-duplicates
Design Azure Service Bus messages and payloadshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messages-payloads
Apply performance best practices for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-performance-improvements
Optimize Azure Service Bus prefetch behaviorhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-prefetch
Configure Service Bus timeouts and retry policieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-timeouts-retries

Decision Making

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

Architecture & Design Patterns

TopicURL
Build message-driven systems on Service Bus with NServiceBushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/build-message-driven-apps-nservicebus
Design chained Azure Service Bus entities with autoforwardinghttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-auto-forwarding
Design Service Bus federation and replication topologieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-overview
Implement Service Bus message replication patternshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-patterns
Design and configure Azure Service Bus geo-replicationhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-replication
Design multi-namespace Service Bus for resiliencehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-outages-disasters
Design and create partitioned Service Bus queues and topicshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-partitioning

Limits & Quotas

TopicURL
Map Azure Service Bus metrics to quotas and limitshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus-reference
Azure Service Bus FAQ with limits and behaviorshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-faq
Review Azure Service Bus quotas and throttling limitshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-quotas
Understand Azure Service Bus throttling limits and behaviorhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-throttling

Security

TopicURL
Configure Microsoft Entra authentication for Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/authenticate-application
Enable confidential computing for Service Bus Premiumhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/confidential-computing
Configure customer-managed keys for Service Bus encryptionhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/configure-customer-managed-key
Disable SAS local authentication for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/disable-local-authentication
Configure network security for Azure Service Bus namespaceshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security
Configure network security perimeter for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security-perimeter
Use built-in Azure Policy definitions for Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/policy-reference
Secure Azure Service Bus with Private Link Servicehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/private-link-service
Apply security best practices to Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/secure-service-bus
Apply regulatory compliance policies to Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/security-controls-policy
Configure authentication and authorization for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-authentication-and-authorization
Configure IP firewall rules for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-ip-filtering
Use managed identities to securely access Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-managed-service-identity
Migrate Service Bus apps to passwordless Entra ID authhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-azure-credentials
Create Service Bus authorization rules with ARM templateshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-auth-rule
Send Service Bus messages with Entra ID tokens via RESThttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-send-entra-token-how-to
Secure Azure Service Bus with shared access signatureshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas
Configure Service Bus virtual network service endpointshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-service-endpoints
Audit Service Bus TLS minimum version compliance with Azure Policyhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-audit-minimum-version
Configure minimum TLS version for a Service Bus namespacehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-configure-minimum-version
Enforce minimum TLS version for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-enforce-minimum-version

Configuration

TopicURL
Configure autoscale for Service Bus messaging unitshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/automate-update-messaging-units
Map classic Service Bus management APIs to ARMhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/deprecate-service-bus-management
Configure auto forwarding between Service Bus entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-auto-forward
Enable dead-letter queues for Service Bus entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-dead-letter
Configure duplicate detection for Service Bus entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-duplicate-detection
Enable and configure Service Bus message sessionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-message-sessions
Enable partitioning for Service Bus queues and topicshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-partitions-basic-standard
Enable partitioning for Azure Service Bus Premiumhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-partitions-premium
Suspend and reactivate Azure Service Bus entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/entity-suspend
Use peek operations to browse Service Bus messageshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-browsing
Configure message expiration and TTL in Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-expiration
Configure monitoring for Azure Service Bus with Azure Monitorhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus
Configure AMQP settings when migrating .NET Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-dotnet
Use AMQP request/response operations in Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-request-response
Configure Azure Functions-based Service Bus replication taskshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-configuration
Use Azure Monitor insights for Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-insights
Manage Service Bus resources with Azure PowerShellhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-manage-with-ps
Programmatically create and manage Service Bus namespaces and entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-management-libraries
Configure SQL filter expressions for Service Bus subscriptionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-filter
Use SQL action syntax for Service Bus subscription ruleshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-rule-action
Map HTTP headers to Service Bus message propertieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-message-properties
Configure REST namespace addressing for Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-namespace-access
Configure and run Azure Service Bus local emulatorhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/test-locally-with-service-bus-emulator

Integrations & Coding Patterns

TopicURL
Programmatically delete Service Bus messages in batcheshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/batch-delete
Use JMS 2.0 API with Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/how-to-use-java-message-service-20
Develop Azure Service Bus clients using JMS 2.0https://learn.microsoft.com/en-us/azure/service-bus-messaging/jms-developer-guide
Migrate JMS apps from ActiveMQ to Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/migrate-jms-activemq-to-servicebus
Integrate RabbitMQ with Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-integrate-with-rabbitmq
Integrate JMS 1.1 over AMQP with Service Bus Standardhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-java-how-to-use-jms-api-amqp
Integrate Azure Service Bus with Event Gridhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-concept
Integrate Service Bus events with Event Grid and Logic Appshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-example
Handle Service Bus events via Event Grid and Azure Functionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-function

Deployment

TopicURL
Move an Azure Service Bus namespace across regionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/move-across-regions
Create a Service Bus namespace with ARM templatehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace
Deploy Service Bus namespace and queue via ARM templatehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-queue
Deploy Service Bus namespace and queue using Bicephttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-queue-bicep
Deploy Service Bus namespace, topic, and subscription via ARMhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-topic
Deploy Service Bus topic, subscription, and rule via ARMhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-topic-with-rule
Deploy Service Bus resources using ARM templateshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-overview