存储账户无法查看Event Grid系统主题且事件未投递问题排查

可能的原因 #

• 权限限制：当前登录Azure门户的账户缺少Event Grid Contributor或Storage Account Owner权限，导致无法在存储账户「事件」选项卡查看系统主题。即使系统主题已创建，权限不足也会隐藏相关入口。
• 事件过滤规则不匹配：虽然触发类型设为BlobCreated，但如果配置了严格的前缀/后缀过滤（比如指定了特定容器或Blob名称规则），而实际创建的Blob不符合规则，事件会被过滤掉。另外，需确认是否订阅了正确的Blob类型（块Blob、追加Blob或页Blob），默认可能只订阅块Blob。
• 目标端点不可达或配置错误：事件订阅的目标（如Azure函数、逻辑应用、Webhook）存在网络限制（比如VNet防火墙未放行Event Grid服务流量）、端点地址错误或服务不可用，导致事件投递失败后被丢弃。
• 资源提供商未注册：Azure中国订阅中Microsoft.EventGrid资源提供商可能未手动注册（全球Azure可能默认注册，但中国区需手动操作），即使创建了系统主题，也会影响事件流转。
• 系统主题状态异常：部分Azure中国区域的系统主题可能存在同步延迟，或因存储账户配置变更（如启用分层命名空间）导致主题处于未激活状态，需通过CLI/PowerShell确认主题实际状态。

用于排查的诊断日志 #

• 存储账户诊断日志：启用StorageWrite日志，查看Blob创建操作的详细记录，确认事件源确实产生了符合条件的事件。
• Event Grid系统主题诊断日志：在系统主题的「诊断设置」中，启用PublishFailures（事件从存储到Event Grid的发布失败）、DeliveryFailures（事件投递到目标的失败）、RuntimeErrors（运行时错误）日志，定位事件流转各环节的问题。
• 目标端点日志：
  • 若目标为Azure函数：查看函数的执行日志和应用服务日志，确认是否收到Event Grid的请求。
  • 若目标为逻辑应用：检查逻辑应用的运行历史，查看触发环节是否有报错。
  • 若目标为Webhook：查看Webhook服务器的访问日志，确认是否收到Event Grid的POST请求。
• Azure活动日志：查看系统主题、事件订阅的创建/更新操作记录，排查是否有配置错误或异常状态。

Azure中国环境的特殊注意点 #

• 资源提供商注册：需手动注册Microsoft.EventGrid资源提供商，步骤：Azure门户→订阅→资源提供商→搜索Microsoft.EventGrid→点击「注册」。
• 网络合规限制：若目标端点位于VNet内，需配置Event Grid的服务端点，或在目标资源的防火墙规则中添加EventGrid服务标签；若目标为公网地址，需确认地址在中国Azure的合规访问范围内。
• 区域功能差异：部分Azure中国区域可能对Event Grid系统主题的支持有延迟，需确认使用的区域是否在官方支持列表中。
• 系统主题查看方式：若存储账户「事件」选项卡无法查看系统主题，可通过Azure CLI命令确认主题状态：

  az eventgrid system-topic show --name <系统主题名称> --resource-group <资源组名称>
  

内容的提问来源于stack exchange，提问作者Shivank Mishra