この例では、GraphQL Analytics API を使い、特定期間のホスト名ごとの HTTP イベントについて集計指標をクエリします。
次の API 呼び出しは、カスタムホスト名 hostname.example.com について、4 日間の訪問数とエッジレスポンスバイト数を要求します。CLOUDFLARE_ZONE_TAG と API_TOKEN1 をゾーン ID と API 認証情報に置き換え、必要に応じて datetime_geq と datetime_leq の値を調整してください。
echo '{ "query":
"query RequestsAndDataTransferByHostname($zoneTag: string, $filter:filter) {
viewer {
zones(filter: {zoneTag: $zoneTag}) {
httpRequestsAdaptiveGroups(limit: 10, filter: $filter) {
sum {
visits
edgeResponseBytes
}
dimensions {
datetimeHour
}
}
}
}
}",
"variables": {
"zoneTag": "<CLOUDFLARE_ZONE_TAG>",
"filter": {
"datetime_geq": "2022-07-20T11:00:00Z",
"datetime_lt": "2022-07-24T12:00:00Z",
"clientRequestHTTPHost": "hostname.example.com",
"requestSource": "eyeball"
}
}
}' | tr -d '\n' | curl --silent \
https://api.cloudflare.com/client/v4/graphql \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data @- | jq .返る結果は（要求どおり）JSON 形式なので、出力を jq に渡すと読みやすくなります。次の例のとおりです。
{
"data": {
"viewer": {
"zones": [
{
"httpRequestsAdaptiveGroups": [
{
"dimensions": {
"datetimeHour": "2022-07-21T10:00:00Z"
},
"sum": {
"edgeResponseBytes": 19849385,
"visits": 4383
}
},
{
"dimensions": {
"datetimeHour": "2022-07-21T06:00:00Z"
},
"sum": {
"edgeResponseBytes": 20607204,
"visits": 4375
}
},
{
"dimensions": {
"datetimeHour": "2022-07-26T05:00:00Z"
},
"sum": {
"edgeResponseBytes": 20170839,
"visits": 4519
}
},
{
"dimensions": {
"datetimeHour": "2022-07-23T08:00:00Z"
},
"sum": {
"edgeResponseBytes": 20141860,
"visits": 4448
}
},
{
"dimensions": {
"datetimeHour": "2022-07-25T15:00:00Z"
},
"sum": {
"edgeResponseBytes": 21070367,
"visits": 4469
}
},
{
"dimensions": {
"datetimeHour": "2022-07-28T08:00:00Z"
},
"sum": {
"edgeResponseBytes": 19200774,
"visits": 4345
}
},
{
"dimensions": {
"datetimeHour": "2022-07-26T02:00:00Z"
},
"sum": {
"edgeResponseBytes": 20758067,
"visits": 4502
}
},
{
"dimensions": {
"datetimeHour": "2022-07-20T19:00:00Z"
},
"sum": {
"edgeResponseBytes": 22127811,
"visits": 4443
}
},
{
"dimensions": {
"datetimeHour": "2022-07-27T15:00:00Z"
},
"sum": {
"edgeResponseBytes": 20480644,
"visits": 4268
}
},
{
"dimensions": {
"datetimeHour": "2022-07-27T17:00:00Z"
},
"sum": {
"edgeResponseBytes": 19885704,
"visits": 4287
}
}
]
}
]
}
},
"errors": null
}GraphQL Analytics API を使い、ゾーン内で消費が多い URL の上位 10 件をクエリし、リソース使用量が最も多い URL を特定します。設定手順は次のとおりです。
- 特定のホスト名で絞り込む場合は、
"requestSource"の下に"clientRequestHTTPHost": "'$2'"を追加します。 API_TOKENを、Read all resources権限で生成した API トークンに置き換えます。スクリプトは、トークン作成者がアクセスできるゾーンにだけアクセスします。- ゾーン ID（
zoneTag）をパラメーターARG=$1として渡します。 - 現在の日付と 30 日前の日付を計算するには、Mac では
gdateを使います。CURRENTDATE=$(gdate -u +'%FT%TZ')OLDDATE=$(gdate -d '-30 days' -u +'%FT%TZ')。
- 直近 30 日以内の特定日付にする場合は、
CURRENTDATEとOLDDATEを"YYYY-MM-DDTHH:MM:SSZ"形式で設定します。
curl --silent \
https://api.cloudflare.com/client/v4/graphql \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
"query": "{viewer {zones(filter: {zoneTag: $zoneTag}) {topPaths: httpRequestsAdaptiveGroups(filter: $filter, limit: 10, orderBy: [sum_edgeResponseBytes_DESC]) {count sum {edgeResponseBytes} dimensions {metric: clientRequestPath}}}}}",
"variables": {
"zoneTag": "'$ARG'",
"filter": {
"AND": [
{
"datetime_geq": "'$OLDDATE'",
"datetime_leq": "'$CURRENTDATE'"
},
{
"requestSource": "eyeball"
}
]
}
}
}' | jq -r 'try .data.viewer.zones[].topPaths[] | "\"\(.dimensions.metric)\": \(.sum.edgeResponseBytes)"' | sort-
設定と権限の詳細は Analytics API トークンを設定する を参照してください。 ↩