Azure APIM发送WebSocketConnectionLogs至EventHub配置故障排查

你当前配置链路存在几个高频遗漏点，按优先级逐一核对：

• 日志类别选型错误：你仅勾选了WebSocketConnectionLogs分类，该分类仅记录APIM的WebSocket连接生命周期事件，只有当你通过APIM对外暴露WebSocket服务、有客户端发起WebSocket连接请求时才会产生日志。你需要采集的App Service经APIM转发的普通HTTP API调用流量，根本不会被归类到这个日志项里，自然不会有任何数据投递到EventHub。如果要采集API网关流转的请求日志，需要勾选GatewayLogs分类，该分类才会覆盖所有经过APIM网关的HTTP/HTTPS API调用记录。
• APIM诊断设置的EventHub写入权限校验：
  • 确认配置时选择的EventHub共享访问策略具备发送权限，若误用了仅带监听、管理权限的策略，APIM无法将日志写入EventHub，队列本身就没有数据。
  • 若EventHub启用了虚拟网络服务端点、私有端点或IP防火墙规则，需要确认APIM到EventHub的网络连通性：公网接入的APIM需要被加入EventHub的IP允许列表，VNet注入的APIM需要配置对应私有DNS解析和网络访问权限，跨区域投递时不要启用区域隔离策略。
  • 确认诊断设置未配置日志过滤规则，若设置了日志级别、分类的排除筛选，目标日志会被直接过滤不会投递。
• Azure Function EventHub触发器配置校验：
  • 确认触发器配置的EventHub名称、消费组、连接字符串完全匹配：默认消费组为$Default，若使用自定义消费组需要确保消费组已提前创建；连接字符串需要对应EventHub实例级别的带监听权限的连接串，不要误用命名空间根级别的连接串且漏填EventHub名称参数。
  • 若Function启用了VNet集成、部署在ASE环境，需要确认Function到EventHub的AMQP（5671/5672端口）、HTTPS（443端口）出站连通性正常，网络被拦截时触发器无法建立连接拉取消息。
  • APIM诊断日志投递到EventHub存在5~15分钟的平台级延迟，刚完成配置后需要等待足够时间再验证，不要配置完成立刻判断无数据。
• 快速定位故障段方法：

直接前往EventHub实例的概览页查看「传入消息」监控指标：如果指标数值为0，故障点在APIM诊断配置侧，和Function无关；如果指标存在正常数值，说明APIM已经成功写入日志，故障点在Function触发器的配置或网络连通性上。

内容的提问来源于stack exchange，提问作者Satya Panigrahy