← Analytics / analytics / graphql-api / features

Intervaly spolehlivosti

Intervaly spolehlivosti pomáhají posoudit přesnost a vyjádřit míru nejistoty ve výsledcích ze vzorkovaných datových sad. Při dotazování na pole sum nebo count v adaptivních datových sadách si můžete vyžádat interval spolehlivosti, který ukazuje možný rozsah kolem odhadované hodnoty. Pokud například zadáte úroveň spolehlivosti 0.95 vrací odhad společně s rozsahem hodnot, v němž se skutečná hodnota s pravděpodobností 95 % nachází.

• Podporované datové sady: Pouze adaptivní (vzorkované) datové sady.
• Podporovaná pole: Vše sum a count pole.
• Použití: Spolehlivost level musí být zadán jako desetinné číslo mezi 0 a 1 (například,0.90, 0.95, 0.99).
• Výchozí: Pokud není zadána úroveň spolehlivosti, intervaly se nevracejí.

Následující příklad ukazuje, jak dotazovat interval spolehlivosti a jak interpretovat odpověď.

Chcete-li požádat o interval spolehlivosti, použijte confidence(level: X) argument ve vašem dotazu.

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
          }
        }
      }
    }
  }
}

Odpověď obsahuje následující hodnoty:

• estimate: Odhadovaná hodnota na základě vzorkovaných dat.
• lower: Dolní hranice intervalu spolehlivosti.
• sampleSize: Počet vzorkovaných datových bodů použitých k výpočtu odhadu.
• upper: Horní hranice intervalu spolehlivosti.

V tomto příkladu odpověď znamená, že na základě vzorku 40,054 je odhadovaný počet událostí 42,939, přičemž s 95% spolehlivostí leží skutečná hodnota mezi 42,673 a 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
}