ログ詳細¶
ログリストで、個々のログの左側にある展開アイコンをクリックすると、現在のログの詳細ページがスライドアウト表示され、ログの生成時刻、ホスト、ソース、サービス、コンテンツ、拡張フィールド、コンテキスト表示などの詳細情報を確認できます。
完全なログを表示¶
ログがGuanceにアップロードされた際、1 件のログデータが 1M を超える場合、システムは 1M 単位で複数に分割します。たとえば、2.5M のログは 1M、1M、0.5M の 3 件に分割されます。分割後のログは、以下のフィールドでその完全性を確認できます。
フィールド |
タイプ | 説明 |
|---|---|---|
__truncated_id |
string | ログの一意の識別子を示します。分割された複数のログは同じ __truncated_id を使用し、ID のプレフィックスは LT_xxx です |
__truncated_count |
number | 分割されたログの総数を示します |
__truncated_number |
number | ログの分割順序を示します。0 から始まり、0 はログの先頭部分を表します |
ログ詳細ページで、現在のログが複数に分割されている場合、ページ右上に完全なログを表示ボタンが表示されます。このボタンをクリックすると、新しいページが開き、ログの分割順にすべての関連ログが一覧表示されます。同時に、遷移前に選択したログがページ上で色分けされ、前後のログをすばやく特定できます。
Obsy Copilot エラー分析¶
Guanceは、エラーログをワンクリックで解析する機能を提供します。大規模言語モデルを利用してログから重要な情報を自動的に抽出し、オンライン検索エンジンと運用ナレッジベースを組み合わせることで、考えられる障害原因を迅速に分析し、初期の解決策を提供します。
-
ステータスが
errorのすべてのログを絞り込みます。 -
個々のデータをクリックして詳細ページを展開します。
-
右上の Obsy Copilot エラー分析をクリックします。
-
これで異常分析を開始できます。
エラー詳細¶
現在のログに error_stack または error_message フィールドの情報が含まれている場合、システムはそのログに関連するエラー詳細を提供します。
詳細なログエラー情報を確認するには、ログエラー追跡 に移動してください。
属性フィールド¶
属性フィールドをクリックすると、すばやく絞り込み表示ができ、ログに関連するホスト、プロセス、トレース、コンテナのデータを確認できます。
| フィールド | 説明 |
|---|---|
| フィールド値を絞り込む | このフィールドをログエクスプローラーに追加し、このフィールドに関連するすべてのログデータを表示します |
| フィールド値を除外して絞り込む | このフィールドをログエクスプローラーに追加し、このフィールド以外の関連ログデータを表示します |
| 表示列に追加 | このフィールドをエクスプローラーのリストに追加して表示します |
| コピー | このフィールドをクリップボードにコピーします |
| 関連コンテナを表示 | このホストに関連するすべてのコンテナを表示します |
| 関連プロセスを表示 | このホストに関連するすべてのプロセスを表示します |
| 関連トレースを表示 | このホストに関連するすべてのトレースを表示します |
| 関連するインテリジェントインスペクションを表示 | このホストに関連するすべてのインテリジェントインスペクションデータを表示します |
ログコンテンツ¶
ログコンテンツは、message のタイプに応じて JSON とテキストの 2 つの表示モードを自動的に切り替えます。ログ詳細は、インデックスモードとログフィールドに基づいてログコンテンツを表示します。
- ログに
messageが存在する場合、優先的にmessageのコンテンツが表示され、コンテンツのタイプに応じて JSON またはテキストモードに切り替わります。 - 全行インデックスのログに
messageが存在しない場合、システムは現在のログの業務フィールドを組み合わせてログコンテンツを表示します。 - システムフィールドは、全行インデックスのログコンテンツの一部としては扱われません。
- ログコンテンツは展開と折りたたみに対応しており、デフォルトでは展開され、折りたたむと 1 行のみ表示されます。
ログコンテンツは展開と折りたたみに対応しており、デフォルトでは展開状態です。折りたたむと 1 行の高さのみ表示されます。
source:bpf_net_l4_log のログには、JSON とパケットの 2 つの表示モードが自動的に提供されます。パケットモードでは、クライアント、サーバー、時刻などの情報が表示され、絶対時刻と相対時刻の表示を切り替えることができます。デフォルトは絶対時刻です。切り替え後の設定はローカルブラウザに保存されます。
AI フィールド解析¶
ログコンテンツ領域の AI フィールド解析 をクリックすると、ログ全体を解析したり、ポップアップ内で原文の一部をドラッグして選択し、抽出されたフィールド名、タイプ、フィールド値をプレビューできます。保持するフィールドを確認したら、新しいタブで Pipeline 作成ページに移動し、事前に入力された設定と解析ルールをさらに調整し、必要に応じてテストして保存できます。
使用するには、ワークスペースの AI 機能を有効にし、Pipeline 管理権限を持っている必要があります。生成された結果はドラフトとしてのみ扱われ、保存後に Pipeline 設定に基づいて後続のログが処理されます。完全な操作手順については、ログ詳細からフィールドを解析して Pipeline を作成する を参照してください。
ログフラグメントの選択¶
フラグメント操作に対応したログコンテンツでは、中国語または中国語と英語が混在したフラグメントをクリックし、メニューから絞り込み、除外絞り込み、またはコピーを実行できます。フラグメントをクリックするとメニューが開くだけで、絞り込み操作を選択してからクエリが更新されます。
語句の選択範囲は、テキスト形式と表示位置によって異なります。
| コンテンツタイプ | 語句選択ルール |
|---|---|
| プレーンテキスト | 空白と一般的な句読点で区切られます。中国語のカンマ、句点、セミコロン、コロン、感嘆符、疑問符、読点、括弧、隅付き括弧、書名号、引用符などが区切り文字として使用できます。英語の引用符、疑問符、等号、カンマ、括弧などでもフラグメントを区切ることができます。連続する中国語は意味に基づいて自動的に分割されません。 |
| 識別子、パス、IP、時刻などの特定形式 | 対応する形式に基づいて認識され、その中の _、-、/、: などの接続記号は選択内容に保持される場合があり、一律に記号で分割されるわけではありません。 |
| URL | 全体として認識され、URL 内の ?、=、&、# などの記号は保持されます。空白、英語の引用符、山括弧が現れた時点で URL の認識が終了します。 |
たとえば、プレーンテキスト 用户登录失败,请重试。 では「用户登录失败」または「请重试」を選択できます。调用API失败 请稍后重试 では、スペースで区切られた「调用API失败」と「请稍后重试」の 2 つのフラグメントをそれぞれ選択できます。URL https://example.com/search?q=日志&limit=10#result は全体として認識され、内部のクエリパラメータやフラグメント識別子によって分割されません。
表示位置による語句選択の違い
ログ詳細の本文で、二重引用符または角括弧内のコンテンツは全体を選択できる場合があります。その語句選択の動作は、リストでのホバーによる語句選択や JSON 表示とは完全には一致しません。操作時は、現在の選択範囲に従ってください。
絞り込みを実行すると、システムは現在のクエリに選択したフラグメントを追加し、既存のインデックス、時間範囲、ワークスペース、その他の絞り込み条件を保持します。一部の文字が検索ハイライトに一致する場合も、クリックすると完全なフラグメントが選択されます。
JSON フィールドから絞り込みを実行する場合も、対応する実際のフィールドパスが使用されます。DQL、SLS などのモードでは、現在の入口における操作制限と変換確認ルールが引き続き適用されます。
JSON 検索¶
JSON 形式のログでは、key と value の両方に対して JSON 検索を実行できます。クリックすると、エクスプローラーの検索バーに @key:value の形式が追加され、その形式で検索されます。
複数レベルの JSON データの場合、. を使用して階層関係を表します。たとえば、@key1.key2:value は key1 配下の key2 に対応する値を検索することを示します。
詳細については、JSON 検索 を参照してください。
拡張フィールド¶
-
検索バーにフィールド名または値を入力して、すばやく検索・特定できます。
-
フィールドエイリアスにチェックを入れると、フィールド名の後ろで確認できます。
-
拡張フィールドにカーソルを合わせ、ドロップダウンアイコンをクリックすると、そのフィールドに対して以下の操作を選択できます。
-
フィールド値を絞り込む
-
フィールド値を除外して絞り込む
-
表示列に追加
-
ディメンション分析:クリックすると分析モード > 時系列グラフに移動します
-
コピー
-
コンテキストログ¶
ログサービスのコンテキスト検索機能は、時間の手がかりをたどって、異常ログの発生前後の関連レコードを遡り、問題の根本原因をすばやく特定するのに役立ちます。
-
ログ詳細ページで、このデータのコンテキストログを直接確認できます。
-
左側のドロップダウンボックスでインデックスを選択すると、対応するデータに絞り込めます。
-
データの並べ替え。
-
現在の詳細ページから直接、ログエクスプローラーの新しいページに移動できます。
-
設定。
関連ロジックの補足説明
返されたデータに基づき、スクロールのたびに 50 件のデータが読み込まれます。
返されたデータはどのようにして取得されるのでしょうか?
前提:ログに log_read_lines フィールドが存在するかどうか。存在する場合はロジック a に従い、存在しない場合はロジック b に従います。
a. 現在のログの log_read_lines 値を取得し、絞り込み条件 log_read_lines >= {{log_read_lines.value-30}} and log_read_lines <= {{log_read_lines.value +30}} に代入します。
DQL の例:現在のログ行数 = 1354170
この場合:
L::RE(`.*`):(`message`) { `index` = 'default' and `host` = "ip-172-31-204-89.cn-northwest-1" AND `source` = "kodo-log" AND `service` = "kodo-inner" AND `filename` = "0.log" and `log_read_lines` >= 1354140 and `log_read_lines` <= 1354200} sorder by log_read_lines
b. 現在のログの時刻を取得し、前後にずらしてクエリの開始時刻と終了時刻を算出します。
-
開始時刻:現在のログ時刻から 5 分前に遡ります。
-
終了時刻:現在のログから 50 件後ろに進み、50 件目の時刻 (·) を取得します。
timeが現在のログ時刻と等しい場合はtime+1 マイクロ秒を終了時刻とし、timeが現在のログ時刻と異なる場合はtimeを終了時刻とします。
ログコンテキストページ¶
をクリックすると、ログコンテキストページに移動します。以下の操作で現在のすべてのデータを管理できます。
-
検索ボックスにテキストを入力して、データを検索・特定できます。
-
サイドの ボタンをクリックすると、システム既定の自動折り返しをコンテンツオーバーフローモードに切り替えられます。このとき各ログは 1 行で表示され、必要に応じて左右にスクロールして確認できます。
-
先頭/末尾に戻ります。
-
上/下に 100 件を読み込みます。
-
エクスポートアイコンをクリックすると、現在のログコンテキストデータをエクスポートできます。
関連分析¶
システムはログデータの関連分析をサポートしています。エラー詳細、拡張フィールド、コンテキストログに加えて、ログに対応するホスト、コンテナ、ネットワークなどをワンストップで確認できます。
組み込みページ¶
ホスト、コンテナ、Pod などの組み込みページでは、以下の操作を実行できます。
(「ホスト」組み込みページを例とします)
-
現在のページの表示フィールドを編集できます。システムはフィールドに基づいて対応するデータを自動的に照合します。
-
メトリクスビューやホスト詳細ページへの移動を選択できます。
-
時間範囲を絞り込めます。
注意
組み込みページの表示フィールドを変更できるのはワークスペース管理者のみです。汎用フィールドを設定することをお勧めします。このページが複数のエクスプローラーで共有されている場合、フィールドの変更はリアルタイムで同期して反映されます。
例:ここで「index」フィールドを設定すると、ログにそのフィールドが存在する場合は正常に表示されますが、トレースエクスプローラーにこのフィールドがない場合は、対応する値を表示できません。
組み込みビュー¶
ここでシステムがデフォルトで表示するビューに加えて、ユーザービューをバインドすることもできます。
-
組み込みビューのバインドページに移動します。
-
デフォルトの関連フィールドを確認します。フィールドは保持または削除を選択でき、新しい
key:valueフィールドを追加することもできます。 -
ビューを選択します。
-
バインドが完了すると、ホストオブジェクトの詳細でバインドした組み込みビューを確認できます。ジャンプボタン をクリックすると、対応する組み込みビューのページに移動できます。








