关于 azure-event-grid
面向使用 Azure Event Grid 的开发者和运维人员,提供涵盖故障排查、设计、安全、配置与集成的参考指南。结合本地速查内容与远程文档获取,支持进一步查阅主题资料。
主要功能
- 01故障排查与错误诊断
- 02架构设计与方案选择
- 03配额、限制与投递行为
- 04安全与身份验证配置
- 05服务配置及集成模式
- 06本地索引与远程文档获取
适用场景
- 01诊断 MQTT 或 Webhook 问题
- 02规划事件路由与 MQTT 模式
- 03配置访问控制和网络安全
- 04查阅服务限制及集成方法
MCP 相关
可通过 mcp_microsoftdocs 的 microsoft_docs_fetch 获取 Microsoft 文档;也可使用 fetch_webpage 作为备用方式。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-event-grid安装后在 Claude Code 中输入/azure-event-grid确认已加载。
详细介绍
Azure Event Grid 技能
此技能提供 Azure Event Grid 专家指南,涵盖故障排除、最佳实践、决策、架构与设计模式、限制与配额、安全性、配置以及集成与编码模式。它结合了本地快速参考内容和远程文档获取功能。
如何使用此技能
IMPORTANT for Agent:使用下面的类别索引查找相关章节。对于带有行范围的类别(例如,
L35-L120),请使用read_file读取指定行。对于带有文件链接的类别(例如,[security.md](security.md)),请使用read_file读取链接的参考文件
IMPORTANT for Agent:如果
metadata.generated_at距今已超过 3 个月,请建议用户从存储库拉取最新版本。如果无法使用mcp_microsoftdocs工具,请建议用户安装该工具:安装指南
此技能需要网络访问才能获取文档内容:
- 首选:使用
mcp_microsoftdocs:microsoft_docs_fetch,并添加查询字符串from=learn-agent-skill。返回 Markdown。 - 备用:使用
fetch_webpage,并添加查询字符串from=learn-agent-skill&accept=text/markdown。返回 Markdown。
类别索引
| 类别 | 行 | 说明 |
|---|---|---|
| 故障排除 | L36-L44 | 诊断和修复 Event Grid 问题:MQTT 代理问题、错误代码、常见故障、网络连接以及 webhook 订阅验证错误。 |
| 最佳实践 | L45-L49 | 关于如何为 Event Grid 设计客户端故障转移的指南,包括使用多个区域、重试逻辑以及用于实现高可用性的弹性发布模式。 |
| 决策 | L50-L60 | 关于如何选择 Event Grid 层级、架构、Kubernetes 与 Azure 托管方式、MQTT 路由、自动缩放、推送传递,以及从 IoT Edge 上的 Event Grid 迁移到 IoT Edge hub 的指南。 |
| 架构与设计模式 | L61-L67 | 使用 Azure Event Grid 在命名空间之间路由事件、设计 MQTT 主题层次结构,以及实现 MQTT 命令/响应流的模式。 |
| 限制与配额 | L68-L79 | Event Grid 传递/重试行为、自定义标头、事件保留,以及主题、命名空间和基于 Kubernetes 的 Event Grid 的区域特定配额/限制。 |
| 安全性 | L80-L130 | 保护 Event Grid:身份验证(密钥、Entra ID、JWT、OAuth)、RBAC、托管标识、MQTT 身份验证、webhook、IP 防火墙、专用终结点、TLS,以及 Azure Policy 合规性。 |
| 配置 | L131-L204 | 配置 Event Grid 和命名空间:主题、架构、筛选器、死信、监视、MQTT 代理/客户端、TLS、自动缩放/吞吐量,以及与许多 Azure/Microsoft 服务的集成。 |
| 集成与编码模式 | L205-L245 | 将 Event Grid 与 Auth0、Graph/M365 应用、MQTT、webhook、Functions、Service Bus、Event Hubs 集成的模式和指南,以及事件架构和处理程序配置说明。 |
故障排除
| 主题 | URL |
|---|---|
| 排查 Azure Event Grid MQTT 代理问题 | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-troubleshoot-errors |
| Azure Event Grid 错误代码及解决方法 | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-errors |
| 排查常见 Azure Event Grid 问题 | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-issues |
| 诊断 Azure Event Grid 网络连接故障 | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-network-connectivity |
| 排查 Event Grid webhook 订阅验证问题 | https://learn.microsoft.com/en-us/azure/event-grid/troubleshoot-subscription-validation |
最佳实践
| 主题 | URL |
|---|---|
| 为 Azure Event Grid 实现客户端故障转移 | https://learn.microsoft.com/en-us/azure/event-grid/custom-disaster-recovery-client-side |
决策
| 主题 | URL |
|---|---|
| 选择合适的 Azure Event Grid 层级 | https://learn.microsoft.com/en-us/azure/event-grid/choose-right-tier |
| 为 Azure Event Grid 订阅选择兼容的事件架构 | https://learn.microsoft.com/en-us/azure/event-grid/event-schema-compatibility |
| 比较 Kubernetes 上的 Event Grid 与 Azure 功能 | https://learn.microsoft.com/en-us/azure/event-grid/kubernetes/features |
| 选择 Event Grid 中的 MQTT 路由选项 | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-routing |
| 对 Azure Event Grid 命名空间使用自动缩放 | https://learn.microsoft.com/en-us/azure/event-grid/namespace-autoscale-overview |
| 决定是否为 Event Grid 命名空间使用推送传递 | https://learn.microsoft.com/en-us/azure/event-grid/namespace-push-delivery-overview |
| 从 IoT Edge 上的 Event Grid 迁移到 IoT Edge hub | https://learn.microsoft.com/en-us/azure/event-grid/transition |
架构与设计模式
| 主题 | URL |
|---|---|
| 在 Event Grid 命名空间主题之间转发事件 | https://learn.microsoft.com/en-us/azure/event-grid/forward-events-to-another-namespace-topic |
| 使用 Event Grid 实现 MQTT 请求-响应命令 | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-request-response-messages |
| 在 Event Grid 中设计 MQTT 主题空间 | https://learn.microsoft.com/en-us/azure/event-grid/mqtt-topic-spaces |
限制与配额
| 主题 | URL |
|---|---|
| 了解 Azure Event Grid 的传递和重试行为 | https://learn.microsoft.com/en-us/azure/event-grid/delivery-and-retry |
| 为 Azure Event Grid 事件配置自定义传递标头 | https://learn.microsoft.com/en-us/azure/event-grid/delivery-properties |
| 了解 Event Grid 命名空间主题的事件保留 | https://learn.microsoft.com/en-us/azure/event-grid/event-retention |
| 关于 Azure Event Grid 限制和行为的常见问题 | https://learn.microsoft.com/en-us/azure/event-grid/faq |
| 了解 Kubernetes 上的 Event Grid 的传递和重试行为 | https://learn.microsoft.com/en-us/azure/event-grid/kubernetes/delivery-retry |
| 为 Event Grid 命名空间设置自定义传递标头 | https://learn.microsoft.com/en-us/azure/event-grid/namespace-delivery-properties |
| Event Grid 命名空间推送的传递和重试行为 | https://learn.microsoft.com/en-us/azure/event-grid/namespace-delivery-retry |
| 查看各区域的 Azure Event Grid 配额和限制 | https://learn.microsoft.com/en-us/azure/event-grid/quotas-limits |
安全性
配置
集成与编码模式
评论
支持 Markdown