← Analytics / analytics

GraphQL Analytics API

GraphQL Analytics API poskytuje data o požadavcích HTTP procházejících sítí Cloudflare a také data z konkrétních produktů, jako je Firewall nebo Load Balancing. Uživatelé Network Analytics mají navíc přístup k datům na úrovni paketů. Pomocí GraphQL Analytics API můžete vybírat konkrétní datové sady a metriky, filtrovat a agregovat data podle různých dimenzí a výsledky integrovat s dalšími aplikacemi.

Základem API je Framework GraphQL ↗, kterou vytvořil a jako open-source zveřejnil Facebook. Kolem GraphQL existuje aktivní vývojářská komunita a řada výkonných klientů pro spouštění dotazů, takže se s GraphQL snadno začíná. GraphQL se výborně hodí pro tvorbu vizualizací a pohání analytiku v dashboardu Cloudflare.

GraphQL modeluje obchodní doménu jako graf pomocí schématu. Ve schématu jsou definovány jednotlivé typy uzlů a jejich propojení (hrany). Tyto uzly představují datové sady, které používáte pro analýzu. Dotazy v GraphQL píšete podobně jako v SQL: určíte datovou sadu (tabulku), metriky, které chcete získat (například požadavky a bajty), a filtrujete nebo seskupujete podle dimenzí (například časového období).

GraphQL se od tradičního API liší: má jediný koncový bod:

https://api.cloudflare.com/client/v4/graphql

Parametry dotazu předáte jako objekt JSON v payloadu POST požadavek na tento endpoint.

Můžete použít curl k odesílání požadavků do GraphQL Analytics API. Případně můžete k sestavování dotazů a odesílání požadavků do GraphQL Analytics API použít klienta GraphQL.

Používáme GraphiQL ↗ pro naše ukázkové dotazy GraphQL. Existuje řada dalších oblíbených open source klientů, které najdete online, například Altair ↗ a Insomnia ↗.

Účelem GraphQL API je poskytovat agregovanou analytiku pro různé produkty Cloudflare. Tyto datové sady by neměly sloužit jako podklad pro měření využití, které Cloudflare používá pro účely fakturace. Fakturovaný provoz nezahrnuje například provoz DDoS útoků ↗, zatímco GraphQL měří celkovou spotřebu neboli využití, takže zahrnuje veškerý měřitelný provoz.