$ ~/registry/skill/microsoft-plugin-skills-azure-messaging

SKILL

azure-messaging

Name: azure-messaging
Author: microsoft

帮助排查并解决 Azure Event Hubs 与 Service Bus SDK 的连接、认证和消息处理问题。

星标

★ 232

来源

GitHub

更新于

2026-07-13

// 安全评估低风险

仅提示词，不执行代码
开源可审计
社区验证· 232

正在进行安全审计…

凭证密钥
网络外发
代码执行
数据访问
来源供应链

// 安装

复制安装指令，让 AI 自动完成配置 · 推荐新手

请帮我安装 askskill 上的 "azure-messaging" 技能：
1. 下载 https://raw.githubusercontent.com/microsoft/GitHub-Copilot-for-Azure/main/plugin/skills/azure-messaging/SKILL.md
2. 保存为 ~/.claude/skills/azure-messaging/SKILL.md
3. 装好后重载技能，告诉我可以用了

// 下载

下载 SKILL.md机读安装清单 ↗

// 用法示例

排查 Service Bus 消息锁过期

输入

我在 Azure Service Bus 的消费者中频繁遇到 message lock lost 和 lock expired。请根据我的处理流程、并发设置和自动续锁配置，帮我分析可能原因，并给出 .NET 的排查步骤与修复建议。

预期产出

输出锁过期的可能根因、关键配置检查项，以及可执行的修复方案与示例代码建议。

分析 Event Hubs 收不到消息

输入

我的 Azure Event Hubs 消费程序已经连接成功，但持续收不到消息。请从 consumer group、checkpoint、offset、分区分配和权限配置等角度，给我一份 Python SDK 排查清单。

预期产出

输出分步骤排查清单，帮助定位无消息接收的具体原因，并提供对应修复思路。

定位 AMQP 连接与超时问题

输入

我的 Azure Messaging 应用频繁出现 receiver disconnected、link detach、idle timeout 和 send timeout。请结合 Java SDK 日志配置，帮我判断这更像网络问题、认证问题还是客户端配置问题，并给出优化建议。

预期产出

输出按问题类型分类的诊断思路、日志启用方法，以及连接稳定性优化建议。

// 文档

Azure Messaging SDK Troubleshooting

Quick Reference

Property	Value
Services	Azure Event Hubs, Azure Service Bus
MCP Tools	`mcp_azure_mcp_eventhubs`, `mcp_azure_mcp_servicebus`
Best For	Diagnosing SDK connection, auth, and message processing issues

When to Use This Skill

SDK connection failures, auth errors, or AMQP link errors
Idle timeout, connection inactivity, or slow reconnection after disconnect
AMQP link detach or detach-forced errors
Message lock lost, message lock expired, lock renewal failures, or batch lock timeouts
Session lock lost, session lock expired, or session receiver errors
Event processor or message handler stops processing
Duplicate events or checkpoint offset resets
SDK configuration questions (retry, prefetch, batch size, receive batch behavior)

MCP Tools

Tool	Command	Use
`mcp_azure_mcp_eventhubs`	Namespace/hub ops	List namespaces, hubs, consumer groups
`mcp_azure_mcp_servicebus`	Queue/topic ops	List namespaces, queues, topics, subscriptions
`mcp_azure_mcp_monitor`	`logs_query`	Query diagnostic logs with KQL
`mcp_azure_mcp_resourcehealth`	`get`	Check service health status
`mcp_azure_mcp_documentation`	Doc search	Search Microsoft Learn for troubleshooting docs

Diagnosis Workflow

Identify the SDK and version — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
Check resource health — Use mcp_azure_mcp_resourcehealth to verify the namespace is healthy
Review the error message — Match against language-specific troubleshooting guide
Look up documentation — Use mcp_azure_mcp_documentation to search Microsoft Learn for the error or topic
Check configuration — Verify connection string, entity name, consumer group
Recommend fix — Apply remediation, citing documentation found

Troubleshooting Guides

Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under troubleshooting/messaging/.

References

Use mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance.

microsoft装→

// 功能相似

技能

★232

azure-diagnostics

帮助你安全排查 Azure 生产故障，定位应用、容器与消息服务根因

microsoft装→

$ loading_

请帮我安装 askskill 上的 "azure-messaging" 技能： 1. 下载 https://raw.githubusercontent.com/microsoft/GitHub-Copilot-for-Azure/main/plugin/skills/azure-messaging/SKILL.md 2. 保存为 ~/.claude/skills/azure-messaging/SKILL.md 3. 装好后重载技能，告诉我可以用了

// 用法示例

排查 Service Bus 消息锁过期

输入

我在 Azure Service Bus 的消费者中频繁遇到 message lock lost 和 lock expired。请根据我的处理流程、并发设置和自动续锁配置，帮我分析可能原因，并给出 .NET 的排查步骤与修复建议。

预期产出

输出锁过期的可能根因、关键配置检查项，以及可执行的修复方案与示例代码建议。

分析 Event Hubs 收不到消息

输入

我的 Azure Event Hubs 消费程序已经连接成功，但持续收不到消息。请从 consumer group、checkpoint、offset、分区分配和权限配置等角度，给我一份 Python SDK 排查清单。

预期产出

输出分步骤排查清单，帮助定位无消息接收的具体原因，并提供对应修复思路。

定位 AMQP 连接与超时问题

输入

我的 Azure Messaging 应用频繁出现 receiver disconnected、link detach、idle timeout 和 send timeout。请结合 Java SDK 日志配置，帮我判断这更像网络问题、认证问题还是客户端配置问题，并给出优化建议。

预期产出

输出按问题类型分类的诊断思路、日志启用方法，以及连接稳定性优化建议。

// 文档

Azure Messaging SDK Troubleshooting

Quick Reference

Property	Value
Services	Azure Event Hubs, Azure Service Bus
MCP Tools	`mcp_azure_mcp_eventhubs`, `mcp_azure_mcp_servicebus`
Best For	Diagnosing SDK connection, auth, and message processing issues

When to Use This Skill

SDK connection failures, auth errors, or AMQP link errors
Idle timeout, connection inactivity, or slow reconnection after disconnect
AMQP link detach or detach-forced errors
Message lock lost, message lock expired, lock renewal failures, or batch lock timeouts
Session lock lost, session lock expired, or session receiver errors
Event processor or message handler stops processing
Duplicate events or checkpoint offset resets
SDK configuration questions (retry, prefetch, batch size, receive batch behavior)

MCP Tools

Tool	Command	Use
`mcp_azure_mcp_eventhubs`	Namespace/hub ops	List namespaces, hubs, consumer groups
`mcp_azure_mcp_servicebus`	Queue/topic ops	List namespaces, queues, topics, subscriptions
`mcp_azure_mcp_monitor`	`logs_query`	Query diagnostic logs with KQL
`mcp_azure_mcp_resourcehealth`	`get`	Check service health status
`mcp_azure_mcp_documentation`	Doc search	Search Microsoft Learn for troubleshooting docs

Diagnosis Workflow

Identify the SDK and version — Check the prompt for SDK and version clues; if not stated, proceed with diagnosis and ask later if needed
Check resource health — Use mcp_azure_mcp_resourcehealth to verify the namespace is healthy
Review the error message — Match against language-specific troubleshooting guide
Look up documentation — Use mcp_azure_mcp_documentation to search Microsoft Learn for the error or topic
Check configuration — Verify connection string, entity name, consumer group
Recommend fix — Apply remediation, citing documentation found

Troubleshooting Guides

Connectivity, SDK, and auth troubleshooting guides are located in the azure-diagnostics skill under troubleshooting/messaging/.

References

Use mcp_azure_mcp_documentation to search Microsoft Learn for latest guidance.