← Cloudflare DNS / dns / reference
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
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
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).
Filtrovací operátory
| 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 |
Kombinování filtrů
Kombinujte filtry pomocí OR a AND booleovskou logiku:
-
ANDmá přednost předORve všech výrazech. -
ORoperátor je definován pomocí čárky,neboORklíčové slovo obklopené bílými znaky. -
ANDoperátor je definován pomocí středníku;neboANDklíčové slovo obklopené bílými znaky.
Příklady s použitím OR
responseCode==NOERROR,responseCode==NXDOMAINznačí, že kód odpovědi je buďNOERRORneboNXDOMAIN.coloName==SJC OR coloName==LAXznačí dotazy buď vSJCneboLAX.
Příklady s použitím AND
responseCode==NOERROR;queryType==AAAAznačí, že kód odpovědi jeNOERRORa typ dotazu jeAAAA.queryType==AAAA AND coloName==SJCznačíAAAAdotazy vSJC.