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 | Colo 名 | SFO |
| ipVersion | クライアントが使う IP バージョン | 4, 6 |
次の演算子でデータを絞り込みます。
| 演算子 | 名前 | URL エンコード |
|---|---|---|
== |
等しい | %3D%3D |
!= |
等しくない | !%3D |
> |
より大きい | %3E |
< |
より小さい | %3C |
>= |
以上 | %3E%3D |
<= |
以下 | %3C%3D |
フィルターは、OR と AND のブール論理で組み合わせます。
-
すべての式で、
ANDはORより優先されます。 -
OR演算子は、カンマ,または前後に空白を付けたORキーワードで指定します。 -
AND演算子は、セミコロン;または前後に空白を付けたANDキーワードで指定します。
/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
Required API token permissions
At least one of the following token permissions is required:Analytics Read
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/analytics/events/summary" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"詳細な API リクエストの例は、Spectrum API ドキュメント を参照してください。