← Аналитика / analytics / graphql-api / features

Доверительные интервалы

Доверительные интервалы помогают оценить точность и выразить меру неопределённости в результатах, полученных из выборочных наборов данных. При запросе полей sum или count в адаптивных наборах данных можно указать доверительный интервал, чтобы понять возможный разброс вокруг оценки. Например, если задать уровень доверия 0.95 возвращает оценку вместе с диапазоном значений, который с вероятностью 95% содержит истинное значение.

• Поддерживаемые наборы данных: Только для адаптивных (сэмплированных) наборов данных.
• Поддерживаемые поля: Все sum и count поля.
• Использование: Достоверность level должен быть указан в виде десятичного числа от 0 до 1 (например,0.90, 0.95, 0.99).
• По умолчанию: Если уровень достоверности не указан, интервалы не возвращаются.

Следующий пример показывает, как запросить доверительный интервал и интерпретировать ответ.

Чтобы запросить доверительный интервал, используйте confidence(level: X) аргумент в вашем запросе.

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
}