検索構文

クエリフィルターは条件と演算子で構成されます。

条件には 2 種類あります。

複合クエリで複数の条件を組み合わせるには、以下のブール演算子を使用します。


演算子	説明	例
`AND`	積: 両方の条件を含むイベントが選択されます (何も追加しなければ、AND がデフォルトで採用されます)。	authentication AND failure
`OR`	和: いずれかの条件を含むイベントが選択されます。	authentication OR password
`-`	排他: 後続の条件はイベントに含まれません。	authentication AND -password

オートコンプリート

検索バーのオートコンプリート機能を使用すると、既存の値を使用してクエリを完成させることができます。

+ - = && || > < ! ( ) { } [ ] ^ " “ ” ~ * ? : \、および / は特殊文字と見なされ、\ 文字を使用してエスケープする必要があります。

メッセージ属性に user=JaneDoe を含むログを見つけるには、次の検索を使用します。

user\=JaneDoe

特定の属性を検索するには、まずそれをファセットとして追加し、次に @ を追加してファセット検索を指定します。

たとえば、ファセット名が url で、url の値 www.datadoghq.com で絞り込む場合は、次のように入力します。

@url:www.datadoghq.com

注:

ファセット検索では大文字と小文字が区別されます。大文字と小文字を区別したくない場合はフリーテキスト検索を使用してください。または、Grok パーサーでのパース実行中に lowercase フィルターを適用すれば、文字の種類に関わらない検索結果を得ることができます。
特殊文字を含むファセット値で検索する場合は、エスケープ処理または二重引用符が必要です。ログのファセット名にスペースが含まれる場合も同じです。ログファセットにスペースを入れるべきではありませんが、含まれている場合は、スペースをエスケープする必要があります。ファセットの名前が user.first name の場合、ファセット検索を行うには、@user.first\ name:myvalue のようにスペースをエスケープします。

例:

検索クエリ	説明
`@http.url_details.path:"/api/v1/test"`	属性 `http.url_details.path` に `/api/v1/test` と一致するすべてのログを検索します。
`@http.url:\/api\/v1\/*`	属性 `http.url` に、`/api/v1/` で始まる値を含むすべてのログを検索します。
`@http.status_code:[200 TO 299] @http.url_details.path:\/api\/v1\/*`	200 から 299 の `http.status_code` 値を含み、`http.url_details.path` 属性に `/api/v1/` で始まる値を含むすべてのログを検索します。