Cloudflare GraphQL API能否按请求路径与查询字符串过滤数据？

Cloudflare的GraphQL Analytics API确实支持按请求路径和查询字符串过滤数据，但添加过滤条件后返回0，大概率是字段用法或聚合逻辑出了问题，以下是具体说明和解决方案：

• 字段用法错误：第三方文档提到的clientRequestQuery_like并非官方支持的过滤方式，官方针对查询字符串的过滤需用clientRequestQuery配合标准操作符，比如精确匹配用eq，模糊匹配用contains。
• 聚合逻辑缺失：使用httpRequestsAdaptiveGroups时，若仅添加过滤条件但未指定对应的维度（dimensions），聚合后的数据集可能无法命中过滤规则。需要把clientRequestPath和clientRequestQuery加入dimensions数组，确保数据按这些维度拆分后能被筛选到。
• 匹配精度问题：路径需注意是否包含开头的/，查询字符串要匹配日志中的原始格式（比如是否有编码、参数顺序），避免因精确匹配不达标导致无结果。

正确的查询示例 #

{
  viewer {
    zones(filter: { zoneTag: "MY_ZONE_ID" }) {
      httpRequestsAdaptiveGroups(
        limit: 10000
        filter: {
          datetime_geq: "2023-10-16T00:00:00Z"
          datetime_lt: "2023-10-17T00:00:00Z"
          clientRequestHTTPHost: "my.domain.com"
          # 精确匹配请求路径
          clientRequestPath: { eq: "/your-target-path" }
          # 模糊匹配查询字符串中的指定内容
          clientRequestQuery: { contains: "param=value" }
        }
        # 指定维度，确保数据按路径和查询字符串分组
        dimensions: [clientRequestPath, clientRequestQuery]
      ) {
        dimensions
        sum {
          visits
        }
      }
    }
  }
}

如果只需要统计符合条件的总访问量，不需要拆分维度，可以改用httpRequestsAdaptive查询：

{
  viewer {
    zones(filter: { zoneTag: "MY_ZONE_ID" }) {
      httpRequestsAdaptive(
        filter: {
          datetime_geq: "2023-10-16T00:00:00Z"
          datetime_lt: "2023-10-17T00:00:00Z"
          clientRequestHTTPHost: "my.domain.com"
          clientRequestPath: { eq: "/your-target-path" }
          clientRequestQuery: { contains: "param=value" }
        }
      ) {
        sum {
          visits
        }
      }
    }
  }
}

注意：请以Cloudflare官方提供的GraphQL Schema文档为准，避免依赖第三方文档的错误信息。

内容的提问来源于stack exchange，提问作者Aziza Kasenova