このページでは、DNS analytics API へのリクエストで使える API プロパティを説明します。
メトリクスは、データの属性に基づく数値です。例としてクエリ数があります。
API リクエストでは、メトリクスを metrics パラメーターに指定します。複数のメトリクスを列挙する場合は、カンマで区切ります。
| メトリクス | 名前 | 例 | 単位 |
|---|---|---|---|
| queryCount | クエリ数 | 1000 |
回数 |
| uncachedCount | キャッシュなしクエリ数 | 1 |
回数 |
| staleCount | 古いクエリ数 | 1 |
回数 |
| responseTimeAvg | 平均応答時間 | 1.0 |
ミリ秒 |
| responseTimeMedian | 応答時間の中央値 | 1.0 |
ミリ秒 |
| responseTime90th | 応答時間の 90 パーセンタイル | 1.0 |
ミリ秒 |
| responseTime99th | 応答時間の 99 パーセンタイル | 1.0 |
ミリ秒 |
ディメンションを使うと、指定した属性でデータを分解できます。
API リクエストでは、ディメンションを dimensions パラメーターに指定します。複数のディメンションを列挙する場合は、カンマで区切ります。
| ディメンション | 名前 | 例 | 備考 |
|---|---|---|---|
| queryName | クエリ名 | example.com |
|
| queryType | クエリタイプ | AAAA |
IANA が定義するタイプ ↗。不明なタイプは空です。 |
| responseCode | 応答コード | NOERROR |
IANA が定義する応答コード ↗。常に大文字です。 |
| responseCached | 応答のキャッシュ状態 | Cached |
Cached または Uncached のいずれかです。 |
| coloName | Colo 名 | SJC |
PoP コードです。 |
| origin | オリジン | 2001:db8::1 |
クエリの解決に使ったオリジンです。該当なし、またはキャッシュから応答した場合は空です。 |
| dayOfWeek | 曜日 | 1 |
曜日で分解します。月曜日が 1、日曜日が 7 です。 |
| tcp | TCP | 1 |
使用プロトコルに応じて 1 または 0 です。 |
| ipVersion | IP バージョン | 6 |
使用した IP プロトコルバージョンです（現在は 4 または 6）。 |
| querySizeBucket | クエリサイズバケット | 16-31 |
16 の倍数によるクエリサイズバケットです。 |
| responseSizeBucket | 応答サイズバケット | 16-31 |
16 の倍数による応答サイズバケットです。 |
フィルターは dimension operator expression の形式です。各部分の意味は次のとおりです。
- ディメンション: フィルター対象の ディメンション を指定します。例:
queryName。 - 演算子: 使うフィルター一致の種類を定義します。演算子はディメンションごとに異なります。
- 式: 結果に含める、または除外する値を示します。式は正規表現（regex）構文を使います。
| 演算子 | 名称 | 例 | 説明 | URL エンコード |
|---|---|---|---|---|
== |
等しい | queryName==example.com |
queryName が example.com と完全に一致する結果を返します。 |
%3D%3D |
!= |
等しくない | responseCode!=NOERROR |
responseCode が NOERROR と異なる結果を返します。 |
!%3D |
> |
より大きい | dimension>1000 |
ディメンションが 1000 より大きい結果を返します。 |
%3E |
< |
より小さい | dimension<1000 |
ディメンションが 1000 より小さい結果を返します。 |
%3C |
>= |
以上 | dimension>=1000 |
ディメンションが 1000 以上の結果を返します。 |
%3E%3D |
<= |
以下 | dimension<=1000 |
ディメンションが 1000 以下の結果を返します。 |
%3C%3D |
フィルターは、OR と AND のブール論理で組み合わせます。
-
すべての式で、
ANDはORより優先されます。 -
OR演算子は、カンマ,または前後に空白を付けたORキーワードで指定します。 -
AND演算子は、セミコロン;または前後に空白を付けたANDキーワードで指定します。
OR を使う例
responseCode==NOERROR,responseCode==NXDOMAINは、応答コードがNOERRORまたはNXDOMAINであることを示します。coloName==SJC OR coloName==LAXは、SJCまたはLAXのクエリを示します。
AND を使う例
responseCode==NOERROR;queryType==AAAAは、応答コードがNOERRORかつクエリタイプがAAAAであることを示します。queryType==AAAA AND coloName==SJCは、SJCのAAAAクエリを示します。