翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Explore のログ
このドキュメントトピックは、Grafana バージョン 9.x をサポートする Grafana ワークスペース向けに設計されています。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 での作業。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業。
Explore では、メトリクスに加えて、次のデータソースのログを調査できます。
インフラストラクチャのモニタリングとインシデント対応中に、メトリクスとログをより深く掘り下げて原因を見つけることができます。また、Explore では、メトリクスとログを表示して相関させることができます side-by-side。これにより、新しいデバッグワークフローが作成されます。
-
アラートを受信します。
-
メトリクスをドリルダウンして調べます。
-
再度ドリルダウンし、メトリクスと時間間隔 (および将来的には分散トレース) に関連するログを検索します。
ログの視覚化
ログクエリの結果はグラフにヒストグラムとして表示され、個々のログについては以下のセクションで説明します。
データソースがフルレンジログボリュームヒストグラムをサポートしている場合、入力されたすべてのログクエリのログ分布を含むグラフが自動的に表示されます。この機能は現在、 OpenSearch および Loki データソースでサポートされています。
注記
Loki では、このフルレンジログボリュームのヒストグラムはメトリクスクエリによってレンダリングされます。メトリクスクエリは、クエリされた時間範囲によっては高価になる可能性があります。このクエリは、小規模な Loki インストールで処理するのが特に難しい場合があります。これを軽減するには、Loki の前に nginxX-Query-Tagsを持つクエリを検索することで識別できますSource=logvolhist。これらのヘッダーは、Grafana によってすべてのログボリュームヒストグラムクエリに追加されます。
データソースがフルレンジログボリュームヒストグラムのロードをサポートしていない場合、ログモデルは自動的に計算された時間間隔でバケット化されたログ行数に基づいて時系列を計算し、最初のログ行のタイムスタンプは結果からヒストグラムの開始を固定します。時系列の終わりは、タイムピッカーの To 範囲に固定されます。
ログレベル
レベルラベルが指定されているログの場合、Grafana はラベルの値を使用してログレベルを決定し、それに応じて色を更新します。ログにレベルラベルが指定されていない場合、そのコンテンツがサポートされている式のいずれかと一致するかどうかを調べようとします (詳細については、以下を参照してください）。ログレベルは常に最初の一致によって決まります。Grafana がログレベルを特定できない場合、不明なログレベルで視覚化されます。
ヒント
Loki データソースを使用し、 levelがログラインにある場合は、パーサー (JSON、logfmt、regex など) を使用して、ログレベルの判別に使用されるレベルラベルにレベル情報を抽出します。これにより、ヒストグラムはさまざまなログレベルを別々のバーに表示できます。
サポートされているログレベルと、ログレベルの略語と式のマッピング：
| サポートされている式 | ログレベル | 色 |
|---|---|---|
Emerg |
非常事態 |
紫色 |
致命的 |
非常事態 |
紫色 |
アラート |
非常事態 |
紫色 |
クリティカル |
非常事態 |
紫色 |
非常事態 |
非常事態 |
紫色 |
エラー |
エラー |
赤色 |
エラー |
エラー |
赤色 |
エラー |
エラー |
赤色 |
警告 |
warning |
黄色 |
warning |
warning |
黄色 |
info |
info |
green |
情報 |
info |
green |
通知 |
info |
green |
デバッグ |
デバッグ |
青色 |
デバッグ |
デバッグ |
青色 |
トレース |
トレース |
水色 |
* |
不明 |
グレー |
ログナビゲーション
ログ行の横にあるログナビゲーションインターフェイスを使用して、より多くのログをリクエストできます。これを行うには、ナビゲーションの下部にある古いログボタンを選択します。行数の上限に達し、さらにログを表示したい場合は、これを使用してさらにログを取得できます。各リクエストは個別のページとしてナビゲーションに表示されます。すべてのページには、受信ログ行の から へのタイムスタンプが表示されます。表示するページをクリックすると、以前の結果を表示できます。ログナビゲーションから実行された最後の 5 つのリクエストがキャッシュされるため、それらのページをクリックすると同じクエリが再実行されません。
視覚化オプション
ログの表示方法をカスタマイズし、表示する列を選択できます。
Time (時間)
時間列を表示または非表示にします。これは、データソースから報告されたログ行に関連付けられたタイムスタンプです。
一意のラベル
非共通ラベルのみを含む一意のラベル列を表示または非表示にします。すべての一般的なラベルが上に表示されます。
ラップライン
ディスプレイでラインラッピングを使用する場合は、これを True に設定します。False に設定すると、水平スクロールになります。
JSON の指定
これを に設定するとtrue、すべての JSON ログがプリティーに出力されます。この設定は、JSON 以外の形式のログには影響しません。
[Deduplication] (重複排除)
ログデータは非常に反復的であり、Explore は重複するログ行を非表示にすることで役立ちます。使用できる重複排除アルゴリズムはいくつかあります。
-
完全一致 – 完全一致は、日付フィールドを除き、行全体で行われます。
-
数値 – 期間、IP アドレスなどの数値を削除した後、行で一致します。
-
署名 – 最も積極的な重複排除。これにより、すべての文字と数字が除去され、残りの空白と句読点が一致します。
結果の順序を反転する
受信したログの順序は、デフォルトの降順 (最新の順) から昇順 (古い順) に変更できます。
ラベルと検出されたフィールド
各ログ行には、より堅牢な操作のために、ラベルと検出されたフィールドを含む拡張可能な領域があります。すべてのラベルについて、選択したラベルをフィルタリング (正のフィルター) し、フィルタリングアウト (負のフィルター) する機能が追加されました。各フィールドまたはラベルには、表示されるすべてのログに関連する統計を表示する統計アイコンもあります。
改行のエスケープ
Explore は、改行 (、) やタブ (\r) など\n、ログ行で誤ってエスケープされたシーケンスを自動的に検出します\t。このようなシーケンスを検出すると、Explore は「改行のエスケープ」オプションを提供します。
Explore は、検出された誤ってエスケープされたシーケンスを自動的に修正できます。
エスケープシーケンスを自動的に修正するには
-
エスケープ改行を選択してシーケンスを置き換えます。
-
置き換えを手動で確認し、その正確性を確認します。
Explore はこれらのシーケンスを置き換えます。その場合、オプションはエスケープ改行からエスケープの削除 に変わります。受信した入力に基づいて解析が正確ではない可能性があるため、変更を評価します。エスケープの削除 を選択すると、置換を元に戻すことができます。
データリンク
データリンクを使用すると、ログメッセージの任意の部分を内部リンクまたは外部リンクに変換できます。作成されたリンクは、ログの詳細ビュー内のリンクセクションにボタンとして表示されます。
フィールドの可視性の切り替え
ログ行を展開し、目のアイコンをクリックしてフィールドを表示または非表示にします。
Loki 固有の機能
Loki は Grafana Labs のオープンソースのログ集約システムです。Loki は、ログの内容のインデックスを作成するのではなく、各ログストリームの一連のラベルを作成するため、費用対効果が高いように設計されています。Loki からのログは、Prometheus のラベルセレクタを使用したクエリと同様の方法でクエリされます。ラベルを使用してログストリームをグループ化し、Prometheus ラベルと一致させることができます。Grafana Loki の詳細については、Grafana Loki
詳細については、ログデータのクエリ方法に関する「Loki」を参照してください。
メトリクスからログへの切り替え
Prometheus クエリからログクエリに切り替えると (最初に分割してメトリクスとログを並べて表示することもできます）、ログに存在するクエリのラベルが保持され、それらを使用してログストリームをクエリします。例えば、次の Prometheus クエリがある場合です。
grafana_alerting_active_alerts{job="grafana"}
Logs データソースに切り替えた後、次のように変更されます。
{job="grafana"}
これにより、検索可能な選択した時間範囲内のログのチャンクが返されます。
ログのサンプル
選択したデータソースがログサンプルを実装し、ログクエリとメトリクスクエリの両方をサポートしている場合、メトリクスクエリでは、視覚化されたメトリクスに寄与したログ行のサンプルを自動的に表示できます。この機能は現在、Loki データソースでサポートされています。
ライブテール
ライブテール機能を使用して、サポートされているデータソースのリアルタイムログを表示します。
探索ツールバーのライブボタンを選択して、ライブテールビューに切り替えます。
ライブテールビューでは、新しいログは画面の下部から取得され、背景にコントラストが消えるため、新しいものを追跡できます。一時停止ボタンを選択するか、ログビューをスクロールしてライブテールを一時停止し、中断することなく以前のログを調べます。再開ボタンを選択してライブテールを再開するか、停止ボタンを選択してライブテールを終了し、標準の探索ビューに戻ります。
