FreePublished on GitHub

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 using queues/topics with sessions, partitioning, autoforwarding, JMS/AMQP integrations, 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 Notification Hubs (use azure-notification-hubs).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills

Works withAzure

See how to install

Files included (1)

SKILL.md18.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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 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 resilient, geo-replicated, multi-namespace Service Bus architectures, including partitioning, autoforwarding chains, federation, and message replication with NServiceBus.
Limits & Quotas	L83-L89	Service Bus entity size, connection, and throughput limits, quota behaviors, and how throttling works (including common throttling scenarios and mitigation guidance).
Security	L90-L114	Configuring Service Bus security: Entra ID auth, managed identities, SAS, encryption/CMK, network isolation (VNet, Private Link, firewalls), TLS policies, and compliance/Azure Policy.
Configuration	L115-L140	Configuring and managing Service Bus entities: scaling, sessions, partitioning, forwarding, TTL/dead-lettering, filters/actions, AMQP/HTTP settings, monitoring, automation, and local emulation.
Integrations & Coding Patterns	L141-L153	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	L154-L163	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/service-bus-filter-examples
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
Design Azure Service Bus messages and payloads	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messages-payloads
Apply performance best practices for Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-performance-improvements
Optimize Azure Service Bus prefetch behavior	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
Choose Azure Service Bus Premium tier for workloads	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-premium-messaging

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 chained Azure Service Bus entities with autoforwarding	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 geo-replication for Azure Service Bus namespaces	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-replication
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
Review Azure Service Bus quotas and throttling 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
Configure Microsoft Entra authentication for Service Bus	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
Configure network security perimeter for Azure Service Bus	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 security best practices to Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/secure-service-bus
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
Send Service Bus messages with Entra ID tokens via REST	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-send-entra-token-how-to
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 Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-enforce-minimum-version

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 between Service Bus entities	https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-auto-forward
Enable dead-letter queues for Service Bus entities	https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-dead-letter
Configure duplicate detection for Service Bus entities	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 peek operations to browse Service Bus messages	https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-browsing
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
Configure AMQP settings when migrating .NET Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-dotnet
Use AMQP request/response operations in Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-request-response
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 create and manage Service Bus namespaces and entities	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-management-libraries
Configure SQL filter expressions for Service Bus subscriptions	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
Map HTTP headers to Service Bus message properties	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-message-properties
Configure REST namespace addressing for Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-rest-namespace-access
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
Integrate RabbitMQ with Azure Service Bus	https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-integrate-with-rabbitmq
Integrate JMS 1.1 over AMQP with 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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

More skills from this repository

azure-active-directory-b2c

Free

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-advisor

Free

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Advisor alerts, digests, recommendation states, Resource Graph queries, or RBAC access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-ai-vision

Free

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-aks-edge-essentials

Free

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, GitOps, IoT/OPC/ONVIF, or Key Vault-integrated workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-analysis-services

Free

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-anyscale-on-azure

Free

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when registering AKS as Anyscale clouds, wiring ACR images, enabling Private Link/RBAC, ARM-based deployments, or region checks, and other Azure Anyscale On Azure related development tasks. Not for Azure Databricks (use azure-databricks), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Machine Learning (use azure-machine-learning), Azure HDInsight (use azure-hdinsight).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

See all skills by MicrosoftDocs

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/MicrosoftDocs/Agent-Skills --skill azure-service-bus

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-service-bus

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/azure-service-bus/ for Claude Code, or ~/.agents/skills/azure-service-bus/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: MicrosoftDocs/Agent-Skills
Stars: 787
Forks: 128
Category: DevOps
License: CC-BY-4.0
Original language: English
Last updated: Oct 19, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.