フィルター¶
エクスプローラーでは、フィールド名とフィールド値を指定してデータをフィルタリングできます。
注意
フィルターと検索の最大の違いは、入力内容に :(コロン区切り文字) が含まれているかどうかです。含まれている場合はフィルター条件、含まれていない場合は検索条件と見なされます。
演算子¶
フィールドのタイプによってサポートされる演算子は異なります。詳細は以下の通りです。
-
文字列フィールドの演算子:
=、≠、match、not match、wildcard、not wildcard、exist、not exist、regexp、not regexp -
数値フィールドの演算子:
=、≠、>、>=、<、<=、[xx TO xx]、exist、not exist
| 演算子 | 説明 |
|---|---|
= |
等しい、例:attribute:value |
≠ |
等しくない、例:-attribute:value |
match |
含む、例:attribute:~value |
not match |
含まない、例:-attribute:~value |
wildcard |
ワイルドカードを含む、ワイルドカードと組み合わせてあいまい検索、例:attribute:*value* |
not wildcard |
ワイルドカードを含まない、ワイルドカードと組み合わせて否定あいまい検索、例:-attribute:*value* |
exist |
存在する、指定したフィールドが存在するデータをフィルタリング、例:attribute:* |
not exist |
存在しない、指定したフィールドが存在しないデータをフィルタリング、例:-attribute:* |
regexp |
正規表現マッチ、正規表現を使用して対象文字列にマッチ、例:attribute:/value.*/ |
not regexp |
否定正規表現マッチ、対象文字列を使用して正規表現にマッチ、例:-attribute:/value.*/ |
> |
より大きい、例:attribute:>value |
>= |
以上、例:attribute:>=value |
< |
より小さい、例:attribute:<value |
<= |
以下、例:attribute:<=value |
[xx - xx] |
範囲、例:attribute:[1 - 100] |
Wildcard(ワイルドカード)¶
* または ? ワイルドカードをサポートします。それぞれの意味は以下の通りです。
*は0個以上の任意の文字にマッチ?は1個の任意の文字にマッチ
例:
値:platform
# 接尾辞のみ*でマッチ、値の接頭辞が固定で正確で、後半が動的に変化する場合に有効
attribute:plat* // * は form にマッチ
# ? のみでマッチ、一部の固定位置の文字のみが動的に更新される場合に有効
attribute:plat?orm // ? は f にマッチ
# ? と * を組み合わせて使用
attribute:pla?for* // ? は t にマッチ、* は m にマッチ
# * を組み合わせて使用
attribute:plat*or* // 最初の * は f にマッチ、2番目の * は m にマッチ
特殊文字¶
エクスプローラーでは、一部の文字に特別な意味があります。例えば、スペースは複数の単語を区切るために使用されます。検索内容に以下の特殊文字が含まれる場合は、特別な処理が必要です:スペース、:、"、"、\、(、)、[、]、{、}。
詳細については、特殊文字のエスケープクエリ を参照してください。
ブール演算子¶
AND/OR/NOT 形式で検索とフィルターをさらに組み合わせて関連付けることができます。
| 論理関係 | 説明 |
備考 |
|---|---|---|
| a AND b | 前後のクエリ結果の積集合を取得 | 検索条件とフィルター条件の間はデフォルトで AND で接続されます。AND はスペースで代用可能です。つまり、a AND b = a b となります。 |
| a OR b | 前後のクエリ結果の和集合を取得 | 結果は a または b のいずれかのキーワードを含む必要があります。例:a OR b:value |
| NOT c | 現在のクエリ結果を除外 | NOT は主に検索記述で使用され、フィルターでの除外ロジックは ≠ で代用します。 |
グループ化¶
括弧 () を使用して、データクエリ条件の優先順位を高めます。クエリに括弧が含まれる場合、括弧内のクエリロジックが優先的に実行されます。括弧内のクエリ優先順位は、引き続き NOT > AND > OR の順序で実行されます。
手書きモード¶
検索ボックスを手書きモードに切り替えることができます。
すべてのエクスプローラー(ダッシュボード/カスタムエクスプローラーを除く)でサポートされています。このモードでは、UI 操作で検索条件とフィルター条件を追加でき、手書きモードと UI モードを自由に切り替えても、切り替え前の内容は一切変更されず、UI と手書き入力のリアルタイムな切り替えと復元が可能です。
クイックフィルター¶
エクスプローラーでは、クイックフィルターを編集して新しいフィルターフィールドを追加できます。2つの設定方法をサポートしています。
管理者またはオーナーが設定できます。
ワークスペースの全メンバーが閲覧できますが、一般メンバーと標準メンバーは編集、削除、移動ができません。
注意
ここでフィルターフィールドを設定すると、システムが自動的にインデックスフィールドとして設定します。その後、検索バーで直接再利用できます。
全メンバーがローカルブラウザベースのクイックフィルター項目を設定できます。
現在のユーザーのみに表示され、ワークスペースの他のメンバーは閲覧できません。
クイックフィルターでは、フィールドを事前設定できます。新しく追加されたフィールドは、デフォルトでフィールド管理で使用されているフィールドタイプを使用します。フィールド管理にそのフィールドが存在しない場合は、デフォルトでテキスト形式になります。
フィールド編集画面に入ると、2つのフィールドグループが表示されます。
- フィルターフィールド:クイックフィルターに表示されるフィールド
- オプションフィールド:現在のデータタイプにキャッシュされているすべてのフィールド
以下の操作が可能です。
- フィールドの検索;クエリ結果に完全一致する値がない場合は、直接作成して「フィルターフィールド」に追加できます。
- フィールドエイリアスの編集;
- ドラッグしてフィールドの順序を調整;
- フィールドの削除;
- フィールドエイリアスの表示/非表示の設定。
空値フィルター¶
管理者がグローバル設定で空値フィルターを有効にすると、クイックフィルターの各グループの下部に「データなし」エントリが表示され、このフィールドの値が空のデータをフィルタリングできます。クリックすると、対応するフィールドに値が存在しないデータエントリをフィルタリングできます。
関連操作¶
パフォーマンスを最適化するため、クイックフィルター項目はクエリ条件(時間範囲、検索フィルターなど)の変更に伴って自動的に更新されません。対応するフィルター項目を手動で展開して、データをロードまたは更新する必要があります。
更新ルール:
-
初期ロード:エクスプローラーに入ると、すべてのフィルター項目はデフォルトで折りたたまれています。一部のよく使われるフィルター項目(
service、statusなど)はデフォルトで展開され、現在のリストデータが一度ロードされます。 -
手動更新:時間範囲、検索条件、またはフィルター条件を調整した後、展開済みのフィルター項目のデータは自動的に更新されません。最新のオプションリストを表示する必要がある場合は、一時的に折りたたんでから再度展開してください。
-
独立した更新:ページ上部のグローバル更新ボタン、および時間ウィジェット横の自動更新頻度設定(例:5s、30s)は、エクスプローラーのメインリストのデータ更新にのみ影響し、クイックフィルターパネル内の各オプションのデータ状態には影響しません。
タグ値の行をクリックすると、その値が単一選択されます(この値のみ選択)。複数選択する場合は、他の値のチェックボックスをオンにします。単一選択された値をもう一度クリックすると、その値の選択が解除され、同時にすべてのフィルターが解除されます。
クイックフィルター項目のフィールド属性値が 10 個を超える場合、テキストを入力してリアルタイム検索できます。また、あいまいマッチボタンまたは否定あいまいマッチボタンをクリックしてフィルタリングすることもできます。
エクスプローラーのクイックフィルターに duration(持続時間)フィールドが含まれている場合、最大値と最小値を手動で調整してクエリ分析を行うことができます。
- デフォルトでは、プログレスバーの最小値と最大値は、それぞれ分散型トレーシングデータリスト内の最小および最大持続時間です。
- 入力形式が正しくない場合、入力ボックスが赤くなり、検索は実行されません。正しい入力形式は、純粋な「数字」、または「数字+ns/μs/ms/s/min」です。
- 単位を指定せずに検索した場合、システムは入力された数字の後にデフォルトで "s" を追加してフィルタリング検索を実行します。
- 手動で単位を入力した場合は、入力された単位に従って直接検索が実行されます。
フィルター履歴¶
フィルターと検索の履歴を表示でき、現在のワークスペースの異なるエクスプローラーに適用できます。エクスプローラー上部の検索バー右側のアイコンをクリックするか、ショートカットキー (Mac OS: shift+cmd+k / Windows: shift+ctrl+k) を使用してフィルター履歴をすばやく開きます。
注意
フィルター履歴は、ローカルブラウザでのみ現在のユーザーのフィルター条件と検索条件を表示できます。
関連操作¶
エクスプローラーのフィルター履歴では、最大 100 件のフィルター条件を表示できます。
- フィルターに固定:右側のフィルターに固定ボタンをクリックすると、フィルター条件を先頭に固定できます。
- フィルターに追加:フィルター条件を直接クリックすると、エクスプローラーに追加されてフィルタリングされます。複数選択もサポートしています。
- 異なるエクスプローラーでのフィルター履歴の適用:例えば、ログ > エクスプローラーで
-source:defaultというフィルター履歴を参照した場合、分散型トレーシングなど他のエクスプローラーでもこのフィルター条件を直接使用できます。







