Vlastnosti Analytics API

Tato stránka popisuje vlastnosti API, které můžete použít v požadavcích na DNS Analytics API.

Metriky

Metrika je číselná hodnota vycházející z určitého atributu dat, například počtu dotazů.

V API požadavcích se metriky nastavují v metrics parametr. Pokud potřebujete uvést více metrik, oddělte je čárkami.

Metrika	Název	Příklad	Jednotka
queryCount	Počet dotazů	`1000`	Počet
uncachedCount	Počet dotazů mimo cache	`1`	Počet
staleCount	Počet zastaralých dotazů	`1`	Počet
responseTimeAvg	Průměrná doba odezvy	`1.0`	Čas v milisekundách
responseTimeMedian	Medián doby odezvy	`1.0`	Čas v milisekundách
responseTime90th	Doba odezvy na 90. percentilu	`1.0`	Čas v milisekundách
responseTime99th	Doba odezvy na 99. percentilu	`1.0`	Čas v milisekundách

Dimenze lze použít k rozdělení dat podle zadaných atributů.

V API požadavcích se dimenze nastavují v dimensions parametr. Pokud potřebujete uvést více dimenzí, oddělte je čárkami.

Dimenze	Název	Příklad	Poznámky
queryName	Název dotazu	`example.com`
queryType	Typ dotazu	`AAAA`	Typy definované IANA ↗. Neznámé typy jsou prázdné.
responseCode	Kód odpovědi	`NOERROR`	Kódy odpovědí definované organizací IANA ↗. Vždy velkými písmeny.
responseCached	Odpověď v mezipaměti	`Cached`	Buď `Cached` nebo `Uncached`.
coloName	Název Colo	`SJC`	Kód PoP.
origin	Origin	`2001:db8::1`	Origin, který byl použit k překladu dotazu. Prázdné, pokud není k dispozici nebo pokud byl dotaz zodpovězen z mezipaměti.
dayOfWeek	Day Of Week	`1`	Rozdělení podle dne v týdnu. Pondělí je `1`, a neděle je `7`.
tcp	TCP	`1`	Buď `1` nebo `0` v závislosti na použitém protokolu.
ipVersion	IP verze	`6`	Použitá verze protokolu IP (aktuálně `4` nebo `6`).
querySizeBucket	Kategorie velikosti dotazu	`16-31`	Kategorizace velikosti dotazu v násobcích 16.
responseSizeBucket	Skupina velikosti odpovědi	`16-31`	Skupina velikosti odpovědi v násobcích 16.

Filtry používají tvar dimension operator expression, kde každá část odpovídá následujícímu:

Dimenze: Určuje dimenze podle kterého chcete filtrovat. Například queryName.
Operátor: Určuje typ shody filtru, který se má použít. Operátory jsou specifické pro jednotlivé dimenze.
Výraz: Udává hodnoty, které se mají ve výsledcích zahrnout nebo vyloučit. Výrazy používají syntaxi regulárních výrazů (regex).

Operátor	Název	Příklad	Popis	Kódováno v URL
`==`	Rovná se	`queryName==example.com`	Vrátit výsledky, kde `queryName` je přesně `example.com`.	`%3D%3D`
`!=`	Nerovná se	`responseCode!=NOERROR`	Vrátit výsledky, kde `responseCode` se liší od `NOERROR`.	`!%3D`
`>`	Větší než	`dimension>1000`	Vrátit výsledky, kde je hodnota dimenze větší než `1000`.	`%3E`
`<`	Less than	`dimension<1000`	Vrátit výsledky, kde je hodnota dimenze menší než `1000`.	`%3C`
`>=`	Větší nebo rovno	`dimension>=1000`	Vrátit výsledky, kde je hodnota dimenze větší nebo rovna `1000`.	`%3E%3D`
`<=`	Less than or equal to	`dimension<=1000`	Vrátit výsledky, kde je hodnota dimenze menší nebo rovna `1000`.	`%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
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.

Příklady s použitím OR

responseCode==NOERROR,responseCode==NXDOMAIN značí, že kód odpovědi je buď NOERROR nebo NXDOMAIN.
coloName==SJC OR coloName==LAX značí dotazy buď v SJC nebo LAX.

Příklady s použitím AND

responseCode==NOERROR;queryType==AAAA značí, že kód odpovědi je NOERROR a typ dotazu je AAAA.
queryType==AAAA AND coloName==SJC značí AAAA dotazy v SJC.