翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Grafana バージョン 10 で探索する **** このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 Grafana のダッシュボード UI は、視覚化用のダッシュボードを構築する機能を提供します。*Explore* は、クエリに集中できるように、ダッシュボードとパネルのオプションを取り除きます。これにより、クエリが動作するまで反復処理を行い、クエリからダッシュボードを構築できます。 **注記** ダッシュボードを作成せず単にデータを探索したい場合は、Explore を使用するとはるかに簡単になります。データソースがグラフとテーブルのデータをサポートしている場合、Explore は結果をグラフとテーブルの両方で表示します。これにより、データの傾向と詳細を同時に確認できます。 このページでは、データの探索を開始します。以下のトピックでは、Explore の特定の機能と使用方法について詳しく説明します。 + [Explore でのクエリ管理](v10-explore-manage.md) + [Explore のログ](v10-explore-logs.md) + [Explore でのトレース](v10-explore-tracing.md) + [Explore の相関エディタ](v10-explore-correlations.md) + [Explore の Inspector](v10-explore-inspector.md) ## 探索を開始する **注記** Explore にアクセスするには、エディタまたは管理者ロールが必要です。 **Explore にアクセスするには** 1. Grafana ワークスペースで、左側のメニューバーから Explore メニュー項目を選択します。 空の Explore タブが開きます。 または、パネル内の既存のクエリから開始するには、パネルメニューから Explore オプションを選択します。これにより、パネルからのクエリを含む Explore タブが開き、ダッシュボードの外部でクエリを微調整または反復できます。 1. 左上のドロップダウンからデータソースを選択します。 また、**[Open advanced data source picker(高度なデータソースピッカーを開く)]** を選択して、データソースの追加 (管理者のみ可能) など、その他のオプションを表示することもできます。 1. 選択したデータソースから提供されたクエリエディタを使用してクエリを書き込みます。 クエリの詳細については、「[データのクエリと変換](v10-panels-query-xform.md)」を参照してください。 1. 右上隅のボタンを使用してクエリを実行します。 ## 分割して比較する 分割ビューを使用すると、簡単に視覚化を並べて比較したり、関連データを 1 ページでまとめて確認したりできます。 **上部で分割ビューを開く** 1. Explore ビューで、**[分割]** ボタンを選択して現在のクエリを複製し、ページを 2 つの並列クエリに分割します。 **注記** 新しいクエリには別のデータソースを選択できます。例えば、2 つの異なるサーバーに対して同じクエリを比較したり、ステージング環境を本番環境と比較したりできます。 分割ビューでは、いずれかのタイムピッカーにある時刻同期ボタンを選択することで、両方のパネルのタイムピッカーを連携できます (一方を変更すると、他方も変更されます)。タイムピッカーを連携すると、分割ビュークエリの開始時刻と終了時刻が同期されます。これにより、両方の分割パネルで同じ時間間隔を確認できます。 1. 新しく作成したクエリを閉じるには、**[分割を閉じる]** ボタンを選択します。 ## コンテンツ概要 コンテンツ概要は、Explore で作成したクエリと視覚化を追跡するサイドナビゲーションバーです。これにより、クエリと視覚化との間をすばやく移動できます。 コンテンツ概要は、分割ビューでも機能します。分割ビューでは、コンテンツ概要がペインごとに生成されます。 **コンテンツ概要を開くには** 1. **Explore** 画面の左上隅にある **[概要]** ボタンを選択します。 1. コンテンツ概要でパネルアイコンを選択して、そのパネルに移動します。 ## Explore の URL を共有する Explore を使用すると、クエリを変更した際にブラウザのアドレスバーの URL が更新されます。この URL を共有またはブックマークできます。 **注記** Explore は比較的長い URL を生成する場合があります。URL がお使いのツールに対して長すぎる場合は、[短縮リンク](#v10-explore-share)を生成して共有することもできます。 **外部ツールから Explore の URLを生成する** Explore URL には定義された構造があるため、外部ツールから URL を構築し、Grafana で開くことができます。URL 構造は次のとおりです。 ``` http:///explore?panes=&schemaVersion=&orgId= ``` 各パラメータの意味は次のとおりです。 + `org_id` は組織 ID です。 + `schema_version` はスキーマバージョンです (最新バージョン `1` に設定する必要があります)。 + `panes` はペインの URL エンコードされた JSON オブジェクトで、各キーはペイン ID、各値は次のスキーマに一致するオブジェクトです。 ``` { datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources queries: { refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc. datasource: { uid: string; // the query's datasource UID ie: "AD7864H6422" type: string; // the query's datasource type-id, i.e: "loki" } // ... any other datasource-specific query parameters }[]; // array of queries for this pane range: { from: string; // the start time, in milliseconds since epoch to: string; // the end time, in milliseconds since epoch } } ``` **注記** `from` および `to` フィールドは、[ダッシュボードの時間範囲の設定](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) トピックで説明されている相対範囲も受け入れます。 ## 短縮リンクを共有する 短縮リンクの共有機能を使用すると、クエリパラメータで長い URL を使用する代わりに、/goto/:uid 形式のより短くてシンプルな URL を作成できます。クエリ結果への短縮リンクを作成するには、Explore ツールバーで **[共有]** オプションを選択します。使用されない短縮リンクは、7 日後に自動的に削除されます。リンクが 1 回以上使用されている場合は削除されません。 **短縮リンクを絶対時間で共有する** 短縮リンクには、相対時間 (2 時間前から現在の時刻など) または絶対時間 (午前 8 時から午前 10 時など) の 2 つのオプションがあります。デフォルトでは短縮リンクを共有すると、選択した相対時間範囲または絶対時間範囲がコピーされます。短縮リンクの共有ボタン横にあるドロップダウンボタンを選択し、**[Time-Sync URL Links]** (時刻同期 URL リンク) でオプションのいずれかを選択すると、絶対時間で短縮リンクを作成できます。つまり、リンクを受け取ったすべてのユーザーには、別の時間にリンクを開いても、現在ご覧のものと同じデータが表示されます。このオプションは、Explore ビューで選択した時間範囲には影響しません。 # Explore でのクエリ管理 **** このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 Explore で作成したクエリを管理できます。これには、実行したクエリの履歴や、スターを付けたクエリが含まれます。 ## クエリ履歴 クエリ履歴は、Explore で使用したクエリのリストです。履歴は Grafana データベースに保存され、他のユーザーと共有されません。履歴内のクエリの保持期間は 2 週間です。2 週間以上経過したクエリは自動的に削除されます。履歴を開いて操作するには、Explore の **[クエリ履歴]** ボタンを選択します。 **注記** スター付き (お気に入り) クエリは 2 週間の保持期間の対象ではなく、削除されません。 ## クエリ履歴の表示 クエリ履歴を使用すると、クエリの履歴を表示できます。個々のクエリごとに、次のことができます。 + クエリを実行します。 + コメントを作成および/または編集します。 + クエリをクリップボードにコピーする。 + クエリを含む短縮リンクをクリップボードにコピーする。 + クエリをスター付き (お気に入り) にする。 ## お気に入りのクエリを管理する [クエリ履歴] タブにあるスター付きのすべてのクエリは、[スター付き] タブに表示されます。これにより、お気に入りのクエリにすばやくアクセスし、ゼロから入力することなくこれらのクエリを再利用できます。 ## [クエリ履歴の並べ替え] デフォルトでは、クエリ履歴には最新のクエリが表示されます。履歴は日付またはデータソース名で、昇順または降順に並べ替えることができます。 **クエリ履歴を並べ替えるには** 1. **[クエリの並べ替え順序]** フィールドを選択します。 1. 以下のオプションのいずれかを選択します。 + **[新しい順]** + **[古い順]** ## クエリ履歴のフィルタリング クエリ履歴とスター付きタブで、クエリ履歴を特定のデータソースに対してフィルタリングできます。 **データソースに対して履歴をフィルタリングするには** 1. **[特定のデータソースのクエリをフィルタリング]** フィールドを選択します。 1. 履歴をフィルタリングするデータソースを選択します。複数のデータソースを選択することもできます。 **注記** 混合データソースを使用して実行されたクエリは、[混合] をフィルタリングする場合にのみ表示され、個々のデータソースでフィルタリングする場合は表示されません。 **[クエリ履歴]** タブでは、スライダーを使用して日付でクエリをフィルタリングすることもできます。 + 垂直スライダーを使用して、クエリを日付でフィルタリングします。 + 下部のハンドルをドラッグして開始日を設定します。 + 上部のハンドルをドラッグして終了日を設定します。 ## クエリ履歴の検索 クエリとコメントをまたいで履歴を検索できます。クエリ履歴タブとスター付きタブでクエリを検索できます。 **クエリ履歴で検索するには** 1. **[クエリ検索]** フィールドを選択します。 1. 検索する用語を検索フィールドに入力します。 ## クエリ履歴設定 [設定] タブでクエリ履歴をカスタマイズできます。次の表にオプションの説明を示します。 | 設定 | デフォルトの 値 | | --- | --- | | デフォルトのアクティブタブを変更する | [クエリ履歴] タブ | **注記** クエリ履歴設定は全体に及び、分割モードで両方のパネルに適用されます。 # Explore のログ **** このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 Explore を使用すると、次のようなさまざまなデータソースのログを調査できます。 + [OpenSearch](using-opensearch-in-AMG.md) + [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md) + [InfluxDB](using-influxdb-in-AMG.md) + [Loki](using-loki-in-AMG.md) インフラストラクチャのモニタリングとインシデント対応中に、メトリクスとログをより深く掘り下げて原因を見つけることができます。Explore では、ログを並行して表示することで、メトリクス、トレース、プロファイルなどの他のテレメトリシグナルとログを関連付けることもできます。 ログクエリの結果は、個々のログ行として表示され、選択した期間のログボリュームを示すグラフとして表示されます。 ## ログボリューム フルレンジのログボリュームをサポートするデータソースを操作すると、Explore には、入力されたすべてのログクエリのログ分布を示すグラフが自動的に表示されます。この機能は、現在 OpenSearch および Loki データソースでサポートされています。 **注記** Loki では、このフルレンジのログボリュームをメトリクスクエリによってレンダリングします。このクエリは、クエリされた時間範囲に応じてコストがかかる可能性があります。このクエリは、小規模な Loki インストールで処理するのが特に難しい場合があります。これを軽減するには、Loki の前に [nginx](https://www.nginx.com/) などのプロキシを使用して、これらのクエリにおけるユーザー定義のタイムアウト (10 秒など) を設定できます。ログボリュームヒストグラムクエリは、値 `Source=logvolhist` の HTTP ヘッダー `X-Query-Tags` を持つクエリを検索することで識別できます。これらのヘッダーは、Grafana によってすべてのログボリュームヒストグラムクエリに追加されます。 データソースがフルレンジのログボリュームの読み込みに対応していない場合、ログモデルはログ行をカウントし、自動的に計算された時間間隔に基づいてバケットに整理することで時系列を計算します。最初のログ行のタイムスタンプは、結果のログボリュームの開始を固定するために使用されます。時系列の終了点は、タイムピッカーの **To** 範囲に固定されます。これにより、データソースがフルレンジのサポートを提供していない場合でも、ログデータを効率的に分析および視覚化できます。 ## ログ 以下のセクションでは、Explore で個々のログを視覚化して操作する詳細な方法を説明します。 ## ログナビゲーション ログ行の右側にあるログナビゲーションを使用して、追加のログを簡単にリクエストできます。これを行うには、ナビゲーションの下部にある **[古いログ]** ボタンをクリックします。これは、行の制限に達した際に、さらにログを表示する場合に特に便利です。ナビゲーションから実行される各リクエストは、ナビゲーションに個別のページとして表示されます。各ページには、受信ログ行のタイムスタンプ `from` と `to` が表示されます。各ページをクリックすると、以前の結果を確認できます。Explore がログナビゲーションから実行された過去 5 つのリクエストをキャッシュすることで、ページをクリックしたときに同じクエリを再実行しないようにでき、時間とリソースを節約できます。 ## 視覚的表現オプション ログの表示方法をカスタマイズしたり、表示する列を選択することができます。 | オプション | 説明 | | --- | --- | | [時間] | 時間列を表示または非表示にします。これはデータソースから報告されたログ行と関連するタイムスタンプです。 | | [一意のラベル] | 非共通ラベルのみを含む一意のラベル列を表示または非表示にします。すべての一般的なラベルが上に表示されます。 | | [行の折り返し] | ディスプレイで行の折り返しを使用する場合は、これを true に設定します。false に設定すると、水平スクロールになります。 | | Prettify JSON (JSONの整形) | すべての JSON ログを pretty print (整形表示) するには、これを true に設定します。この設定は、JSON 以外の形式のログには影響しません。 | | Deduplication (重複排除) | ログデータは非常に反復的であり、Explore は重複するログ行を非表示にすることで役立ちます。使用できる重複排除アルゴリズムはいくつかあります。[完全] 一致は、日付フィールドを除き、行全体で行われます。[数値] の一致は、期間、IP アドレスなどの数値を除外した後に行で行われます。Signature (署名) は、残りの空白と句読点のすべての文字、数字、一致を削除するため、最も積極的な重複排除です。 | | Display results order (結果の順序の表示) | 受信したログの順序は、デフォルトの降順 (新しい順) から昇順 (古い順) に変更できます。 | ## ログ行のダウンロード ログ結果を `txt` または `json` 形式でダウンロードするには、**[Download]** ボタンを使用します。この機能を使用すると、ログデータを保存して詳細な分析を行ったり、便利でアクセスしやすい形式で他のユーザーと共有したりできます。 ## ログ結果のメタ情報 受信したログ行の上には、次のような重要なメタ情報があります。 + **[受信したログの数]** – 現在のクエリまたは時間範囲に対して受信したログの合計数を示します。 + **[エラー]** – ログ結果に考えられるエラーを表示します。 + **[共通ラベル]** - 共通ラベルを表示します。 + **Total bytes processed** (処理された合計バイト数) – 処理されたログデータの累積サイズをバイト単位で表します。 **注記** 特定のメタ情報の可用性はデータソースに依存する場合があり、その結果、特定のデータソースに対する詳細の一部しか表示されない場合があります。 ## 改行のエスケープ Explore は、改行 (`\n`、`\r`) やタブ (`\t`) など、ログ行で誤ってエスケープされたシーケンスを自動的に検出します。このようなシーケンスを検出すると、Explore は **[改行のエスケープ]** オプションを提供します。 **Explore が検出した誤ってエスケープされたシーケンスを自動的に修正するには** 1. **[改行のエスケープ]** を選択してシーケンスを置き換えます。 1. 置き換えを手動で確認し、その正確性を確認します。 Explore はこれらのシーケンスを置き換えます。そうすると、オプションは **[改行のエスケープ]** から **[エスケープの削除]** に変更されます。受信した入力に基づいて解析が正確ではない可能性があるため、変更を評価します。**[エスケープの削除]** を選択すると、置き換えを元に戻すことができます。 ## ログレベル `level` ラベルが指定されているログについては、このラベルの値を使用してログレベルを決定し、それに応じて各ログ行の色を更新します。ログに指定されたレベルラベルがない場合、そのコンテンツが、サポートされている表現のいずれかと一致するかどうかを調べます (詳細については、次の表を参照してください)。ログレベルは常に最初の一致によって決まります。Grafana がログレベルフィールドを推測できない場合、不明なログレベルで視覚化されます。 **注記** Loki データソースを使用し、`level` がログラインの一部である場合は、パーサー (JSON、logfmt、regex など) を使用して、レベル情報をレベル値の決定に使用されるレベルラベルに抽出できます。これにより、ヒストグラムはさまざまなログレベルを個別のバーとして表示できます。 **サポートされているログレベルと、ログレベルの略記と表現のマッピング** | ログレベル | 色 | サポートされている式 | | --- | --- | --- | | critical | 紫色 | emerg、fatal、alert、crit、critical | | エラー | 赤 | err、eror、error | | 警告 | 黄色 | warn、warning | | 情報 | 緑色 | info、information、informational、notice | | デバッグ | 青 | dbug、debug | | トレース | 水色 | トレース | | 不明 | 灰色 | \$1 | ## 検索された単語を強調表示する クエリに検索する特定の単語または式が含まれている場合、Explore は可視性を高めるためにログ行でこれらを強調表示します。この強調表示機能により、ログ内の関連コンテンツを簡単に特定して注目できます。 **注記** 検索語を強調表示する機能は、データソースによって異なります。一部のデータソースでは、検索語の強調表示が使用できない場合があります。 ## ログの詳細を表示する Explore では、各ログ行には *[ログの詳細]* という拡張可能なセクションがあり、ログ行を選択して開くことができます。ログの詳細ビューには、ログ行にある*フィールド*と*リンク*の形式で追加情報と探索オプションが用意されており、より堅牢なインタラクションと分析が可能になります。 **[フィールド]** ログの詳細ビューでは、表示されたフィールドを次の 2 つの方法でフィルタリングできます。ポジティブフィルター (特定のフィールドに焦点を当てる) とネガティブフィルター (特定のフィールドを除外する) です。これらのフィルターは、ログ行を生成した対応するクエリを更新し、それに応じて等式と不等式を追加します。データソースがサポートしている場合、Loki および OpenSearch の場合と同様に、ログの詳細によって、フィールドが現在のクエリ表示およびアクティブ状態 (ポジティブフィルターの場合のみ) に既に存在しているかどうかが確認されます。その際、クエリをオフにしたり、フィルター式をポジティブからネガティブに変更したりできます。 目のアイコンをクリックすると、完全なログ行ではなく、ログリストで視覚化するフィールドのサブセットを選択できます。各フィールドには、表示されているすべてのログに関連する統計を表示する統計アイコンがあります。 **リンク** Grafana は、データリンクまたは相関機能を提供し、ログメッセージの任意の部分を内部または外部のリンクに変換できます。これらのリンクを使用して、関連するデータや外部リソースに移動し、シームレスで便利な方法で詳細情報を確認できます。 ## ログのコンテキスト ログコンテキストは、特定の検索クエリに一致するログエントリを囲む追加のコンテキスト行を表示します。これはログエントリのコンテキストを理解するのに役立ちます。また、`grep` コマンドの `-C` パラメータに似ています。 テキスト行が長いため、各ログエントリ全体のコンテキストの読み取りと分析が困難になる場合があります。ここでは、**[行の折り返し]** の切り替えが役に立つ場合があります。この切り替えを有効にすると、Grafana は長いテキスト行を自動的に折り返して、ビューワーの可視幅に収まるようにします。これにより、ログエントリの読み取りと理解が容易になります。 **[分割ビューで開く]** ボタンを使用すると、Explore ビューの分割画面でログエントリのコンテキストクエリを実行できます。このボタンを選択すると、ログエントリとともにコンテキストクエリが表示される新しい Explore ペインが開き、周囲のコンテキストの分析と理解が容易になります。 ログコンテキストクエリは、 `Ctrl` (または `Cmd`) キーを押しながらボタンを選択してコンテキストモーダルを開くことで、新しいブラウザタブで開くこともできます。新しいタブで開くと、以前に選択したフィルターも適用されます。 ## ログ行のコピー 選択したログ行の内容を簡単にクリップボードにコピーするには、**[Cログ行のコピー]** ボタンを選択します。 ## リンクをログ行にコピーする Grafana でログ行をリンクすると、特定のログエントリにすばやく移動して正確な分析を行うことができます。ログ行に対して **[ショートリンクをコピー]** ボタンを選択すると、絶対時間範囲内の正確なログエントリに直接アクセスできる短縮 URL を生成してコピーできます。リンクを開くと、Grafana は対応するログ行まで自動的にスクロールし、青色の背景でログ行が強調表示されるため、関連情報を簡単に特定して注目できます。 **注記** これは、`id` フィールドを提供する Loki およびその他のデータソースでのみサポートされています。 ## ライブテーリング サポートされているデータソースからのリアルタイムログを表示するには、Explore のライブテーリング機能を活用できます。 **ライブテーリングを使用してログをリアルタイムで表示するには** 1. Explore ツールバーの **[Live]** ボタンを選択して、Live Tail ビューに切り替えます。 1. Live Tail ビューでは、新しいログが画面の下部に表示され、背景が淡いコントラストになるため、最新情報を簡単に追跡できます。 1. ライブテーリングを一時停止し、中断することなく以前のログを調べる場合は、**[一時停止]** ボタンを選択するか、ログビューをスクロールするだけで確認できます。 1. ビューをクリアし、すべてのログを画面から削除するには、**[ログのクリア]** ボタンを選択します。このアクションによりログビューがリセットされ、白紙の状態となってログ分析を続行できます。 1. ライブテーリングを再開し、リアルタイムログの表示を続けるには、**[再開]** ボタンを選択します。 1. ライブテーリングを終了して標準の Explore ビューに戻る場合は、**[停止]** ボタンを選択します。 ライブテーリング機能を使用すると、最新のログが入ってきたときに注視できるため、リアルタイムイベントのモニタリングや問題の迅速な検出が容易になります。 **[ログサンプル]** 選択したデータソースがログサンプルを実装し、ログクエリとメトリクスクエリの両方をサポートしている場合、メトリクスクエリの場合は、視覚化されたメトリクスに寄与したログ行のサンプルを自動的に表示できます。この機能は、現在 Loki データソースでサポートされています。 **メトリクスからログに切り替える** `DataSourceWithQueryExportSupport` を実装するメトリクスデータソース (Prometheus など) から `DataSourceWithQueryImportSupport` をサポートするログデータソース (Loki など) に移行する場合、ログに存在するクエリのラベルは保持され、それらを使用してログストリームに対してクエリを実行します。 例えば、Loki データソースに切り替えた後の次の Prometheus クエリ `grafana_alerting_active_alerts{job='grafana'}` は、`{job='grafana'}` に変更されます。これにより、パターン一致検索/テキスト検索できる選択した時間範囲内のログのチャンクが返されます。 # Explore でのトレース **** このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 Explore を使用して、トレース中のデータソースからトレースを視覚化できます。 以下のデータソースがサポートされています。 + [Tempo](tempo-data-source.md) (サポートされている取り込み形式: OpenTelemetry 、Jaeger、Zipkin) + [Jaeger](jaeger-data-source.md) + [AWS X-Ray](x-ray-data-source.md) + [Zipkin](zipkin-data-source.md) 上記のデータソースのクエリを設定する方法については、特定のデータソースのドキュメントを参照してください。 ## クエリエディタ データソースのクエリエディタを使用して、トレース中のデータをクエリおよび検索できます。 各データソースには、独自のクエリエディタを使用できます。Tempo データソースのクエリエディタは、Jaeger データソースのクエリエディタとは若干異なります。 各データソースのクエリについては、各ドキュメントを参照してください。 + [Tempo](tempo-data-source.md) + [Jaeger](jaeger-data-source.md) + [AWS X-Ray](x-ray-data-source.md) + [Zipkin](zipkin-data-source.md) ## トレースビューの説明 このセクションでは、Trace View ダッシュボードの要素について説明します。 **ヘッダー** トレースビューのヘッダーには、次の要素があります。 + ヘッダータイトル – ルートスパンの名前とトレース ID を表示します。 + 検索 – 検索されたテキストを含むスパンを強調表示します。 + メタデータ – トレースに関するさまざまなメタデータを表示します。 **ミニマップ** 要約ビューまたはトレースタイムラインを表示します。ポインタをミニマップにドラッグして、より短い時間範囲にズームインできます。ズームはメインタイムラインも更新するため、短いスパンを簡単に確認できます。ミニマップにカーソルを合わせ、ズームすると、ズームをリセットする **[選択のリセット]** ボタンが表示されます。 **スパンフィルター** スパンフィルターを使用すると、トレースタイムラインビューワーでスパンをフィルタリングできます。追加するフィルターが多いほど、フィルターされたスパンがより具体的になります。 次の 1 つ以上のフィルターを追加できます。 + リソースサービス名 + スパン名 + 時間 + タグ (タグ、プロセスタグ、ログフィールドを含む) 一致したスパンのみを表示するには、**[Show matches only]** (一致のみを表示) トグルを選択します。 **タイムライン** トレース内のスパンのリストを表示します。各スパン行は、次の要素で構成されます。 + [Expand children] (子を展開) ボタン – 選択したスパンのすべての子スパンを展開または折りたたみます。 + サービス名 – スパンをログに記録したサービスの名前。 + オペレーション名 – このスパンが表すオペレーションの名前。 + スパン期間バー – トレース内のオペレーション期間の視覚的表現。 **スパンの詳細** スパン行を選択すると、以下を含むスパンの詳細が表示されます。 + オペレーション名 + スパンメタデータ + タグ – このスパンに関連付けられている任意のタグ。 + プロセスメタデータ – このスパンをログに記録したプロセスに関するメタデータ。 + ログ – このスパンおよび関連するキー値によってログに記録されたログのリスト。Zipkin ログの場合、セクションには Zipkin 注釈が表示されます。 **ログへのトレース** トレースビューのスパンから、そのスパンに関連するログに直接移動できます。これは、Tempo、Jaeger、および Zipkin データソースで使用できます。各データソースの設定方法については、関連するドキュメントを参照してください。 ドキュメントアイコンを選択して、設定されたデータソースを使用して Explore で分割ビューを開き、スパンに関連するログに対してクエリを実行します。 **メトリクスへのトレース** **注記** 現在、この機能はベータモードです。 トレースビューのスパンから、そのスパンに関連するメトリクスに直接移動できます。この機能は、Tempo、Jaeger、および Zipkin データソースで使用できます。設定の詳細については、関連するドキュメントを参照してください。 **プロファイルへのトレース** [Trace to profiles] (プロファイルへのトレース) を使用すると、トレースとプロファイルをリンクする機能を追加することで、さまざまなシグナルを関連付けられる Grafana の機能を利用できます。 ## ノードグラフ オプションで、表示されたトレースのノードグラフを展開できます。データソースによっては、トレースのスパンをグラフ内のノードとして表示したり、現在のトレースに基づくサービスグラフなどのコンテキストを追加したりできます。 ## サービスグラフビュー Service Graph ビューは、スパンメトリクス (レート、エラーレート、期間 (RED) のデータを追跡) とサービスグラフを視覚化します。要件が設定されると、この事前設定されたビューがすぐに利用できます。 詳細については、[Tempo](tempo-data-source.md) データソースのページを参照してください。[サービスグラフビューページ](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)は、「*Grafana Labs Tempo ドキュメント*」でも確認できます。 ## Data API この視覚化では、正しく表示するために、データソースから返されるデータの特定の形状が必要です。 データソースはデータフレームを返し、`frame.meta.preferredVisualisationType = 'trace'` を設定する必要があります。 **データフレーム構造** 必須フィールド | フィールド名 | タイプ | 説明 | | --- | --- | --- | | traceID | string | トレース全体の識別子。データフレームには 1 つのトレースのみが必要です。 | | spanID | string | 現在のスパンの識別子。SpanID はトレースごとに一意である必要があります。 | | parentSpanID | string | トレースビューで子親関係を作成するための親スパンの SpanID。親のないルートスパンでは undefined になる場合があります。 | | serviceName | string | このスパンが属するサービスの名前。 | | serviceTags | TraceKeyValuePair[] | サービスに関連するタグのリスト。 | | startTime | 数値 | スパンの開始時刻をミリ秒エポック時間で表します。 | | duration | 数値 | スパンの期間 (ミリ秒)。 | オプションのフィールド | フィールド名 | タイプ | 説明 | | --- | --- | --- | | ログ | TraceLog[] | 現在のスパンに関連付けられたログのリスト。 | | タグ | TraceKeyValuePair[] | 現在のスパンに関連付けられたタグのリスト。 | | warnings | string[] | 現在のスパンに関連付けられた警告のリスト。 | | stackTraces | string[] | 現在のスパンに関連付けられたスタックトレースのリスト。 | | errorIconColor | string | スパンに error: true がタグ付けされている場合のエラーアイコンの色。 | タイプの詳細については、GitHub の [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28)、[TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4)、および [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12) を参照してください。 # Explore の相関エディタ **** このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 相関関係により、ユーザーは 2 つのデータソース間のリンクを構築できます。相関関係の概要などの詳細については、「[Grafana バージョン 10 の相関関係](v10-correlations.md)」を参照してください。 ## 相関関係の作成 相関関係は、Explore ページから作成できます。 **相関を作成するには** 1. Amazon Managed Grafana ワークスペースで、Explore ページに移動します。 1. 新しい相関のソースにするデータソースを選択します。 1. サポートされている視覚化でデータを生成するクエリを実行します。 **注記** サポートされている視覚化は、[ログ](v10-panels-logs.md)と[テーブル](v10-panels-table.md)です。 1. 上部のツールバーで **[\$1 追加]** を選択し、**[相関の追加]** を選択します ([[コマンドパレット]](v10-search.md#v10-search-palette) から **[相関エディタ]** を選択することもできます)。 Explore が相関エディタモードになりました。このモードは青い境界線と上部のバーで示されます。上部のバーで **[Exit]** (終了) を選択すると、相関エディタを終了できます。 1. 新しいクエリの構築に使用できるデータのリンクを使用して、視覚化に次の新しい相関関係を作成できるようになりました。 + *[ログ]* – 各ログ行におけるログ詳細内のフィールド値の横にリンクが表示されます。 + *[テーブル]* – テーブルセルはすべてリンクです。 1. リンクを選択して、新しい相関関係を追加します。リンクは、相関の結果フィールドとして使用されるフィールドに関連付けられます。詳細については、[相関関係の設定](v10-correlations-config.md)を参照してください。 1. 開いた分割ビューで、右側のペインを使用して相関のターゲットクエリソースを設定します。詳細については、[ターゲットクエリ](v10-correlations-config.md#v10-correlations-config-target-query)を参照してください。 1. ペイン上部のリストにある変数を有する[変数構文](v10-dash-variable-syntax.md)を使用して、ターゲットクエリを構築します。リストには、選択したデータ行のサンプル値が含まれます。 1. ラベルと説明を入力します (任意)。ラベルは、視覚化内のリンク名として使用され、変数を含めることができます。 1. 変換を指定します (任意。詳細については、以下を参照してください）。 1. 上部のツールバーで **[保存]** を選択して相関を保存し、相関エディタモードを終了します。相関関係の作成に使用されるリンクは、各行のデータリンクに置き換えられます。リンクを選択すると、定義したクエリが別のペインで実行され、変数は選択した行の値で動的に置き換えられます。 ## 変換 変換を使用すると、他のデータを含むフィールドにある値を抽出できます。例えば、変換を使用すると、ログ行の一部を抽出して相関関係に使用できます。相関関係の変換の詳細については、「[相関関係の変換](v10-correlations-config.md#v10-correlations-config-transformations)」を参照してください。 エディタモードで生成されたリンクの 1 つを選択したのち、**[変換]** ドロップダウンメニューで **[変換の追加]** を選択すると、変換を追加できます。 **相関関係で変換を使用するには** 1. 変換を適用するフィールドを選択します。変換に使用するフィールドの一部を選択します。例えば、ログ行です。選択すると、このフィールドの値が変換の構築に使用されます。 1. 変換のタイプを選択します。オプションと関連する設定については、「[相関関係の変換](v10-correlations-config.md#v10-correlations-config-transformations)」を参照してください。 1. 選択に基づいて、1 つ以上の変数の入力や、表示されるオプションでさらに仕様を指定する必要がある場合があります。 1. **[相関に変換を追加]** を選択して、指定した変数を使用可能な変数のリストに追加します。 **注記** このダイアログボックスにある正規表現の場合、他のドキュメントで参照されている `mapValue` は、ここでは `Variable Name` と呼び出されます。Grafana は、フィールド値の式に一致する任意のテキストを強調表示します。正規表現キャプチャグループを使用して、抽出する一致部分を選択します。有効な正規表現を指定すると、 変数とその変数の値が `Variable Name` フィールドの下に表示されます。 ## 相関の例 次の例は、Explore の相関エディタを使用して相関を作成する方法を示しています。これらの例に従う場合は、必ず[テストデータソース](testdata-data-source.md)を設定してください。 ### テキストとグラフの相関関係の作成 この例では、Explore の相関エディタを使用して相関を作成する方法を示しています。 相関関係を使用すると、1 つのクエリの結果を使用して、任意のデータソースで新しいクエリを実行できます。この例では、表形式データをレンダリングするクエリを実行します。データは、グラフ結果を生成する別のクエリを実行するために使用されます。 この例に従うには、必ず[テストデータソース](testdata-data-source.md)を設定してください。 **テキストとグラフの相関関係を作成するには** 1. Grafana で、**Explore** に移動します。 1. ページの左上にあるドロップダウンメニューから**テストデータソース**を選択します。 1. 右側のドロップダウンメニューで **[\$1 追加]** を選択し、**[相関の追加]** を選択します。 1. Explore が相関エディタモードになり、青い境界線で示されます。 1. シナリオドロップダウンメニューから **CSV ファイル**シナリオを選択します。 1. ファイル **population\$1by\$1state.csv** を選択します。各セルは、新しい相関関係の作成を開始するためにクリックできるリンクです。 1. `State` 列内の任意のセルをクリックして、そのエントリにデータリンクが付属する新しい相関関係を作成します。例えば、`California` を選択します。 1. 分割ビューで、左側のペインで選択したのと同じデータソースを選択します。クエリエディタの上にあるヘルパーには、ターゲットクエリを使用できる利用可能な変数がすべて含まれています。変数には、選択した行のすべてのデータフィールド (テーブル列) が含まれます。 1. **[シナリオ]** メニューで、**[CSV メトリクス値]** を選択します。クエリエディタの `String Input` フィールドには、各年の母集団値を持つ変数 `${1980},${2000},${2020}` が表示されます。これにより、変数値を使用してグラフが生成されます。 1. クエリエディタの **[Alias]** (エイリアス) フィールドに、`${State}` と入力します。 クエリを実行して、変数のサンプル値を使用してグラフが生成されることを確認します。 1. **[保存]** を選択して相関を保存し、相関エディタを終了します。 相関が保存されると、Explore は左側のペインでクエリを再実行します。状態名をクリックすると、右側のクエリが CSV に挿入された行の値で再実行され、グラフが変更されます。クエリは、状態名をクリックするたびに更新された値で再実行されます。 同じステップを任意のデータソースに適用できます。相関関係を使用すると、選択したデータに基づいて動的クエリを実行するためのリンクを視覚化で作成できます。この例では、クエリによって返されるデータを使用して、同じデータソースを使用して異なる視覚化を生成する新しいクエリを構築しました。ただし、任意のデータソース間に相関関係を作成して、カスタム探索フローを作成することもできます。 ### ログとテーブルの相関関係の作成 この例では、相関関係を作成して、変換を使用してログ行と別のフィールドから値を抽出する方法を示します。 この例に従うには、必ず[テストデータソース](testdata-data-source.md)を設定してください。 **ログとテーブルの相関関係を作成するには** 1. Grafana で、**Explore** に移動します。 1. ページの左上にあるドロップダウンメニューから**テストデータソース**を選択します。 1. 右側のドロップダウンメニューで **[\$1 追加]** を選択し、**[相関の追加]** を選択します。 1. Explore が相関エディタモードになり、青い境界線で示されます。 1. **[Scenario]** メニューで、**[ログ]** を選択します。 1. ログ行を展開して、相関リンクを確認します。`Correlate with hostname` を選択します。 1. Explore が分割ビューで開きます。左側のペインで選択したのと同じデータソースを選択します。クエリエディタの上にあるヘルパーには、ターゲットクエリを使用できる利用可能な変数がすべて含まれています。 1. 変換セクションを展開し、**[変換の追加]** をクリックします。 1. **フィールド**ドロップダウンメニューで**メッセージ**を選択します。ログ行がサンプルデータとして表示されます。 1. **タイプ**で **[Logfmt]** を選択します。これにより、変数のリストが入力されます。 1. **[相関に変換を追加]** を選択します。 1. 再度 **[変換の追加]** を選択し、**[フィールド]**で**[ホスト名]**を選択します。 1. **タイプ**で**[正規表現]** を選択します。 1. **[式]** に `-([0-9]\*)` と入力します。これにより、ダッシュの右側にある任意の数値が選択されます。 1. **[変数名)]** に `hostNumber` と入力します。これにより、変数のリストが入力されます。 1. **[相関に変換を追加]** を選択して、他の変数に追加します。 1. データソースエディタで **[Scenario]** (シナリオ) ドロップダウンメニューを開き、**[CSV Content]** (CSV コンテンツ) を選択します。 1. 下にあるテキストボックスに以下を入力し、相関関係を保存します。 ``` time,msg,hostNumber,status ${time},${msg},${hostNumber},${status} ``` これにより、分割ビューが閉じ、左側のクエリが再実行されます。任意のログ行を展開して、相関ボタンを確認します。相関ボタンを選択すると、分割ビューが開き、`time` (フィールド)、`msg` (ログ行から *logfmt* で抽出)、`host number` (`hostname` から*正規表現*で抽出)、`status` (ログ行から *logfmt* で抽出) が表示されます。 # Explore の Inspector **** このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。 Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。 Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。 インスペクターは、クエリの理解とトラブルシューティングに役立ちます。未加工データを検査し、そのデータをカンマ区切り値 (CSV) ファイルにエクスポートし、ログ結果を TXT 形式でエクスポートし、クエリリクエストを表示できます。 ## Inspector UI インスペクターには次のタブがあります。 + **[統計タブ]** – クエリにかかる時間および返される量を示します。 + **[クエリタブ]** – Grafana がデータソースへのクエリ実行時に送信されるサーバーへのリクエストを表示します。 + **[JSON] タブ** – データ JSON とデータフレーム構造 JSON を表示およびコピーできます。 + **[データタブ]** – クエリによって返される未加工データを表示します。 + **[エラータブ]** – エラーを表示します。クエリがエラーを返す場合にのみ表示されます。 ## Inspector タスク Explore Inspector では、さまざまなタスクを実行できます。 **Inspector を開く** 検査するクエリを実行したら、**[Inspector]** ボタンを選択します。 画面の下部にインスペクターペインが開きます。 **未加工クエリ結果の検査** 未加工のクエリ結果、つまりクエリによって返されるデータをテーブルに表示できます。 **[Inspector]** タブで、**[Data]** タブをクリックします。 複数のクエリまたは複数のノードのクエリには、追加のオプションがあります。 + **[データフレームを表示する]:** 表示する結果セットデータを選択します。 + **[時間で結合された系列]**: すべてのクエリの未加工データを一度に表示し、列ごとに結果セットを 1 つ表示します。列見出しをクリックしてデータをソートできます。 **未加工のクエリ結果を CSV としてダウンロード** Grafana は、ブラウザのデフォルトのダウンロード場所に CSV ファイルを生成します。お好みのビューワーで開くことができます。 1. **[Inspector]** タブで、上記の手順に従って未加工のクエリ結果を取得します。 1. エクスポートする未加工データが表示されるまで、クエリ設定を絞り込みます。 1. **[CSV のダウンロード]** を選択します。 Excel 用にフォーマットされた CSV ファイルをダウンロードするには、**[データオプション]** を展開して **[Excel 用にダウンロード]** トグルをオンにしてから、**[CSV のダウンロード]** オプションを選択します。 **ログ結果を TXT としてダウンロード** **[Inspector]** タブで **[ログのダウンロード]** を選択すると、現在表示しているログの TXT ファイルを生成できます。 **トレース結果のダウンロード** データソースタイプに基づいて、Grafana は、サポートされている形式 (Jaeger、Zipkin、または OTLP 形式) のいずれかでトレース結果の JSON ファイルを生成します。 1. [Inspector] を開きます。 1. ログクエリの結果を検査します。エクスポートする未加工ログが表示されるまで、結果を絞り込みます。 1. **[ログのダウンロード** を選択します。 **クエリパフォーマンスの検査** **[統計]** タブには、クエリにかかる時間、送信したクエリの数、返された行数を示す統計が表示されます。この情報は、特に数値が予想外に高い場合や低い場合のクエリのトラブルシューティングに役立ちます。 統計が読み取り専用形式で表示されます。 **[JSON モデルの表示]** データだけでなく、データフレーム JSON モデルも探索してエクスポートできます。 **JSON モデルを表示するには** 1. インスペクターパネルで、**[JSON]** タブをクリックします。 1. **[ソースの選択]** ドロップダウンから、以下のいずれかのオプションを選択します。 + **[データ]** – Explore に返されたデータを表す JSON オブジェクトを表示します。 + **[データフレーム構造]** – 未加工の結果セットを表示します。 1. JSON の一部を展開または折りたたんで、個別のセクションを表示できます。**[クリップボードにコピー]** オプションを選択して、JSON 本文をコピーし、別のアプリケーションに貼り付けることもできます。 **データソースへの未加工リクエストとレスポンスの表示** Explore と Inspector タブを操作すると、クエリで生成する未加工のリクエストとレスポンスデータを表示できます。Inspector で **[クエリ]** タブを選択し、**[更新]** を選択して未加工データを表示します。 Grafana はクエリをサーバーに送信し、結果を表示します。クエリの特定の部分をドリルダウン、そのすべてを展開または折りたたみ、またはデータをクリップボードにコピーして他のアプリケーションで使用できます。