ログ一覧¶

グローバル設定¶

グローバル設定ページでは、以下の3つのコア機能に対してワークスペースレベルの集中管理を行うことができます。

• クイックフィルター設定：エクスプローラー内の共通クイックフィルターパネルをカスタマイズします。

• 上部フィールド設定：スタックモードで各ログの上部に表示するフィールドを設定します。個別に設定されていないインデックスは、グローバルデフォルト設定を使用します。

• インデックスキーフィールド設定：各インデックスがデータ一覧でデフォルトで優先表示するフィールドを定義します。

• クエリ高速化設定：インデックス下のフィールドに対して高速化機能を有効にし、クエリパフォーマンスを大幅に向上させます。

クイックフィルター¶

ここで設定したクイックフィルター項目は、ワークスペース内のすべてのエクスプローラーの左側にあるクイックフィルターパネルに適用され、すべてのメンバーに表示されます。

ここで追加されたすべてのフィルターフィールドは、自動的に対応するインデックスのクエリ高速化が有効になり、フィルターパフォーマンスが保証されます。この関連付けは強制的なデフォルト動作であり、無効化できません。

以下の2種類のフィールドを設定できます。

• フィルターフィールド（現在有効なフィールド）

  • 個々のフィールドを編集または削除できます。
  • すべてのフィルターフィールドをワンクリックで削除できます。

• オプションフィールド（ビジネスフィールド、システムフィールド、その他を含む）

  • フィルターフィールドとして追加できます。

フィールドが多い場合は、直接フィールドを検索できます。検索結果に完全一致する値がない場合は、直接作成して「フィールター」に追加できます。

クイックフィルター内の空の値（データなし）のエントリはデフォルトで非表示になりますが、ここで表示を有効にできます。有効にすると、各フィルターグループの下部に「データなし」オプションが表示され、このフィールドの値が空のデータをフィルターできます。この設定は、管理者および「グローバル設定」権限を持つカスタムロールのみが操作できます。

グローバルクイックフィルター¶

ワークスペース管理者は、管理 > クイックフィルターでグローバルフィルター項目を一括設定できます。設定を保存すると、すべてのメンバーがログエクスプローラーを更新または再表示すると、最新のグローバルフィルター項目が同期されます。

グローバルフィルター項目と個人のカスタムフィルター項目は独立して保存され、相互に上書きされません。

• 管理者がグローバルフィルター項目を追加、編集、順序変更、または無効にしても、メンバーが既に持っている個人フィルター項目には影響しません。
• クイックフィルターバーでは、グローバルフィルター項目はデフォルトで個人フィルター項目の前に表示されます。
• グローバルフィルター項目と個人フィルター項目の名前が同じ場合、両方が同時に表示され、フィールド識別子で区別できます。

グローバル設定が変更された場合、ページを更新すると、システムは「クイックフィルターはグローバル設定に従って自動的に更新されました」と通知します。同じエクスプローラー、同じバージョンでは、1回のみ通知されます。

上部フィールド設定¶

スタックモードで各ログの上部に表示するフィールドを設定します。個別に設定されていないインデックスは、グローバルデフォルト設定を使用します。

グローバルデフォルト上部フィールド¶

インデックスに専用の上部フィールドが設定されていない場合、グローバルデフォルトフィールドが使用されます。「編集」をクリックして、グローバルデフォルトで表示されるフィールドを調整できます。

デフォルトで含まれるフィールド：source、host、service、pod_name、container_name、duration。

インデックス上部フィールド設定¶

指定したインデックスに専用の上部フィールドを設定します。グローバルデフォルト設定よりも優先されます。

1. 「+ インデックス設定を追加」をクリックし、インデックスを選択して上部フィールドを設定します（最大8つ選択可能）。
2. 上部フィールドは、既存のフィールドを選択するか、手動でフィールド名を入力して選択できます。Enterキーを押すとカスタムフィールドを追加できます。
3. 保存後、そのインデックス下のログは、スタックモードで設定に従って上部フィールドが表示されます。

追加されたインデックス設定は、編集と削除が可能です。

インデックスキーフィールド¶

異なるデータインデックスに対して、一連の「キーフィールド」を設定します。設定後、該当インデックスに対応するデータ一覧を表示する際に、システムはこの順序でこれらのフィールドを優先的に表示し、コア情報に素早く焦点を当てるのに役立ちます。

• 左側：インデックス一覧
• 右側：システムがリストアップした各インデックス下のオプションフィールドから、キーフィールドを選択します。

現在のキーフィールド設定について、すべてのキーフィールドをクエリ高速化に同期するかどうかを選択できます。

クエリ高速化設定¶

インデックス下でフィルタリング、グループ化、または並べ替えに頻繁に使用されるフィールドに対して高速化機能を有効にすると、これらのフィールドのクエリ応答速度を大幅に向上させることができます。この設定はインデックスレベルに基づきます。

• 左側：インデックス一覧
• 右側：システムがリストアップした各インデックス下のオプションフィールドから、高速化するフィールドを選択します。後で上部の「高速化済みフィールド」一覧で確認できます。

設定変更後、約5分でシステム全体に反映され、反映後はフィールドが自動的に「高速化済みフィールド」一覧に追加されます。

インデックス下でフィルタリング、グループ化、または並べ替えに頻繁に使用されるフィールドに対して高速化機能を有効にすると、これらのフィールドのクエリ応答速度を大幅に向上させることができます。この設定はインデックスレベルに基づきます。

ログエクスプローラー > 表示列 > クエリ高速化設定 に移動します。左側はインデックス一覧で、右側は現在のインデックスの高速化済みフィールド一覧を表示します。

高速化フィールドの追加¶

「+ 高速化フィールドを追加」をクリックすると、高速化済みフィールド一覧の上に追加行が表示されます。

1. ドロップダウンでフィールドを選択します（あいまい検索に対応）。または、直接フィールド名を入力します。
2. 「追加」をクリックすると、フィールドが下の高速化済みフィールド一覧に追加されます。
3. 「キャンセル」をクリックすると、追加状態を終了し、フィールドは追加されません。

高速化フィールドの削除¶

• 単一削除：高速化済みフィールド一覧で、該当フィールドの「削除」をクリックします。
• 一括削除：「すべての高速化フィールドを削除」をクリックして、現在のインデックスのすべての高速化フィールドをクリアします。

設定変更後、約5分でシステム全体に反映され、反映後はフィールドが自動的に「高速化済みフィールド」一覧に追加されます。

インデックス¶

ログマルチインデックスを設定することで、条件に合致するログをそれぞれ異なるインデックスに保存し、各インデックスに適切なデータ保存戦略を選択することで、ログデータの保存コストを効果的に削減できます。

インデックス一覧はスクロール読み込みのメカニズムを採用しています。ページネーションと1回の読み込み数（50個）は、通常インデックスのみをカウントします。クローンインデックスはソースインデックスの2次行として表示され、通常インデックスのページネーション数にはカウントされません。最下部までスクロールすると、自動的に次の50個が読み込まれます。この読み込み方法はインデックス選択一覧にのみ適用され、ログデータ一覧のページネーションやスクロール表示方法とは関係ありません。

以下の操作が可能です。

• すべてのインデックスを選択（❗️データ量が多すぎるとクエリが遅くなる可能性があります）。

• 複数インデックスを選択。

• インデックスを先頭に固定。

• インデックス名で検索して位置を特定。キーワードを入力してEnterキーを押すと検索が実行されます。入力中はインデックス一覧は自動的に更新されません。

• 小、中、大でインデックスの表示領域を設定。

• インデックスの末尾にあるジャンプアイコンをクリックすると、新しいタブで対応するインデックスを開くことができます。

設定が完了すると、エクスプローラーで異なるインデックスを切り替えて、対応するログ内容を表示できます。

インデックス検索履歴¶

検索ボックスの右側にある履歴アイコンをクリックすると、最近使用したログインデックスを表示できます。

• 単一インデックスの履歴は、インデックス名を直接表示します。
• 複数インデックスの場合は、カンマ区切りで表示されます。例：default,application,security。
• 履歴レコードをクリックすると、システムはレコード内のすべてのインデックスを選択します。
• 履歴レコード内の一部のインデックスが削除されているか、現在利用できない場合、ページはその旨を通知し、利用可能なインデックスのみを保持します。
• インデックス履歴を適用しても、現在の時間範囲、検索条件、クイックフィルター条件はクリアされません。

クイックフィルター¶

詳細については、フィルターを参照してください。

ログエクスプローラーでは、クイックフィルター内の非数値フィールドの値は、デフォルトで現在の完全なクエリ範囲内の出現回数の多い順に並べられ、実際の Top N が表示されます。統計範囲は、現在のインデックス、時間範囲、クエリモード、検索条件、フィルター条件によって共同で決定され、現在のページに読み込まれているデータをサンプルとしません。

表示項目¶

表示項目ページでは、全体として2つの部分のフィールドが表示されます。

• 表示フィールド：クイックフィルターで表示されるフィールドです。

• オプションフィールド：現在のデータ型がキャッシュしているすべてのフィールドです。

以下の操作が可能です。

• フィールドを検索。検索結果に完全一致する値がない場合は、直接作成して「フィルターフィールド」に追加できます。

• フィールドのエイリアスを編集。

• ドラッグしてフィールドの順序を調整。

• フィールドを（すべて）削除。

• デフォルトフィールドにリセット。

• フィールドエイリアスと時間列の表示/非表示を設定。

表示項目設定を再度開くと、システムは前回の位置を復元します。フィールドの追加、削除、並べ替えを行った後、設定ページに再度入る際に、一覧の先頭から再度検索する必要はありません。

フィールド値の並べ替え¶

「表示項目」内の非数値フィールドの候補値は、デフォルトで出現回数の多い順に並べられます。並べ替えは完全な統計範囲に基づいて実際の Top N を生成し、現在のリストのページネーションやスクロール読み込みの行数に影響されません。

Standard、DQL、ログインデックス、時間範囲、またはクエリ条件を切り替えると、システムは新しいクエリコンテキストに基づいて再集計します。

デフォルトフィールドにリセット¶

「デフォルトフィールドにリセット」操作を実行すると、システムは以下のルールに従ってフィールドを表示します。

• 通常インデックス：デフォルトで time と message を表示。時間列の表示は、「時間列を表示」スイッチの制御を受けます。
• 全行インデックス：デフォルトで time と現在のインデックスのビジネスフィールドを表示。message はデフォルトでは表示されません。
• 管理者が現在のインデックスにキーフィールドを設定している場合は、キーフィールド設定が優先されて表示されます。
• ユーザーは引き続き、表示フィールドを手動で追加、削除、または調整できます。

インデックスごとに表示項目を保存¶

ログエクスプローラーは、ログインデックスごとに現在のユーザーの表示項目設定を独立して保存します。

例えば、インデックスAとインデックスBをそれぞれ選択した場合：

• インデックスAで表示フィールドを追加しても、自動的にインデックスBに追加されることはありません。
• インデックスBに切り替えると、システムはインデックスBで最後に保存された表示項目を復元します。
• 再度インデックスAに戻すと、システムはインデックスAの表示項目設定を復元します。

表示項目設定は現在のユーザーのブラウザに保存され、ワークスペース内の他のメンバーには影響しません。

ステータス分布図¶

選択した時間範囲に基づいて、システムは自動的に複数の時間ポイントを分割し、積み上げ縦棒グラフで異なるログステータスの数を表示し、効率的な統計分析を支援します。

ログをフィルタリングして絞り込むと、縦棒グラフはリアルタイムでフィルタリング結果を同期表示します。

• ホバーしてグラフをエクスポートし、ダッシュボードやノートにエクスポートしたり、クリップボードにコピーしたりできます。

• 時間間隔をカスタム選択できます。

クエリモード¶

ワークスペースでログ長期保存が有効になっている場合、右上隅に標準クエリと長期クエリの切り替えエントリが表示されます。このエントリは、異なる保存階層のデータ間でクエリを切り替えるために使用されます。具体的な使用方法は、データ保存戦略の設定によって異なります。

ワークスペースでログ長期保存が有効になっていない場合、エクスプローラーにこの切り替えエントリは表示されません。

クリックしてログクエリモードの詳細を表示。

使用説明¶

1. デフォルトでエクスプローラーに入るときは標準クエリモードで、任意の時間範囲のクエリとリアルタイム応答をサポートします。

2. 長期クエリに切り替えた後、時間入力ボックスをクリックして時間選択パネルを開きます。

3. 日付を選択：左側で開始日を選択します。

4. 開始終了時間を設定：右側のホイールでそれぞれ開始時間と終了時間を選択します。終了時間が開始時間より早い場合、システムは自動的に翌日と認識し、入力ボックスには 2026-05-19 23:00:00 ~ 翌日 05:00:00 と表示されます。

5. 時間軸上で青い区間をドラッグして全体を移動したり、左右の端点をドラッグして開始終了時間を微調整することもできます。ドラッグ中は当日の深夜を跨ぐことができ、日付変更線は「翌日 00:00」で示されます。

6. 時間軸の下には、現在選択されているクエリ区間と合計時間がリアルタイムで表示されます。確認後、「クエリ」をクリックして検索を実行します。

検索バー¶

ログエクスプローラーの検索バーでは、複数の検索およびフィルター方法をサポートしています。

検索条件またはフィルター条件を入力すると、プレビュー結果を表示でき、その条件をコピーしてグラフやクエリツールに適用できます。

手書き入力設定¶

検索ボックスの右側にある切り替えボタン をクリックして、手動入力クエリモードに入ります。

JSON フィールドの返却¶

DQL クエリは、ログデータの JSON フィールドからネストされた値を抽出することをサポートしています。DQL クエリステートメントに @ 記号を含むフィールドパスを追加するだけで、システムが自動的にこの設定を認識し、抽出された値を独立したフィールドとしてクエリ結果に表示します。例：

• 通常のクエリ：

• ネストされたフィールドを抽出した後のクエリ：

ログエクスプローラーで、データ一覧に各ログの message JSON テキストから抽出された値を直接表示したい場合は、表示列に @targer_fieldname 形式のフィールドを追加します。下図では、表示列に DQL クエリステートメントで既に設定されている @fail_reason を追加しています。

ログ色のハイライト¶

ログ内の重要な情報を素早く特定するために、検索条件を入力すると、ページは現在のクエリ結果内のすべてのヒット内容をハイライト表示します。message フィールドに限定されません。リスト、スタックリスト、およびログ内容に実際に表示されている他のフィールドが検索条件にヒットした場合も、同期的にハイライト表示されます。

ログ単行展開・コピー¶

• ログエントリ内の ボタンをクリックすると、そのログの完全な内容を表示できます。ログが JSON 形式に対応している場合は JSON 形式で表示され、それ以外の場合は内容が通常表示されます。

• ボタンをクリックすると、ログ全体の内容をクリップボードにコピーできます。

表示行数¶

ログデータ一覧では、デフォルトで各ログのトリガー時間と内容が表示されます。「表示行数」オプションで、「1行」「3行」「10行」または「すべての内容」を選択して、完全なログ情報を表示できます。

「スキャン済み量」と「件数」の説明¶

1. スキャン済み量：今回のクエリが実際の実行中にスキャンしたデータサイズを示します。クエリの消費量を測定するために使用されます。スキャン済み量が大きいほど、今回のクエリが検索および処理する必要があるデータ範囲が大きいことを意味します。
2. 件数：今回のクエリが最終的に返す結果の数を示します。クエリ結果の規模を測定するために使用されます。件数はヒットした結果の数のみを表し、クエリプロセスでスキャンされたデータ量とは異なります。

スキャン済み量と件数の間には固定の換算関係はないことに注意してください。単一のログサイズは固定ではなく、1回のクエリで大量のデータをスキャンした後、少数の結果のみがヒットする可能性があるため、件数からスキャン済み量を直接推算したり、スキャン済み量から返却件数を逆算したりすることはできません。

設定¶

モニターの新規作成¶

ログデータをフィルタリングする際に、フィルタリング結果に対してさらにアラート監視が必要な場合は、ワンクリックでモニターを作成できます。システムは自動的に選択したインデックス、データソース、検索条件を適用するため、設定プロセスが簡素化されます。

Copy as cURL¶

ログエクスプローラーでは、コマンドライン形式でログデータを取得できます。ログデータ一覧の右側にある設定から、Copy as cURL ボタンをクリックすると、対応する cURL コマンドがコピーされます。このコマンドをホストのターミナルに貼り付けて実行すると、現在の時間範囲内でフィルターおよび検索条件に一致するログデータを取得できます。

例

cURL コマンドラインをコピーすると、下図のようになります。<Endpoint> はドメイン名に、<DF-API-KEY> は API 管理 で Key ID に置き換える必要があります。

関連パラメータの詳細については、DQL データクエリを参照してください。

API の詳細については、Open APIを参照してください。

curl '<Endpoint>/api/v1/df/query_data?search_after=\[1680226330509,8572,"L_1680226330509_cgj4hqbrhi85kl1m6os0"\]&queries_body=%7B%22queries%22:\[%7B%22uuid%22:%222eb41760-cf6e-11ed-a983-7d559044c3fc%22,%22qtype%22:%22dql%22,%22query%22:%7B%22q%22:%22L::re(%60.*%60):(%60*%60)%7B+%60index%60+IN+\[%27default%27\]+%7D%22,%22highlight%22:true,%22limit%22:50,%22orderby%22:\[%7B%22time%22:%22desc%22%7D\],%22_funcList%22:\[\],%22funcList%22:\[\],%22disableMultipleField%22:false,%22disable_slimit%22:false,%22is_optimized%22:true,%22offset%22:0,%22search_after%22:\[1680226330509,8572,%22L_1680226330509_cgj4hqbrhi85kl1m6os0%22\],%22timeRange%22:\[1680187562081,1680230762081\],%22tz%22:%22Asia%2FShanghai%22%7D%7D\]%7D' \
- H 'DF-API-KEY: <DF-API-KEY>' \
- -compressed \
- -insecure

このエクスポート方法以外にも、他のログデータエクスポート方法を利用できます。

ステータス色の設定¶

システムは、ステータス値にデフォルトの色をプリセットしています。エクスプローラーで異なるステータスに表示される色をカスタマイズしたい場合は、「ステータス色の設定」をクリックして変更します。

フォーマット設定¶

フォーマット設定を使用すると、機密ログ内容を非表示にしたり、重要なログ内容を強調表示したり、ログ内容を置き換えてクイックフィルターを実現したりできます。

1. エクスプローラー一覧の右上隅にある設定をクリックします。

2. フォーマット設定をクリックします。

3. マッピングルールを追加し、以下を入力して保存します。

   • フィールド：ログフィールドを指定します（例：content）。

   • 一致方法：一致方法を選択します（現在は =、!=、match、not match をサポート）。

   • 一致内容：一致させる内容を入力します（例：DEBUG）。

   • 表示する内容：置き換え後の表示内容を入力します（例：**）。

ログデータエクスポート¶

ログでは、まず必要なデータをフィルタリングした後、CSV、JSONL、TXT ファイルとしてエクスポートしたり、ダッシュボードやノートにエクスポートしたりできます。

HTTPS 環境では、CSV および TXT ファイルは1回のエクスポートで最大1,000,000件のログをエクスポートできます。JSONL ファイルはこの上限がありません。実際のエクスポート時間は、データ量とクエリ条件によって影響を受けます。エクスポートが完了するまでお待ちください。

特定のログをエクスポートする必要がある場合は、そのログの詳細ページを開き、右上隅の をクリックします。

高度な連携設定¶

詳細については、高度な連携設定を参照してください。