フィルター¶
エクスプローラーでは、フィールド名とフィールド値を指定してデータをフィルター検索できます。
注意
フィルターと検索の最大の違いは、入力内容に :(コロン区切り) が含まれるかどうかです。含まれる場合はフィルター条件、含まれない場合は検索条件とみなされます。
演算子¶
フィールド型によってサポートされる演算子が異なります。詳細は次のとおりです:
-
文字列フィールドの演算子:
=、≠、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など)はデフォルトで展開され、現在のリストデータを1回読み込みます。 -
手動更新:時間範囲、検索条件、またはフィルター条件を調整しても、展開済みのフィルター項目データは自動更新されません。最新の選択肢リストを表示するには、いったん折りたたんでから再度展開してください。
-
独立更新:ページ上部のグローバル更新ボタンと時間ウィジェット横の自動更新頻度設定(5s、30s など)は、エクスプローラーのメインリストのデータ更新にのみ作用し、クイックフィルターパネル内の各選択肢のデータ状態には影響しません。
タグ値の行をクリックすると、その値のみが選択されます(単一選択)。複数選択が必要な場合は、他の値のチェックボックスを引き続きオンにできます。すでにいずれかの値を単一選択している状態で、その値の行をもう一度クリックすると、その値の選択が解除され、同時にすべてのフィルターが解除されます。
エクスプローラーのクイックフィルターに duration(継続時間)フィールドが含まれる場合、最大値と最小値を手動で調整してクエリ分析できます。
- デフォルトでは、プログレスバーの最小値と最大値は、それぞれ分散型トレーシングデータリスト内の最小および最大の継続時間です。
- 入力形式が正しくない場合、入力ボックスが赤くなり、検索は実行されません。正しい入力形式は、純粋な「数値」、または「数値+ns/μs/ms/s/min」です。
- 単位を入力せずに検索した場合、システムはデフォルトで入力した数値の後ろに「s」を追加してフィルター検索します。
- 単位を手動で入力した場合は、入力した単位に従って直接検索します。
フィルター履歴¶
フィルターと検索の履歴を表示でき、現在のワークスペース内のさまざまなエクスプローラーに適用できます。エクスプローラー上部の検索バー右側にあるアイコンをクリックするか、ショートカットキー (Mac OS: shift+cmd+k / Windows: shift+ctrl+k) を使用して、フィルター履歴をすばやく開けます。
注意
フィルター履歴は、ローカルブラウザーで現在のユーザーのフィルター条件と検索条件を表示する場合にのみ対応しています。
関連操作¶
フィルター履歴には、通常の履歴レコードを最大 100 件保持します。
-
フィルターに固定:右側の「フィルターに固定」ボタンをクリックすると、フィルター条件を先頭に固定できます。
-
フィルターに追加:フィルター条件を直接クリックすると、それをエクスプローラーに追加してフィルターできます。複数選択に対応しています。
-
異なるエクスプローラーでフィルター履歴を適用:たとえば、ログ > エクスプローラーで
-source:defaultのフィルター履歴を参照した場合、分散型トレーシングなどの他のエクスプローラーでそのフィルター条件を直接使用できます。
ページ間保持¶
ページ間保持では、選択したフィルター条件を他のエクスプローラーに自動適用できます。ログや分散型トレーシングなどのデータをまたいで同じサービスの問題を調査する場合に適しています。
フィルター履歴で、条件の右側にあるページ間保持の重ねアイコンをクリックすると有効になります。複数の条件を同時に保持できます。有効にすると、条件はすぐに現在のエクスプローラーに適用され、検索バー内の対応する条件の左側に同じマークが表示されます。
この機能をサポートする他のエクスプローラーに移動すると、保持条件と対象ページの既存条件が AND で組み合わされます。つまり、クエリ結果はこれらの条件をすべて満たす必要があります。同一の完全な条件は 1 つだけ保持されます。たとえば、service:api を保持した後、status:error 条件が既にある分散型トレーシングのエクスプローラーに移動すると、クエリ条件は status:error AND service:api になります。
適用範囲:ログ、アプリケーションパフォーマンスモニタリング(APM)、リアルユーザーモニタリング(RUM)、イベントセンター、Synthetic モニタリング、CI 可視化、セキュリティモニタリング、クラウド請求、Agent モニタリングのエクスプローラー、およびカスタムエクスプローラーの表示ページ。
保持設定は、現在のユーザーとログイン中のワークスペースごとにローカルブラウザーに保存され、更新または再表示後に復元されます。ユーザー、ワークスペース、またはブラウザーを切り替えると、それぞれの保持設定が使用されます。
| 操作 | 結果 |
|---|---|
| 履歴内のページ間保持アイコンをもう一度クリックする、または検索バー内の条件左側のマークをクリックする | その条件のページ間保持を解除します。現在のページでは、引き続きその条件が通常のフィルターとして保持されます。 |
| 現在の条件を削除する、編集後の条件を送信する、またはフィルター履歴でフィルターを解除する | 削除された条件のページ間保持も同期して解除されます。編集後の新しい条件は、履歴で保持を再度有効にできます。 |
| 検索バーをクリアする | 現在保持されている条件も同期してクリアされます。 |
フィルターに固定は履歴項目の先頭固定順序を制御し、ページ間保持は条件の自動継承を制御します。2 つは個別に設定します。
DQL、SLS クエリを使用する場合、現在の式を実行し、保持条件の自動適用を一時停止します。共有およびスナップショット表示では、保存されたクエリを使用します。ページ間保持をサポートする検索・フィルターモードに戻ると、保持条件の適用が再開されます。







