Explore の相関エディタ - Amazon Managed Grafana
相関関係の作成変換相関の例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Explore の相関エディタ

このドキュメントトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けに設計されています。

Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業。

Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業。

相関関係により、ユーザーは 2 つのデータソース間のリンクを構築できます。相関関係の概要などの詳細については、「」を参照してくださいGrafana バージョン 10 の相関関係。

相関関係の作成

相関関係は、Explore ページから作成できます。

相関を作成するには

  1. Amazon Managed Grafana ワークスペースで、Explore ページに移動します。

  2. 新しい相関のソースにするデータソースを選択します。

  3. サポートされている視覚化でデータを生成するクエリを実行します。

    注記

    サポートされているビジュアライゼーションは、ログとテーブル です。

  4. 上部のツールバーで + 追加 を選択し、相関を追加 を選択します (コマンドパレット から相関エディタを選択することもできます。

    Explore は、青い境界線とトップバーで示される相関エディタモードになりました。相関エディタを終了するには、上部のバーで終了を選択します。

  5. 新しいクエリの構築に使用できるデータにアタッチされたリンクを使用して、視覚化に対して次の新しい相関関係を作成できるようになりました。

    • ログ – 各ログ行のログ詳細内のフィールド値の横にリンクが表示されます。

    • テーブル – すべてのテーブルセルがリンクです。

  6. リンクを選択して、新しい相関関係を追加します。リンクは、相関の結果フィールドとして使用されるフィールドに関連付けられます。詳細については、「相関設定」を参照してください。

  7. 開いた分割ビューで、右側のペインを使用して相関のターゲットクエリソースを設定します。詳細については、「ターゲットクエリ」を参照してください。

  8. ペインの上部にあるリストの変数を使用して、変数構文を使用してターゲットクエリを構築します。リストには、選択したデータ行のサンプル値が含まれています。

  9. ラベルと説明を入力します (オプション）。ラベルは視覚化内のリンクの名前として使用され、変数を含めることができます。

  10. 変換を指定します (オプション。詳細については、以下を参照してください）。

  11. 上部のツールバーで保存 を選択して相関を保存し、相関エディタモードを終了します。相関関係の作成に使用されるリンクは、各行のデータリンクに置き換えられます。リンクを選択すると、定義したクエリが別のペインで実行され、変数は選択した行の値で動的に置き換えられます。

変換

変換を使用すると、他のデータを含むフィールドに存在する値を抽出できます。例えば、変換を使用すると、ログ行の一部を抽出して相関に使用できます。相関関係の変換の詳細については、「」を参照してください相関変換。

エディタモードで生成されたリンクのいずれかを選択したら、変換ドロップダウンメニューで変換を追加 を選択して変換を追加できます。

相関関係で変換を使用するには

  1. 変換を適用するフィールドを選択します。変換に使用するフィールドの部分を選択します。例えば、ログ行などです。選択すると、このフィールドの値が変換の構築に役立ちます。

  2. 変換のタイプを選択します。オプションと関連する設定については、相関変換「」を参照してください。

  3. 選択内容に基づいて、1 つ以上の変数が入力されることもあれば、表示されるオプションでさらに仕様を指定する必要がある場合もあります。

  4. 「相関への変換の追加」を選択して、指定された変数を使用可能な変数のリストに追加します。

注記

このダイアログボックスの正規表現の場合、他のドキュメントでmapValue参照されている はここで呼び出Variable Nameされます。Grafana は、フィールド値の式に一致するテキストをすべて強調表示します。正規表現キャプチャグループを使用して、一致のどの部分を抽出するかを選択します。有効な正規表現を指定すると、 変数とその変数の値が Variable Nameフィールドの下に表示されます。

相関の例

次の例は、Explore の相関エディタを使用して相関を作成する方法を示しています。これらの例に従う場合は、必ずテストデータソース を設定してください。

テキストとグラフの相関関係の作成

この例では、Explore で相関エディタを使用して相関を作成する方法を示します。

相関関係を使用すると、1 つのクエリの結果を使用して、任意のデータソースで新しいクエリを実行できます。この例では、表形式のデータをレンダリングするクエリを実行します。データは、グラフ結果を生成する別のクエリを実行するために使用されます。

この例に従うには、テストデータソース が設定されていることを確認してください。

テキストとグラフの相関関係を作成するには

  1. Grafana で、Explore に移動します。

  2. ページの左上にあるドロップダウンメニューからテストデータソースを選択します。

  3. 右側のドロップダウンメニューで + 追加 を選択し、相関を追加 を選択します。

  4. Explore が相関エディタモードになり、青い境界線で示されます。

  5. シナリオドロップダウンメニューから次のシナリオを選択します: CSV ファイル 。

  6. ファイル population_by_state.csv を選択します。各セルは、新しい相関関係の作成を開始するためにクリックできるリンクです。

  7. State 列内の任意のセルをクリックして、そのエントリにデータリンクをアタッチする新しい相関関係を作成します。例えば、California を選択します。

  8. 分割ビューで、左側のペインで選択したのと同じデータソースを選択します。クエリエディタの上にあるヘルパーには、ターゲットクエリを使用できるすべての変数が含まれています。変数には、選択した行のすべてのデータフィールド (テーブル列) が含まれます。

  9. シナリオメニューで、CSV メトリクス値 を選択します。クエリエディタの String Inputフィールドは、各年の母集団値を含む変数を提供します: ${1980},${2000},${2020}。これにより、変数値を使用してグラフが生成されます。

  10. クエリエディタのエイリアス フィールドに、 と入力します${State}。

    クエリを実行して、変数のサンプル値を使用してグラフが生成されることを確認します。

  11. 保存 を選択して相関を保存し、相関エディタを終了します。

    相関が保存されると、Explore は左側のペインでクエリを再実行します。状態名をクリックすると、右側のクエリが CSV に挿入された行の値で再実行されるため、グラフが変更されます。クエリは、状態名をクリックするたびに更新された値で再実行されます。

どのデータソースにも同じ手順を適用できます。相関関係を使用すると、ビジュアライゼーションにリンクを作成して、選択したデータに基づいて動的クエリを実行できます。この例では、クエリによって返されるデータを使用して、同じデータソースを使用して異なる視覚化を生成する新しいクエリを構築しました。ただし、任意のデータソース間に相関関係を作成して、カスタム探索フローを作成できます。

ログとテーブルの相関関係の作成

この例では、相関関係を作成して、変換を使用してログ行と別のフィールドから値を抽出する方法を示します。

この例に従うには、テストデータソース が設定されていることを確認してください。

ログとテーブルの相関関係を作成するには

  1. Grafana で、Explore に移動します。

  2. ページの左上にあるドロップダウンメニューからテストデータソースを選択します。

  3. 右側のドロップダウンメニューで + 追加 を選択し、相関を追加 を選択します。

  4. Explore が相関エディタモードになり、青い境界線で示されます。

  5. シナリオメニューで、ログ を選択します。

  6. ログ行を展開して、相関リンクを確認します。Correlate with hostname を選択します。

  7. 分割ビューで開いた を探索します。左ペインで選択したのと同じデータソースを選択します。クエリエディタの上にあるヘルパーには、ターゲットクエリを使用できるすべての変数が含まれています。

  8. 変換セクションを展開し、「変換を追加」をクリックします。

  9. フィールドドロップダウンメニューで、メッセージ を選択します。ログ行がサンプルデータとして表示されます。

  10. タイプ で、Logfmt を選択します。これにより、変数のリストが入力されます。

  11. 相関 に変換を追加 を選択します。

  12. もう一度変換を追加を選択し、フィールド でホスト名 を選択します。

  13. タイプ で、正規表現 を選択します。

  14. 式 に、 と入力します-([0-9]\*)。これにより、ダッシュの右側にある任意の数字が選択されます。

  15. 可変名 に、 と入力しますhostNumber。これにより、変数のリストが入力されます。

  16. トランスフォーメーションを相関に追加 を選択して、他の変数に追加します。

  17. データソースエディタで、シナリオドロップダウンメニューを開き、CSV コンテンツ を選択します。

  18. 以下のテキストボックスに以下を入力し、相関関係を保存します。

    time,msg,hostNumber,status
${time},${msg},${hostNumber},${status}

    これにより分割ビューが閉じ、左側のクエリが再実行されます。任意のログ行を展開すると、相関ボタンが表示されます。相関ボタンを選択すると、分割ビューが開きtime、 (フィールド）msg、 (ログラインから logfmt で抽出）、 host number ( から正規表現で抽出hostname）、 status (ログラインから logfmt で抽出) が表示されます。