SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-service-bus

MicrosoftDocs

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 namespaces, configuring queues/topics, using JMS clients, geo-DR/replication, or NServiceBus, and other Azure Service Bus related development tasks. Not for Azure Event Hubs (use azure-event-hubs), Azure Event Grid (use azure-event-grid), Azure Queue Storage (use azure-queue-storage), Azure Relay (use azure-relay).

v1.0Latest
New~4.5kUpdated Jun 26, 2026

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 fixing Service Bus errors: AMQP issues, tracing, .NET/current SDK exceptions, ARM/Resource Manager failures, and common connectivity or messaging problems.
Best Practices L47-L59 Best practices for reliable, ordered, and performant messaging: sessions, FIFO, locks/settlement, duplicate detection, dead-lettering, serialization, prefetch, and maintenance tuning.
Decision Making L60-L69 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 L70-L78 Patterns for designing resilient, federated, multi-namespace Service Bus systems, including partitioning, replication, and using NServiceBus for message-driven architectures.
Limits & Quotas L79-L86 Details on Service Bus size and throughput limits, quotas per tier, large message handling in Premium, and how throttling works and impacts clients.
Security L87-L109 Securing Service Bus with Entra ID, managed identities, SAS, keys, TLS, network isolation (VNet, Private Link, firewalls, NSPs), and applying Azure Policy/compliance settings.
Configuration L110-L134 Configuring and managing Service Bus entities (queues, topics, subscriptions), including forwarding, sessions, partitioning, TTL, monitoring, filters/actions, local emulation, and management via ARM/PowerShell.
Integrations & Coding Patterns L135-L150 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 L151-L160 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
Troubleshoot 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
Handle Service Bus message transfers, locks, and settlement correctly 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
Use and manage Azure Service Bus dead-letter queues https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-dead-letter-queues
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 with client and protocol tuning https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-performance-improvements
Tune Azure Service Bus prefetch for performance https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-prefetch

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
Configure Azure Service Bus Geo-Replication https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-replication
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
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
Understand Azure Service Bus limits and behaviors https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-faq
Use Azure Service Bus Premium tier 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 throttling limits in Azure Service Bus 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
Associate Azure Service Bus with a network security perimeter 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
Integrate 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
Configure IP firewall rules for Azure Service Bus https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-ip-filtering
Use managed identities to securely access Azure Service Bus https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-managed-service-identity
Migrate Service Bus apps to passwordless Entra ID auth https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-azure-credentials
Create Service Bus authorization rules with ARM templates https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-auth-rule
Implement Shared Access Signature authorization for Azure Service Bus https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas
Configure Service Bus virtual network service endpoints https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-service-endpoints
Audit Service Bus TLS minimum version compliance with Azure Policy https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-audit-minimum-version
Configure minimum TLS version for a Service Bus namespace https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-configure-minimum-version
Enforce minimum TLS version for Service Bus https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-enforce-minimum-version

Configuration

Topic URL
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 https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-expiration
Configure monitoring for Azure Service Bus with Azure Monitor https://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus
Use Azure Monitor metrics and logs for Service Bus https://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus-reference
Use AMQP request/response operations in Service Bus https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-request-response
Configure autoforwarding for Azure Service Bus entities https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-auto-forwarding
Configure Azure Functions-based Service Bus replication tasks https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-configuration
Use Azure Monitor insights for Service Bus https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-insights
Manage Service Bus resources with Azure PowerShell https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-manage-with-ps
Programmatically manage Service Bus namespaces and entities https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-management-libraries
Use SQL filter syntax for Service Bus subscription rules https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-filter
Use SQL action syntax for Service Bus subscription rules https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-rule-action
Configure and run Azure Service Bus local emulator https://learn.microsoft.com/en-us/azure/service-bus-messaging/test-locally-with-service-bus-emulator

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
Integrate Service Bus events with Event Grid and Logic Apps https://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 Functions https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-function

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
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

78/100

Grade

B

Good

Safety

82

Quality

76

Clarity

82

Completeness

72

Summary

This skill provides expert guidance for Azure Service Bus development and operations. It combines structured reference documentation (troubleshooting, best practices, architecture patterns, security, configuration, integrations, deployment) with remote documentation fetching capabilities via Microsoft Docs. The skill acts as a curated index that directs agents to authoritative Microsoft Learn documentation while offering fallback options for missing tools.

Detected Capabilities

network request (documentation fetching)read reference documentationconditional tool availability checksguidance on authentication and security patterns

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure service busmessage queue setupservice bus troubleshootingjms integrationnamespace securityservice bus migrationamqp debugging

Risk Signals

INFO

Network access to microsoft.com and github.com for documentation retrieval

compatibility field, tool references
INFO

Conditional execution: instructions require mcp_microsoftdocs tool or fallback to fetch_webpage

How to Use This Skill section
INFO

References Microsoft Docs and GitHub links which are publicly accessible

Category Index sections (Troubleshooting through Deployment)

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Debug AMQP connectivity issues and exceptions in Service Bus
  • Configure security, authentication, and network isolation for namespaces
  • Design multi-tenant and federated messaging topologies
  • Migrate applications from Standard to Premium tier or across regions
  • Set up JMS clients, NServiceBus integrations, or Event Grid connectors
  • Optimize message throughput, prefetch, and session handling
  • Deploy Service Bus namespaces and entities using ARM/Bicep templates

Quality Notes

  • Comprehensive category index with clear line-range references and 80+ links to authoritative Microsoft Docs
  • Logical structure with well-defined boundaries (excludes Event Hubs, Event Grid, Queue Storage, Relay)
  • Instructions for agents include clear fallback logic (primary tool + fallback tool) with deprecation warnings
  • Well-organized by topic area (troubleshooting, security, configuration, deployment) enabling targeted lookups
  • Metadata field (generated_at) allows freshness validation to prompt skill updates
  • Minimal content in SKILL.md itself—relies on remote documentation, appropriate for a reference skill
  • Missing example queries or concrete scenarios that might help agents know when to invoke which category
  • No inline error handling patterns for network failures or documentation fetch timeout scenarios
  • Security table omits RBAC/access control patterns and secret rotation best practices despite comprehensive coverage elsewhere
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/azure-service-bus in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...

MicrosoftDocs/azure-service-bus | SkillRepo