データセット（テーブル）

Cloudflare Analytics では、汎用と製品固有の両方を含む、さまざまなデータセットを提供しています。データセットは、返すデータの種類を明示する一貫した命名規則に従います。

ドメイン — 各データセットは、説明するフィールドにちなんで名付けられ、一連のノードに関連付けられます。製品固有のデータノードには、関連製品の名前が含まれます。例: loadBalancingRequests* ノード。
適応型サンプリング — 適応型サンプリングで取得したデータを表すノードには、Adaptive サフィックスが付きます。詳細はサンプリングを参照してください。
集計データ — 集計データを表すノードには、Groups サフィックスが付きます。たとえば、loadBalancingRequestsAdaptiveGroups ノードは Load Balancing リクエストの集計データを表します。集計データは ...Group オブジェクトの配列として返されます。現時点では、この命名規則から外れているノードがあります。workersInvocationsAdaptive（ベータ）です。
生データ — loadBalancingRequestsAdaptive のような生データノードは集計されないため、Groups サフィックスは付きません。生データは、該当するデータ型のオブジェクトを含む配列として返されます。たとえば、loadBalancingRequestsAdaptive へのクエリは、さまざまな LoadBalancingRequest オブジェクトを返します。

データセット、提供状況、ベータ、非推奨の状態について詳しくは、GraphQL のディスカバリー機能を参照してください。

データセットの扱い

集計フィールド

この例は、Groups の構造を示します。

type WhateverGroup {
    count # No subfields, it is just the group size. Not available for roll-up tables.
    sum {
        # fields that support summing (numbers, maps of numbers)
    }
    avg {
        # fields that support averaging (numbers)
    }
    uniq {
        # fields that support uniqueing (numbers, strings, enums, IPs, dates, etc.)
    }
}

ユニーク値はディメンションとしては使えませんが、次の例のようにクエリできます。

{
  # Get number of bytes and unique IPs in each minute.
  httpRequests1mGroups {
    sum {
      bytes
    }
    uniq {
      uniques # unique IPs
    }
    dimensions {
      datetimeMinute
    }
  }

  # Count the number of events in each hour.
  firewallEventsAdaptiveGroups {
    count
    dimensions {
      datetimeHour
    }
  }
}

スキーマの型定義

公開されている各テーブルには、GraphQL の型定義があります。型定義は次の規則に従います。

通常のフィールドは、そのフィールド自身を表します。
ネストされたフィールドを含むすべてのフィールドには型があり、その型のリストを表します。
enum 型は列挙フィールドを表します。

ContentTypeMapElem の型定義の例です。

type ContentTypeMapElem {
    edgeResponseContentType: UInt32!
    requests: UInt64!
    bytes: UInt64!
}

# An array of httpRequestsGroup is the result of httpRequests1hGroups or
# httpRequests1mGroups query.
type httpRequestsGroup {
    date: Date!
    timeslot: DateTime!
    requests: UInt64!
    contentTypeMap: [ContentTypeMapElem!]!
    # ... other fields
}

enum TrustedClientCategory {
    UNKNOWN
    REAL_BROWSER
    HONEST_BOT
}

# An array of Request is the result of httpRequests query.
type Request {
    trustedClientCategory: TrustedClientCategory!
    # ... other fields
}