通过Java代码执行App Insights查询时触发语义错误的排查

我尝试通过Java代码对App Insights执行查询，先从一段极简单的语句开始：

requests | where success == false

该查询在Azure门户直接运行时能返回结果，但将其加入代码后却出现错误：

Failure Exception: HttpResponseException: Status code 400, "{\"error\":{\"message\":\"The request had some invalid properties\",\"code\":\"BadArgumentError\",\"correlationId\":\"22758365-9459-45ba-b4a3-1b134ce3a7a2\",\"innererror\":{\"code\":\"SemanticError\",\"message\":\"A semantic error occurred.\",\"innererror\":{\"code\":\"SEM0100\",\"message\":\"'where' operator: Failed to resolve table or column expression named 'requests'\"}}}}"

我在代码中使用LogsQueryClient执行该查询，请问可能哪里出了问题？

• 资源ID指定错误
  确认代码里的目标资源ID是App Insights实例的ID，而非Log Analytics工作区ID。requests是App Insights专属表，Log Analytics工作区没有这个原生表，错选资源自然找不到表。
  检查代码中的资源ID格式：

  String resourceId = "/subscriptions/{订阅ID}/resourceGroups/{资源组名}/providers/microsoft.insights/components/{App Insights实例名}";
  

• SDK版本兼容问题
  旧版azure-monitor-query库可能存在App Insights查询的兼容bug，导致表名解析失败。升级到最新稳定版的SDK再试，比如Maven依赖：

  <dependency>
      <groupId>com.azure</groupId>
      <artifactId>azure-monitor-query</artifactId>
      <version>最新稳定版号</version>
  </dependency>
  

• 查询时间范围异常
  如果代码指定的查询时间范围超出了App Insights数据的保留期，或者时间区间格式错误，也可能触发语义错误。检查时间区间设置是否合理，比如：

  QueryTimeInterval timeInterval = new QueryTimeInterval(Duration.ofDays(7)); // 查询最近7天数据
  

• 权限不足
  客户端认证用的身份（服务主体/托管标识）没有足够权限访问App Insights日志，也可能返回类似表不存在的错误。确认该身份拥有Monitoring Reader或Log Analytics Reader权限。

内容的提问来源于stack exchange，提问作者Piotr Gorak