ログの探索

ノート

ログ参照権限がない場合は、そのメニューにアクセスできません。

ホーム画面 > プロジェクト選択 >ログ> ログ探索New

ログ探索（Log Explorer） 機能は、ログデータを迅速に検索、フィルタリング、分析します。 フィールド構造に関する情報を把握し、クエリベースのフィルタリングによって必要なログを効率的に検索し、結果をデータの可視化を通じて確認できます。 本機能はLuceneインデックスをベースに動作し、主な特徴は以下のとおりです。

1. ログトレンド分析および検索: ログのトレンドと検索機能を同時にサポートし、時間経過によるログの変化傾向を把握できます。

2. 高速検索およびフィルタリング: ユーザーは簡単なキーワード入力だけで、問題のあるログを迅速に検索できます。 WhaTapログ検索クエリおよびLuceneクエリ言語に対応しており、さまざまな検索条件を設定できます。

3. オートコンプリート機能：クエリ入力時にオートコンプリート機能が提供され、ユーザーが簡単にクエリを作成し、習得できるようサポートします。

4. データ可視化：スタックグラフを活用して時系列のログ件数データを視覚的に表示し、ドリルダウン機能を通じて特定のログを深く分析できます。

5. お気に入りと共有：よく使うフィルターはお気に入りとして保存でき、URLを通じて他のユーザーと簡単に共有できます。

基本画面ガイド

時間設定

上部のオプションバーにあるタイムセレクターを使用して、ログ検索の時間範囲を設定できます。

カテゴリ

上部のオプションバーにあるカテゴリ選択で、探索したいログの種類を選択します。 （例：AppLogなど）

フィルター

上部オプションバーの フィルター でクエリ言語を選択し、検索条件を入力してフィルターを適用します。
検索クエリ構文は、WhaTapログ検索クエリとLuceneクエリの両方をサポートしています。

• : WhaTapログ検索クエリ

• : Luceneクエリ

検索クエリ構文

WhaTap log search query

WhaTapのログ検索クエリはオートコンプリート機能を提供しており、簡単なキーワード入力だけで問題のログを迅速に検索できます。 and、orなどのさまざまな構文を活用して、さまざまな検索条件を入力できます。

• 例、検索フィルターに error と入力するだけで、content（ログ本文）を検索できます。

  1. 上部オプションバーでフィルターアイコンをクリックした後、クエリ検索ウィンドウでフィールド（選択した時間とカテゴリに応じたリストが表示されます）を選択してください。

  2. 演算子を選択してください。

  a. 基本: :, : * 、and、or
  

  b. 選択したフィールドが Number 型の場合（基本 + <=、>=、<、>）
  

  c. 選択したフィールドが String の場合（基本のみ）

  3. 値（選択した時間、カテゴリ、フィールドに一致するリストが表示されます）を選択してください。

検索インデックスフィールドタイプ

サポートされているフィールドタイプは、Number、String、Boolean の3種類のみです。

• Number: Long、double、float 型の数値

• String: メール本文のような全文テキスト

• Boolean: True または False の値

ノート

WhaTapログ検索クエリの構文に関する詳細は次の文書を参照してください。

Lucene

Apache Lucene 8.11.1バージョンのオープンソース構文をそのまま使用してください。 ただし、自動補完機能は提供していません。

ノート

LuceneのQueryParserクラシックパッケージに関する詳細は公式ドキュメントを参照してください。

フィールド一覧

ドリルダウン分析に活用できます。

フィールド情報のフィルターを反映する

フィールド一覧でフィールド名を確認し、=または!=ボタンをクリックして条件をフィルターに適用してください。

• フィールドにマウスをホバーすると、=、!=ボタンが表示され、クリックするとフィルターに反映されます。

• フィールド検索機能を使って、目的のフィールドを素早く見つけることができます。

Trendチャート

Trendチャートでインターバルやブレイクダウンを適用して、ログをグラフで確認できます。

• グラフインタラクション: マウスドラッグや ボタンで時間のズームイン、バークリックで該当領域のログを確認可能

• インターバル: 自動、1秒、5秒、30秒、1分、5分、10分、30分、1時間から選択可能

• Breakdown: 特定のフィールドを基準にTop 3 + Othersの値を分布として可視化し、ドリルダウンフィルターの適用が可能

breakdown

Breakdownは、ログ件数の推移を特定のフィールドで分析する可視化機能です。

• 特定のフィールドのTop 3の値とOthers（その他の値）を区別して、スタックグラフで分布を表示します。

• ドリルダウン分析に活用でき、凡例やスタックグラフの特定領域（部分グラフ）をクリックして、特定の値のみを強調したり、フィルター条件を追加することができます。

ログの確認

検索条件に一致するログの一覧を確認でき、フィールド一覧ではフィールド情報とログタグの色が同じように表示されます。

コンテンツハイライト

ログのコンテンツ内で目的のキーワードを簡単に識別できるよう、ハイライト機能を提供します。単一または複数のキーワードでフィルタリングできます。

1. ハイライトしたいキーワードをキーワード入力欄に入力します。

   • 例: select

2. 検索したキーワードがログリストのContent内でハイライト表示されます。

   • 拡大表示 アイコンをクリックすると、ログ と タイムスタンプ を全画面で確認できます。

   • ハイライトされたキーワード間の移動はショートカットで操作できます。

     • Enter: 次の行へ移動
     • Shift+Enter: 前の行へ移動
     • / アイコン: 行の移動
     • Cmd+F(Mac) / Ctrl+F(Windows): キーワード検索

複数キーワード条件

複数キーワードでハイライトする場合は、次のように作成します。

入力文字列	説明	結果
a b c	各キーワードをスペースで区切りします。	a, b, c
"Whatap is good."	キーワードにスペースを含める場合は、''または""で囲みます。	Whatap is good.
"Whatap\\ is good."	""で囲まれたキーワードに、\を含める場合は、\\と入力する必要があります。	Whatap\ is good.

ハイライトカラー設定

ハイライトするキーワードおよび色を設定できます。

• デフォルトでは、ログレベルに応じたハイライト（FATAL、ERROR、WARN、SEVERE、CRITICAL）が適用されています。

• 設定した内容はプロジェクト単位で保存されます。

1. ![アイコン]](/img/ic-highlight.svg)アイコンをクリックします。

2. ハイライト ウィンドウで、色を設定したいキーワードを入力フィールドに追加で入力してください。

3. 入力欄の左側の色をクリックすると、色を選択できます。

ハイライトカラー設定

ハイライトするキーワードおよび色を設定できます。

• デフォルトでは、ログレベルに応じたハイライト（FATAL、ERROR、WARN、SEVERE、CRITICAL）が適用されています。

• 設定した内容はプロジェクト単位で保存されます。

1. ![アイコン]](/img/ic-highlight.svg)アイコンをクリックします。

2. ハイライト ウィンドウで、色を設定したいキーワードを入力フィールドに追加で入力してください。

3. 入力欄の左側の色をクリックすると、色を選択できます。

カラム設定

ボタンをクリックして、カラムを追加したり順序を設定することができます。

• カラム追加

  カラム追加：タグを選択して、テーブルにカラムを追加できます。

  注意

  ログカラムの選択を解除すると、ログ表示詳細設定を確認できません。 必ず1つ以上のカラムを選択します。

• カラム順序設定

  カラム設定でカラムを追加すると、表示項目に該当カラムが追加されます。 希望するカラムをドラッグして、カラムの順序を変更してください。

ログ表示詳細設定

ボタンをクリックして、ログの表示を詳細に設定します。 デフォルトでは content、タグ の両方がチェックされており、両方の項目が表示されます。

• contentとタグのいずれかを必ず選択してください。

• タグ管理リストにタグを追加すると、追加した順にログのタグが表示されます。 タグの順序はドラッグに変更できます。 追加したタグを無効にすると、無効にしたタグはログのタグに表示されません。

• チェックが解除された項目は、テーブルに表示されません。 次のようにタグを解除する場合、テーブルからログのタグは表示されません。

  

ノート

カラムおよびログ表示設定の適用範囲

• カラム設定とログ表示詳細設定は、ログTail、ログ検索、ログトレンドで使用できます。

• 同一プロジェクト内のログTail、ログ検索、ログトレンドは、カラム設定とログ表示詳細設定を共有します。

ログファイルのダウンロード

検索したログの結果を CSV または TXT ファイル形式でダウンロードできます。

1. 画面中央右側の ダウンロード ボタンをクリックします。

2. CSVダウンロード または Logダウンロード をクリックして、希望の形式のファイルをダウンロードします。