置信区间 · Cloudflare Analytics docs

置信区间有助于评估采样数据集结果的准确性并量化不确定性。在 adaptive 数据集上查询 sum 或 count 字段时，您可以请求置信区间以了解估计值的可能范围。例如，指定置信水平 0.95 会返回估计值，以及 95% 概率包含真实值的数值范围。

可用性

支持的数据集：仅限 Adaptive（采样）数据集。
支持的字段：所有 sum 和 count 字段。
用法：置信 level 必须以 0 到 1 之间的小数形式提供（例如 0.90、0.95、0.99）。
默认值：如果未指定置信水平，则不会返回置信区间。

用法示例

以下示例展示如何查询置信区间并解读响应。

请求

要请求置信区间，请在查询中使用 confidence(level: X) 参数。

A GraphQL querygraphql

query SingleDatasetWithConfidence($zoneTag: string, $start: Time, $end: Time) {
  viewer {
    zones(filter: {zoneTag: $zoneTag}) {
      firewallEventsAdaptiveGroups(
        filter: {datetime_gt: $start, datetime_lt: $end}
        limit: 1000
      ) {
        count
        avg {
          sampleInterval
        }
        confidence(level: 0.95) {
          count {
            estimate
            lower
            upper
            sampleSize
          }
        }
      }
    }
  }
}

响应

响应包含以下值：

estimate：基于采样数据的估计值。
lower：置信区间的下界。
sampleSize：用于计算估计值的采样数据点数量。
upper：置信区间的上界。

在此示例中，基于 40,054 个样本，事件估计数量为 42,939，有 95% 的置信度认为真实值在 42,673 到 43,204 之间。

{
  "data": {
    "viewer": {
      "zones": [
        {
          "firewallEventsAdaptiveGroups": [
            {
              "avg": {
                "sampleInterval": 1.0720277625205972
              },
              "confidence": {
                "count": {
                  "estimate": 42939,
                  "lower": 42673.44115335711,
                  "sampleSize": 40054,
                  "upper": 43204.55884664289
                }
              },
              "count": 42939
            }
          ]
        }
      ]
    }
  },
  "errors": null
}