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 building, debugging, or optimizing Azure Service Bus applications. Not for Azure Event Hubs (use azure-event-hubs), Azure Relay (use azure-relay), Azure Queue Storage (use azure-queue-storage), Azure Notification Hubs (use azure-notification-hubs).

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "azure-service-bus" with this command: npx skills add microsoftdocs/agent-skills/microsoftdocs-agent-skills-azure-service-bus

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: This file may be large. Use the Category Index below to locate relevant sections, then use read_file with specific line ranges (e.g., L136-L144) to read the sections needed for the user's question

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, tracing requests end-to-end, handling deprecated/current SDK exceptions, ARM/Resource Manager errors, and common runtime problems.
Best PracticesL47-L61Guidance on reliable Service Bus messaging: ordering, sessions, TTL/expiration, duplicate detection, dead-lettering, locks/settlement, serialization, and performance tuning (prefetch, throughput).
Decision MakingL62-L72Guidance on choosing Service Bus vs other messaging services/tiers, configuring autoforwarding, geo-disaster recovery/replication, and migrating from Standard to Premium.
Architecture & Design PatternsL73-L81Patterns for designing resilient, federated, multi-namespace Service Bus systems, including partitioning, replication, and using NServiceBus for message-driven architectures.
Limits & QuotasL82-L87Service Bus entity size and count limits, connection and throughput quotas, and how throttling works, including thresholds, causes, and mitigation strategies.
SecurityL88-L110Securing Service Bus with auth (Entra ID, SAS, managed identities), encryption, TLS, network isolation (VNet, Private Link, firewalls), and compliance/policy configuration.
ConfigurationL111-L137Configuring Service Bus entities, filters, sessions, partitioning, monitoring, and management via portal, PowerShell, ARM, and local emulator, plus message browsing, counts, and replication.
Integrations & Coding PatternsL138-L153Patterns and code for integrating Service Bus with JMS (1.1/2.0), AMQP, RabbitMQ, Event Grid, Logic Apps, Functions, and batch operations like bulk message deletion or replication.
DeploymentL154-L164Deploying and scaling Service Bus: autoscaling Premium messaging units and creating/moving namespaces, queues, topics, subscriptions, and rules using ARM templates or Bicep.

Troubleshooting

TopicURL
Troubleshoot AMQP errors in Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-troubleshoot
Configure end-to-end tracing for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-end-to-end-tracing
Handle deprecated Azure Service Bus messaging exceptionshttps://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
Resolve Azure Service Bus Resource Manager exceptionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-exceptions
Troubleshoot common Azure Service Bus issueshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-troubleshooting-guide

Best Practices

TopicURL
Configure and use Azure Service Bus duplicate detectionhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/duplicate-detection
Defer and later retrieve Azure Service Bus messageshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-deferral
Configure message expiration and TTL in Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-expiration
Use sequencing and timestamps in Service Bus messageshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sequencing
Implement FIFO and request-response with Service Bus sessionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sessions
Handle Service Bus message transfers, locks, and settlement correctlyhttps://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
Use Azure Service Bus dead-letter queues for message handlinghttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-dead-letter-queues
Handle messages and serialization in Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messages-payloads
Optimize Azure Service Bus messaging performancehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-performance-improvements
Tune Azure Service Bus prefetch for performancehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-prefetch

Decision Making

TopicURL
Choose between Event Grid, Event Hubs, and Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/compare-messaging-services
Configure and use Service Bus autoforwardinghttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-auto-forwarding
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
Configure Azure Service Bus Geo-Replicationhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-replication
Migrate Azure Service Bus from Standard to Premiumhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-standard-premium
Select Azure Service Bus standard vs premium messaging tiershttps://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 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 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
Azure Service Bus quotas, limits, and throttling thresholdshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-quotas
Understand throttling limits in Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-throttling

Security

TopicURL
Authenticate applications to Azure Service Bus with Entra IDhttps://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 Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security
Associate Service Bus with a network security perimeterhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security-perimeter
Apply Azure Policy definitions to Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/policy-reference
Integrate Service Bus with Azure Private Linkhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/private-link-service
Apply regulatory compliance policies to Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/security-controls-policy
Configure authentication and authorization for 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 access 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
Secure 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 Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-enforce-minimum-version

Configuration

TopicURL
Map classic Service Bus management APIs to ARMhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/deprecate-service-bus-management
Configure auto-forwarding for Service Bus queues and subscriptionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-auto-forward
Enable dead-lettering for Service Bus queues and subscriptionshttps://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 in Basic and Standard Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-partitions-basic-standard
Enable partitioning in Premium Service Bus namespaceshttps://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 Service Bus Explorer in Azure portal for data operationshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/explorer
Use Azure Service Bus message browsing and peek operationshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-browsing
Retrieve Service Bus queue and subscription message countshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-counters
Configure monitoring for Azure Service Bus with Azure Monitorhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus
Reference for Azure Service Bus monitoring metrics and logshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus-reference
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
Define topic subscription filters in Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-filter-examples
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 manage Service Bus namespaces and entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-management-libraries
Use SQL filter syntax for Service Bus subscription ruleshttps://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
Configure and use the Azure Service Bus emulator locallyhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/test-locally-with-service-bus-emulator
Configure Azure Service Bus topic filters and actionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/topic-filters

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 Bus over AMQPhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/how-to-use-java-message-service-20
Develop with Azure Service Bus 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
Use legacy .NET Service Bus library with AMQPhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-dotnet
AMQP 1.0 protocol details for Service Bus and Event Hubshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-protocol-guide
Build Service Bus replication tasks with Azure Functionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-replicator-functions
Integrate RabbitMQ with Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-integrate-with-rabbitmq
Use JMS 1.1 with AMQP on 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
Autoscale Service Bus Premium messaging unitshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/automate-update-messaging-units
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 with 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 with 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

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Security

azure-security

No summary provided by upstream source.

Repository SourceNeeds Review
7-microsoftdocs
Automation

azure-architecture

No summary provided by upstream source.

Repository SourceNeeds Review
10-microsoftdocs
Automation

azure-logic-apps

No summary provided by upstream source.

Repository SourceNeeds Review
8-microsoftdocs
Automation

azure-blob-storage

No summary provided by upstream source.

Repository SourceNeeds Review
8-microsoftdocs