アナリティクス

Cloudflareは、すべての接続に対して以下のメトリックを測定します。

メトリック	名前	例	単位
count	総イベント数	1000	カウント
bytesIngress	受信バイトの合計	1000	合計
bytesEgress	送信バイトの合計	1000	合計
durationAvg	平均接続時間	1.0	ミリ秒単位の時間
durationMedian	中央接続時間	1.0	ミリ秒単位の時間
duration90th	90パーセンタイルの接続時間	1.0	ミリ秒単位の時間
duration99th	99パーセンタイルの接続時間	1.0	ミリ秒単位の時間

追加の次元

以下の次元でアナリティクスをさらに分割できます。

次元	名前	例
event	接続イベント	connect, progress, disconnect, originError, clientFiltered
appID	アプリケーションID	40d67c87c6cd4b889a4fd57805225e85
coloName	コロケーション名	SFO
ipVersion	クライアントが使用するIPバージョン	4, 6

フィルタリングのための演算子

以下の演算子を使用してデータをフィルタリングします。

演算子	名前	URLエンコード
==	等しい	%3D%3D
!=	等しくない	!%3D
>	より大きい	%3E
<	より小さい	%3C
>=	より大きいか等しい	%3E%3D
<=	より小さいか等しい	%3C%3D

Combine filters using OR and AND boolean logic:

• AND takes precedence over OR in all expressions.

• The OR operator is defined using a comma , or the OR keyword surrounded by whitespace.

• The AND operator is defined using a semicolon ; or the AND keyword surrounded by whitespace.

  ノート

  Note that the semicolon is a reserved character in URLs (RFC 1738 ↗) and should be percent-encoded as %3B.

アナリティクスリクエスト構造

/api/v4/zones/{zone_id}/spectrum/analytics/events/summary?metrics=METRICS&dimensions=DIMENSIONS&filters=FILTERS&since=FROM_TS&sort=SORT&until=TO_TS&limit=LIMIT
/api/v4/zones/{zone_id}/spectrum/analytics/events/bytime?metrics=METRICS&dimensions=DIMENSIONS&filters=FILTERS&since=FROM_TS&sort=SORT&until=TO_TS&limit=LIMIT

• METRICSは計算する1つ以上のメトリック（例：count）
• DIMENSIONSは指定された属性でデータを分解するために使用できます
• FILTERSは1つ以上の次元で行をフィルタリングするために使用されます（下記のフィルタセクションを参照）
• SORTは結果セットのソート順; ソートフィールドはMETRICSまたはDIMENSIONSに含める必要があります
• TO_TSはクエリする時間間隔の終了時刻で、デフォルトは現在の時間
• FROM_TSはクエリする時間間隔の開始時刻で、デフォルトはTO_TS - 6時間
• STEPはエンドポイントを使用する際に時間系列の解像度を選択するために使用されます:
• autoまたは省略 - 時間間隔に最も適した時間ステップを選択
  • year
  • quarter
  • month
  • week
  • day
  • hour

アナリティクスクエリの例

curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/spectrum/analytics/events/summary?metrics=count&dimensions=event,appID&since=2018-01-01T16:57:00Z" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>"

APIリクエストのさらなる例については、Spectrum APIドキュメントを参照してください。