azure-service-bus
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure Service Bus Skill
Azure Service Bus 技能
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.
本技能为Azure Service Bus提供专业指导,涵盖故障排查、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署。它结合了本地快速参考内容与远程文档获取能力。
How to Use This Skill
如何使用本技能
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,), useL35-L120with the specified lines. For categories with file links (e.g.,read_file), use[security.md](security.md)on the linked reference fileread_file
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
Agent 重要提示:使用下方的分类索引定位相关章节。对于带有行范围的分类(如),使用L35-L120读取指定行;对于带有文件链接的分类(如read_file),使用[security.md](security.md)读取链接的参考文件read_file
本技能需要网络访问权限来获取文档内容:
- 首选方式:使用,查询字符串为
mcp_microsoftdocs:microsoft_docs_fetch,返回Markdown格式内容。from=learn-agent-skill - 备用方式:使用,查询字符串为
fetch_webpage,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L46 | Diagnosing 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 Practices | L47-L61 | Guidance on reliable Service Bus messaging: ordering, sessions, TTL/expiration, duplicate detection, dead-lettering, locks/settlement, serialization, and performance tuning (prefetch, throughput). |
| Decision Making | L62-L72 | Guidance on choosing Service Bus vs other messaging services/tiers, configuring autoforwarding, geo-disaster recovery/replication, and migrating from Standard to Premium. |
| Architecture & Design Patterns | L73-L81 | Patterns for designing resilient, federated, multi-namespace Service Bus systems, including partitioning, replication, and using NServiceBus for message-driven architectures. |
| Limits & Quotas | L82-L87 | Service Bus message, entity, and namespace quotas (size, connections, throughput) and how throttling works, including limits, behaviors under load, and mitigation strategies. |
| Security | L88-L110 | Securing Service Bus: identity-based auth, SAS, keys and encryption, TLS, network isolation (VNet, Private Link, firewalls), policies, compliance, and passwordless/managed identities. |
| Configuration | L111-L134 | Configuring Service Bus entities, filters, sessions, partitioning, monitoring, and management via portal, PowerShell, ARM, and local emulator, plus message browsing, counts, and replication. |
| Integrations & Coding Patterns | L135-L151 | Patterns and code for integrating Service Bus with JMS, AMQP, RabbitMQ, Event Grid/Logic Apps/Functions, subscription filters, and batch message operations/migration scenarios |
| Deployment | L152-L162 | Deploying and scaling Service Bus: autoscaling Premium messaging units and creating/moving namespaces, queues, topics, subscriptions, and rules using ARM templates or Bicep. |
| 分类 | 行范围 | 描述 |
|---|---|---|
| 故障排查 | L37-L46 | 诊断并修复Service Bus问题:AMQP错误、端到端请求追踪、处理已弃用/当前SDK异常、ARM/资源管理器错误以及常见运行时问题。 |
| 最佳实践 | L47-L61 | 可靠Service Bus消息传递指南:排序、会话、TTL/过期、重复检测、死信队列、锁/结算、序列化以及性能调优(预取、吞吐量)。 |
| 决策制定 | L62-L72 | 关于选择Service Bus与其他消息服务/层级、配置自动转发、异地灾难恢复/复制以及从标准层迁移到高级层的指导。 |
| 架构与设计模式 | L73-L81 | 设计弹性、联邦、多命名空间Service Bus系统的模式,包括分区、复制以及使用NServiceBus构建消息驱动架构。 |
| 限制与配额 | L82-L87 | Service Bus消息、实体和命名空间的配额(大小、连接数、吞吐量)以及限流机制的工作原理,包括限制、负载下的行为以及缓解策略。 |
| 安全 | L88-L110 | 保护Service Bus:基于身份的认证、SAS、密钥与加密、TLS、网络隔离(VNet、Private Link、防火墙)、策略、合规以及无密码/托管身份。 |
| 配置 | L111-L134 | 配置Service Bus实体、筛选器、会话、分区、监控,以及通过门户、PowerShell、ARM和本地模拟器进行管理,还包括消息浏览、计数和复制。 |
| 集成与编码模式 | L135-L151 | Service Bus与JMS、AMQP、RabbitMQ、Event Grid/Logic Apps/Functions集成的模式与代码,订阅筛选器以及批量消息操作/迁移场景。 |
| 部署 | L152-L162 | 部署与缩放Service Bus:自动缩放高级层消息单元,使用ARM模板或Bicep创建/移动命名空间、队列、主题、订阅和规则。 |
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 |
| Handle deprecated Azure Service Bus messaging 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 |
| Resolve 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 |
| 主题 | URL |
|---|---|
| 排查Azure Service Bus中的AMQP错误 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-troubleshoot |
| 为Azure Service Bus配置端到端追踪 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-end-to-end-tracing |
| 处理已弃用的Azure Service Bus消息传递异常 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-exceptions |
| 处理Azure Service Bus消息传递异常(当前SDK) | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-exceptions-latest |
| 解决Azure Service Bus资源管理器异常 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-exceptions |
| 排查Azure Service Bus常见问题 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-troubleshooting-guide |
Best Practices
最佳实践
Decision Making
决策制定
| 主题 | URL |
|---|---|
| 在Event Grid、Event Hubs与Service Bus之间选择 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/compare-messaging-services |
| 配置并使用Service Bus自动转发 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-auto-forwarding |
| 在Azure存储队列与Service Bus队列之间做选择 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-azure-and-service-bus-queues-compared-contrasted |
| 设置Service Bus异地灾难恢复 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-dr |
| 配置Azure Service Bus异地复制 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-geo-replication |
| 将Azure Service Bus从标准层迁移到高级层 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-standard-premium |
| 选择Azure Service Bus标准层与高级层消息传递层级 | 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 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 |
| 主题 | URL |
|---|---|
| 使用NServiceBus在Service Bus上构建消息驱动系统 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/build-message-driven-apps-nservicebus |
| 设计Service Bus联邦与复制拓扑 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-overview |
| 实现Service Bus消息复制模式 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-patterns |
| 设计多命名空间Service Bus以实现弹性 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-outages-disasters |
| 设计并创建分区的Service Bus队列与主题 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-partitioning |
Limits & Quotas
限制与配额
| Topic | URL |
|---|---|
| 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 |
| 主题 | URL |
|---|---|
| Azure Service Bus配额与限制参考 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-quotas |
| 了解Azure Service Bus中的限流限制 | https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-throttling |