← Analytics / analytics / graphql-api / tutorials

Dotazování HTTP událostí podle hostname pomocí GraphQL

Agregované metriky HTTP podle názvu hostitele v čase

V tomto příkladu použijeme GraphQL Analytics API k dotazování agregovaných metrik o HTTP událostech podle hostitele za konkrétní časové období.

Následující volání API požádá o počet návštěv a počet bajtů odpovědi na okraji sítě pro vlastní hostname hostname.example.com za období čtyř dnů. Nezapomeňte nahradit CLOUDFLARE_ZONE_TAG a API_TOKEN¹ svým ID zóny a API přihlašovacími údaji a upravte datetime_geq a datetime_leq hodnoty dle potřeby.

Volání API

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 .

Vrácené výsledky budou ve formátu JSON (dle požadavku), proto výstup můžete přesměrovat rourou do jq je usnadní čtení, jako v následujícím příkladu:

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

10 nejvíce zatěžujících URL adres v zóně

K dotazování na 10 nejvíce zatěžujících URL adres v rámci zóny použijeme GraphQL Analytics API, což vám pomůže identifikovat adresy URL s nejvyšší spotřebou prostředků. Zde najdete pokyny ke konfiguraci:

Chcete-li filtrovat podle konkrétního názvu hostitele, přidejte řádek "clientRequestHTTPHost": "'$2'" níže "requestSource"."
Nahraďte API_TOKEN svým vygenerovaným API tokenem pomocí Read all resources oprávnění. Skript bude přistupovat pouze k zónám dostupným tvůrci tokenu.
Zadejte ID zóny (zoneTag) jako parametr ARG=$1.
Chcete-li vypočítat aktuální datum a datum před 30 dny, použijte gdate na Macu:
- CURRENTDATE=$(gdate -u +'%FT%TZ')
- OLDDATE=$(gdate -d '-30 days' -u +'%FT%TZ').
Pro konkrétní data v posledních 30 dnech nastavte CURRENTDATE a OLDDATE proměnné ve formátu "YYYY-MM-DDTHH:MM:SSZ".

volání API

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

Poznámky pod čarou

Viz Nakonfigurujte token Analytics API kde najdete další informace o konfiguraci a oprávněních. ↩