← Cloudflare Spectrum / spectrum / reference

Analytics

Cloudflare měří pro každé připojení následující metriky.

Metrika	Název	Příklad	Jednotka
count	Celkový počet událostí	`1000`	Počet
bytesIngress	Součet příchozích bajtů	`1000`	Součet
bytesEgress	Součet odchozích bajtů	`1000`	Součet
durationAvg	Průměrná doba trvání připojení	`1.0`	Čas v milisekundách
durationMedian	Medián doby trvání připojení	`1.0`	Čas v milisekundách
duration90th	90. percentil doby trvání připojení	`1.0`	Čas v milisekundách
duration99th	99. percentil doby trvání připojení	`1.0`	Čas v milisekundách

Další dimenze

Svou analytiku můžete dále rozdělit podle následujících dimenzí.

Dimenze	Název	Příklad
událost	Událost připojení	`connect`, `progress`, `disconnect`, `originError`, `clientFiltered`
appID	Application ID	`40d67c87c6cd4b889a4fd57805225e85`
coloName	Název Colo	`SFO`
ipVersion	Verze IP protokolu používaná klientem	`4`, `6`

Operátory pro filtrování

K filtrování dat použijte níže uvedené operátory.

Operátor	Název	Kódováno v URL
`==`	Rovná se	`%3D%3D`
`!=`	Nerovná se	`!%3D`
`>`	Greater Than	`%3E`
`<`	Menší než	`%3C`
`>=`	Větší nebo rovno	`%3E%3D`
`<=`	Less than or equal to	`%3C%3D`

Kombinujte filtry pomocí OR a AND booleovskou logiku:

AND má přednost před OR ve všech výrazech.
OR operátor je definován pomocí čárky , nebo OR klíčové slovo obklopené bílými znaky.
AND operátor je definován pomocí středníku ; nebo AND klíčové slovo obklopené bílými znaky.

Poznámka
Poznámka
Mějte na paměti, že středník je v URL vyhrazený znak (RFC 1738 ↗) a měl by být percent-encoded jako %3B.

Struktura požadavku Analytics

/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 představuje jednu nebo více metrik (například count), které se mají vypočítat
DIMENSIONS lze použít k rozdělení dat podle zadaných atributů
FILTERS slouží k filtrování řádků podle jedné nebo více dimenzí (viz část Filters níže)
SORT určuje pořadí řazení výsledné sady; pole pro řazení musí být zahrnuta v METRICS nebo DIMENSIONS
TO_TS je konec časového intervalu, který se má dotazovat, výchozí hodnotou je aktuální čas
FROM_TS je začátek časového intervalu dotazu, výchozí hodnota je TO_TS - 6 hodin
STEP se používá k výběru rozlišení časové řady při použití endpointu:
auto nebo neuvedeno - zvolí časový krok nejvhodnější pro daný časový interval
- rok
- čtvrtletí
- month
- týden
- day
- hour

Příklad dotazu Analytics

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:

Analytics Read

Získat souhrn analytiky

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/analytics/events/summary" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Viz Dokumentace Spectrum API s dalšími příklady API požadavků.