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

変換関数

データに関する次の変換を実行できます。

計算からのフィールドの追加

この変換を使用して、他の 2 つのフィールドから計算した新しいフィールドを追加します。各変換では 1 つの新しいフィールドを追加できます。

連結フィールド

[連結フィールド]

この変換を使用して、全フレームの全フィールドを 1 つの結果に結合します。

例えば、温度とアップタイムデータ (クエリ A) と空気品質インデックスとエラー情報 (クエリ b) を取得する個別のクエリがある場合、連結変換を適用すると、すべての関連情報が 1 つのビューに統合されたデータフレームが生成されます。

次の 2 つについて考えてみましょう。

クエリ A

クエリ B

フィールドを連結すると、データフレームは次のようになります。

この変換により、さまざまなソースからのデータをマージするプロセスが簡素化され、分析と視覚化の包括的なビューが提供されます。

クエリ結果から設定

[クエリ結果から設定]

この変換を使用して、1 つのクエリを選択し、[最小] 、[最大] 、[単位]、[しきい値]などの標準オプションを抽出し、他のクエリ結果に適用します。これにより、特定のクエリによって返されるデータに基づいて、動的な視覚化設定が可能になります。

オプション

フィールドマッピングテーブル

設定オプションの下に、フィールドマッピングテーブルがあります。このテーブルには、設定クエリによって返されるデータに含まれるすべてのフィールドと、[用途] および [選択] オプションが一覧表示されます。設定プロパティへのマッピングフィールドを制御でき、複数の行に対して選択する値を選べます。

次の例は、入力クエリとフィールド設定として使用されるクエリを示しています。

入力クエリ

設定クエリ

出力クエリ (入力と同じですが、値フィールドに 設定が追加されました)

各フィールドで最大設定オプションが設定されるようになりました。[最小値]、[最大値]、[単位]、[しきい値] などのオプションは、フィールド設定の一部です。設定すると、パネルエディタのオプションペインで手動で設定されたオプションではなく、視覚化によって使用されます。

[値のマッピング]

クエリ結果を値のマッピングに変換することもできます。このオプションでは、設定クエリ結果のすべての行で 1 つの値のマッピング行を定義します。次の例を参照してください。

設定クエリ結果

フィールドマッピングで、以下を指定します。

Grafana はクエリ結果から値マッピングを構築し、実際のデータクエリ結果に適用します。設定クエリの結果に従って、値がマッピングされ、色付けされているはずです。

フィールドタイプの変換

この変換を使用して、指定されたフィールドのフィールドタイプを変更します。

この変換には、次のオプションがあります。

例えば、時間フィールドを [時間] として、日付形式を YYYY として選択することで変更できる次のクエリを考えてみましょう。

結果

この変換により、データタイプを柔軟に適応させ、視覚化の互換性と一貫性を確保できます。

Extract Fields (フィールドの抽出)

この変換を使用して、データソースを選択し、さまざまな形式でそこからコンテンツを抽出します。この変換には次のフィールドがあります。

以下のデータセットを考えてみましょう。

データセットの例

この設定を使用して、時系列パネルで使用されるデータを準備できます。

これにより、次の出力が生成されます。

[変換されたデータ]

この変換では、さまざまな方法でデータを抽出、フォーマットできます。特定のデータニーズに基づいて抽出形式をカスタマイズできます。

リソースからフィールドを検索

この変換を使用して、外部ソースから追加のフィールドを検索してフィールド値を充実させます。

この変換には次のフィールドがあります。

例えば、以下のデータがある場合を考えてみましょう。

データセットの例

この設定では、次のようになります。

この場合、次の出力が返されます。

[変換されたデータ]

この変換により、外部ソースから追加情報を取得してデータを拡張し、分析と視覚化のためのより包括的なデータセットを提供できます。

クエリ refId によるデータのフィルタリング

この変換を使用して、複数のクエリがあるパネル内の 1 つ以上のクエリを非表示にします。

Grafana では、クエリ識別文字がダークグレーテキストで表示されます。フィルタリングを切り替えるには、クエリ識別子を選択します。クエリ文字が白い場合、結果が表示されます。クエリ文字が暗い場合、結果は非表示です。

値によるデータのフィルタリング

この変換を使用して、視覚化内で直接データポイントを選択的にフィルタリングします。この変換では、選択したフィールドに適用された 1 つ以上の条件に基づいて、データを含める、または除外するためのオプションを提供します。

この変換は、データソースが値によってネイティブにフィルタリングしない場合に非常に便利です。共有クエリを使用している場合、これを使用して値を絞り込んで表示することもできます。

すべてのフィールドで使用できる条件は次のとおりです。

数値フィールドで使用可能なその他の条件は次のとおりです。

以下のデータセットを考えてみましょう。

温度が 30°C 未満のデータポイントを [含める] にすると、設定は次のようになります。

30°C 未満の温度のみが含まれる場合、次の結果が得られます。

[変換されたデータ]

複数の条件をフィルターに追加できます。例えば、高度が 100 を超える場合にのみデータを含めることができます。これを行うには、次の設定にその条件を追加します。

複数の条件がある場合、条件にすべて一致、または追加した条件のいずれかに一致する行にアクション (包含/除外) を適用するかを選択できます。

上記の例では、温度が 30°C 未満かつ高度が 100 を超える行を含めるため、[すべて一致] を選択しました。温度が 30°C 未満または高度が 100 を超える行を含める場合は、[任意の一致] を選択します。これには、元のデータの最初の行が含まれます。元のデータの温度は 32°C (最初の条件と一致しない) ですが、高度は 101 (2 番目の条件と一致する) であるため、含まれます。

無効または不完全な設定条件は無視されます。

この汎用的なデータフィルタリング変換により、特定の条件に基づいてデータポイントを選択的に含めたり除外したりできます。条件をカスタマイズしてデータプレゼンテーションを調整し、独自の分析ニーズを満たすことが可能です。

Filter fields by name (名前によるフィールドのフィルタリング)

この変換を使用して、クエリ結果の一部を削除します。フィールド名をフィルタリングする方法は 3 つあります。

正規表現を使用

正規表現を使用してフィルタリングすると、正規表現に一致するフィールド名が含まれます。例えば、正規表現 'prod.*' を使用すると、prod で始まるフィールドのみが返されます。

正規表現には、${variableName} 構文を使用して補間されたダッシュボード変数を含めることができます。

含まれるフィールドを手動で選択

フィールド名を選択または選択解除して、結果から削除します。正規表現も含まれている場合、チェックが入っていない場合でも、式に一致するフィールドが含まれます。

ダッシュボード変数を使用

[変数から] を選択すると、フィールドを含めるために使用されるダッシュボード変数を選択できます。複数の選択肢を持つダッシュボード変数を設定することで、同じフィールドを複数の視覚化にわたって表示できます。

この変換により、効果的な分析と視覚化に必要な特定のフィールドに焦点を当てて、クエリ結果を柔軟に調整できます。

文字列の形式を設定する

この変換を使用して、文字列フィールドの出力をカスタマイズします。この変換には次のフィールドがあります。

この変換により、視覚化と分析を向上させるために文字列データのプレゼンテーションを標準化して調整する便利な方法が提供されます。

時間形式

この変換を使用して、時間フィールドの出力をカスタマイズします。出力は、Moment.js 形式の文字列を使用してフォーマットできます。例えば、時間フィールドの年のみを表示する場合は、形式文字列「YYYY」を使用して暦年 (1999 年や 2012 年など) を表示できます。

[変換前]

「YYYY-MM-DD HH:mm:ss」を適用した後

この変換により、視覚化の時間表現を調整し、時間データを表示する柔軟性と精度を提供できます。

グループ化の条件

この変換では、指定されたフィールド (列) 値でデータをグループ化し、各グループの計算を処理します。計算選択肢のリストの表示を選択します。

オリジナルデータの例を次に示します。

この変換では 2 つのステップを実行します。まず、データをグループ化させる 1 つ以上のフィールドを指定します。これにより、これらのフィールドの同じ値すべてが、ソートされたかのようにグループ化されます。例えば、サーバー ID フィールドでグループ化すると、次のようにデータがグループ化されます。

同じ値のサーバー ID を持つすべての行がグループ化されます。

データをグループ化するフィールドを選択すると、他のフィールドにさまざまな計算を追加でき、その計算を行の各グループに適用できます。例えば、これらの各サーバーの平均 CPU 温度を計算できます。そのため、CPU 温度フィールドに適用される[平均]計算を追加して、以下を取得できます。

また、複数の計算を追加できます。例:

その後、以下を取得します。

この変換により、時系列からキー情報を抽出して便利な方法で表示できます。

Grouping to matrix (マトリックスへのグループ化)

この変換を使用して、クエリ出力の [列]、[行]、[セル値] フィールドの入力として使用される 3 つのフィールドを組み合わせて、マトリックスを生成します。以下のようにマトリックスが計算されます。

元のデータ

列名として Server Status の値、行名として Server ID の値、各セルの内容として CPU Temperature の値を使用して、マトリックスを生成できます。既存の列 (Server Status) と行の組み合わせ (Server ID) には、各セルの内容が表示されます。残りのセルでは、[Null]、[真]、[偽] 、または [空] のどの値を表示するかを選択できます。

出力

この変換を使用して、クエリ結果からフィールドを指定してマトリックスを作成します。マトリックスの出力には、これらのフィールドの一意の値間の関係が反映されます。これにより、複雑な関係を明確で構造化されたマトリックス形式で提示できます。

Group to nested table (ネストされたテーブルにグループ化)

この変換を使用して、指定されたフィールド (列) 値でデータをグループ化し、各グループの計算を処理します。同じグループ化されたフィールド値を共有するレコードが生成され、ネストされたテーブルに表示されます。

フィールドの統計を計算するには、フィールドの横にあるボックスを選択し、[計算]オプションを選択します。これにより、統計を選択する別の選択ボックスが追加されます。

次の表にサンプルデータを示します。

この変換には 2 つのステップがあります。まず、データをグループ化するフィールドを 1 つ以上指定します。これにより、これらのフィールドの同じ値がすべて、ソートされたかのようにグループ化されます。例えば、Server ID フィールドでグループ化した場合、Grafana は次のようにデータをグループ化します。

データをグループ化するフィールドを選択すると、他のフィールドにさまざまな計算を追加でき、その計算を行の各グループに適用できます。例えば、これらの各サーバーの平均 CPU 温度を計算できます。これを行うには、CPU 温度フィールドに適用された平均計算を追加して、次の結果を取得します。

Create heatmap (ヒートマップの作成)

この変換を使用して、経時的な傾向を視覚化するためのヒストグラムデータを作成します。ヒートマップ視覚化と同様に、この変換はヒストグラムメトリクスを時間バケットに変換します。

X バケット

この設定は、X 軸をバケットに分割する方法を決定します。

Y バケット

この設定は、Y 軸をバケットに分割する方法を決定します。

次のデータセットがあるとします。

ヒストグラム

この変換を使用して、入力データに基づいてヒストグラムを生成することで、値の分布を視覚化できます。

元のデータ

系列 1

系列 2

出力

生成されたヒストグラムを使用して値の分布を視覚化し、データの広がりと密度に関するインサイトを提供します。

Join by field (フィールドで結合)

この変換を使用して、複数の結果を 1 つのテーブルにマージすることで、異なるクエリからのデータを統合できます。

複数の時系列の結果を共有時間フィールドを持つ 1 つのワイドテーブルに変換する場合に特に便利です。

Inner join (内部結合)

内部結合は、選択したフィールドからすべてのテーブルが同じ値を共有する複数のテーブルからのデータをマージします。このタイプの結合では、すべての結果で値が一致しないデータを除外します。

この変換を使用して、複数のクエリの結果 (渡された結合フィールドまたは最初の列の組み合わせ) を 1 つの結果に結合し、正常な結合を実行できない行を削除します。

次の例では、2 つのクエリがテーブルデータを返します。内部結合変換を適用する前に、2 つの個別のテーブルとして視覚化されます。

クエリ A

クエリ B

内部結合変換を適用した後の結果は次のようになります。

Outer join (外部結合)

外部結合には、すべての入力で値が一致しない内部結合と行のすべてのデータが含まれます。内部結合が時間フィールドでクエリ A とクエリ B を結合している間、外部結合には時間フィールドで一致しないすべての行が含まれます。

次の例では、2 つのクエリがテーブルデータを返します。外部結合変換を適用する前に、2 つのテーブルとして視覚化されます。

クエリ A

クエリ B

外部結合変換を適用した後の結果は次のようになります。

Join by labels (ラベルで結合)

この変換を使用して、複数の結果を 1 つのテーブルに結合します。

これは、複数の時系列の結果を共有[ラベル]フィールドを持つ単一のワイドテーブルに変換する場合に特に便利です。

例

入力 1: series1{what='Temp', cluster='A', job='J1'}

入力 2: series2{what='Temp', cluster='B', job='J1'}

入力 3: series3{what='Speed', cluster='B', job='J1'}

構成

value: 'what'

出力

時系列データをこの変換と効果的に組み合わせて整理し、包括的なインサイトを提供します。

フィールドへのラベル付け

この変換を使用して、ラベルまたはタグを含む時系列の結果を、結果の各ラベルのキーと値を含むテーブルに変換します。ラベルを列または行の値として表示して、拡張データの視覚化を行います。

2 つの時系列のクエリ結果を示します。

[列] モードでは、結果は次のように表示されます。

[Rows] (行) モードでは、結果には各系列のテーブルがあり、次のような各ラベル値が表示されます。

値フィールド名

値フィールド名としてサーバーを選択した場合、サーバーラベルの値ごとに 1 つのフィールドを取得します。

マージ動作

フィールドトランスフォーマーへのラベルは、内蔵されている 2 つの異なる変換です。1 つ目は、1 つの系列で動作し、ラベルをフィールドに抽出します。2 つ目は、すべての結果を 1 つのテーブルに結合するマージ変換です。マージ変換は、一致するすべてのフィールドで結合を試みます。このマージステップは必須であり、オフにすることはできません。

これを説明するために、重複ラベルのない時系列を返すクエリが 2 つある例を次に示します。

これにより、まず次の 2 つのテーブルが作成されます。

マージ後

[制限]

この変換を使用して、表示される行数を制限し、データに対してより焦点を絞ったビューを提供します。これは、大規模なデータセットを処理する場合に特に便利です。

以下は、データソースからのレスポンスに対する[制限]変換の影響を示す例です。

以下は、値が「3」の制限変換を追加した後の結果です。

この変換により、データの視覚的な表示を調整して、最も関連性の高いデータに集中できます。

Merge series/tables (系列/テーブルのマージ)

この変換を使用して、複数のクエリの結果を 1 つの結果に結合します。これは、テーブルパネルの視覚化を使用する場合に特に便利です。共有フィールドに同じデータが含まれている場合、変換は値を同じ行にマージします。

以下に、テーブルデータを返す 2 つのクエリに対する [系列/テーブルのマージ] 変換の影響を例示します。

クエリ A

クエリ B

マージ変換を適用した後の結果は次のとおりです。

この変換では、クエリ A とクエリ B の値を統一されたテーブルに結合し、より良いインサイトを得るためにプレゼンテーションを強化します。

Organize fields by name (名前でフィールドを整理)

この変換を使用して、パネル内の 1 つのクエリによって返されるフィールドの名前を変更、並べ替え、または非表示にします。この変換は単一クエリを持つパネルでのみ機能します。パネルに複数のクエリがある場合は、[外部結合] 変換を適用するか、追加のクエリを削除する必要があります。

[フィールドの変換]

Grafana では、クエリが返すフィールドのリストが表示されます。次のようにできます。

例

この最初のクエリ結果を考慮すると、次のようになります。

名前変更フィールドオーバーライドを適用して、以下を作成できます。

この変換により、クエリ結果の表示をカスタマイズし、Grafana 内のデータに対して明確で本質を突いた表現を確保できます。

値による分割

この変換を使用して、異なる WHERE 句を持つ複数のクエリを必要とせずに、複数の系列をグラフ化するプロセスを合理化します。

これは、以下の例のように、メトリクス SQL テーブルを使用する場合に特に便利です。

[値による分割]トランスフォーマーを使用すると、単一のクエリを発行し、選択した 1 つ以上の列 (フィールド) に対して一意の値で結果を分割できます。次の例では Region を使用しています。

SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'

この変換により、プロセスが簡素化され、同じ時系列視覚化内で複数の系列を視覚化する柔軟性が向上します。

Prepare times series (時系列の準備)

この変換を使用して、データソースが目的の視覚化と互換性のない形式で時系列データを返す際の問題に対処します。この変換により、時系列データをワイド形式とロング形式との間で変換できます。

[マルチフレーム時系列]

このオプションを使用して、時系列データフレームをワイド形式からロング形式に変換します。これは、データソースが視覚化と最適な互換性を得るために再形成する必要がある形式で、時系列情報を配信する場合に特に役立ちます。

例

入力

次のように変換できます。

[ワイド時系列]

このオプションを使用して、時系列データフレームをロング形式からワイド形式に変換します。これは、データソースが時系列データをロング形式で配信し、視覚化にワイド形式が必要な場合に特に役立ちます。

例

入力

次のように変換できます。

削減

この変換を使用すると、データフレームの各フィールドに計算が適用され、単一の値が返されます。この変換は、複数の時系列データをよりコンパクトで要約された形式に統合するために特に役立ちます。この変換を適用すると、時間フィールドは削除されます。

以下の入力を検討します。

クエリ A

クエリ B

縮小のトランスフォーマーには 2 つのモードがあります。

例えば、系列で[最初]と[最後]の計算を使用して[シリーズから行]変換を行った場合、結果は次のようになります。

最後の計算における縮小フィールドは、それぞれ 1 行、2 つのフレームになります。

クエリ A

クエリ B

正規表現で名前を変更

この変換を使用して、正規表現と置換パターンを使用してクエリ結果の一部の名前を変更します。

正規表現を指定できます。正規表現は、バックリファレンスをサポートする置換パターンとともに、一致にのみ適用されます。例えば、ホストあたりの CPU 使用率を視覚化し、ドメイン名を削除するとします。正規表現を ([^\.]+)\..+ に設定し、置換パターンを $1 に設定することで、web-01.example.com は web-01 になります。

この変換により、視覚化のニーズに合わせてデータをカスタマイズできるため、ダッシュボードはより有益でユーザーフレンドリーになります。

Rows to fields (行からフィールドへ)

この変換を使用して、行を別々のフィールドに変換します。これは、フィールドを個別にスタイル変更および設定できるため便利です。また、動的フィールド設定のソースとして追加のフィールドを使用したり、フィールドラベルにマッピングしたりすることもできます。その後、追加のラベルを使用して、結果フィールドにより適切な表示名を定義できます。

この変換には、設定クエリによって返されるデータ内のすべてのフィールドを一覧表示するフィールドテーブルが含まれます。このテーブルでは、各設定プロパティにマッピングするフィールドを制御できます ([用途] オプション)。返されるデータに複数の行がある場合、選択する値を選ぶこともできます。

この変換には以下が必要です。

以下にデータを視覚化する場合に役立ちます。

追加フィールドをラベルにマッピング

フィールドが設定プロパティにマッピングされない場合、Grafana は出力フィールドのラベルのソースとして自動的に使用します。

例

出力

フィールド表示名で追加のラベルを使用して、より完全なフィールド名を提供できるようになりました。

あるクエリから設定を抽出して別のクエリに適用する場合は、[クエリ結果から設定] 変換を使用する必要があります。

例

入力

出力

ソースデータ内の各行が個別のフィールドになります。各フィールドには、最大設定オプションも設定されるようになりました。[最小値]、[最大値]、[単位]、[しきい値] などのオプションはすべてフィールド設定の一部であり、このような設定を行うと、パネルエディタのオプションペインで手動設定されるオプションではなく、視覚化によって使用されます。

この変換により、行を個々のフィールドに変換し、動的なフィールド設定を容易にし、追加のフィールドをラベルにマッピングできます。

シリーズから行

この変換を使用して、複数の時系列データクエリの結果を 1 つの結果にまとめます。これはテーブルパネルの視覚化を使用する場合に役立ちます。

この変換の結果には、時間、メトリクス、値の 3 つの列が含まれます。メトリクス列が追加されると、メトリクスのソースとなるクエリを簡単に確認できます。ソースクエリのラベルを定義して、この値をカスタマイズします。

次の例では、時系列データを返すクエリが 2 つあります。変換を適用する前に、2 つの個別のテーブルとして視覚化されます。

クエリ A

クエリ B

シリーズから行 変換を適用した後の結果は次のとおりです。

この変換により、複数の時系列クエリの結果の統合が容易になり、効率的な分析と視覚化のための合理化された統合データセットが表形式で提供されます。

並べ替え

この変換を使用して、指定されたフィールドに基づいてクエリ結果内の各フレームをソートし、データを理解し分析しやすくします。ソートに必要なフィールドを設定することで、テーブルまたは視覚化にデータが表示される順序を制御できます。

[Reverse] (リバース) スイッチを使用して、指定されたフィールド内の値を逆に順序付けします。この機能は、分析ニーズに合わせて昇順と降順をすばやく切り替える場合に特に便利です。

例えば、時系列データがデータソースから取得されるシナリオでは、[並べ替え]変換を適用することで、分析要件に応じてタイムスタンプに基づいてデータフレームを昇順または降順に配置できます。この機能を使用すると、時系列データを簡単にナビゲートして解釈でき、整理された視覚的に一貫性のあるプレゼンテーションから貴重なインサイトを得られます。

Spatial (空間)

この変換を使用して、空間オペレーションをクエリ結果に適用します。

この変換により、地理空間データを操作および分析し、ポイント間の線の作成、空間プロパティの計算などの操作が可能になります。

時系列のテーブル変換

この変換を使用して時系列結果をテーブルに変換し、時系列データフレームを[トレンド]フィールドに変換します。[トレンド]フィールドは、[スパークラインセルタイプ]を使用してレンダリングでき、テーブル行ごとにインラインスパークラインを生成します。複数の時系列クエリがある場合、それぞれが個別のテーブルデータフレームになります。これらは結合またはマージ変換を使用して結合し、行ごとに複数のスパークラインを持つ単一のテーブルを生成できます。

生成された[トレンド]フィールド値ごとに、計算関数を選択できます。デフォルトは [最後の null 以外の値]です。この値はスパークラインの隣に表示され、テーブル行のソートに使用されます。

Regression analysis (回帰分析)

この変換を使用して、統計モデルによって予測された値を含む新しいデータフレームを作成します。これは、混沌としたデータの傾向を見つけるのに役立ちます。線形回帰または多項式回帰を使用して、データに数学関数を適合させることによって機能します。その後、データフレームを視覚化で使用してトレンドラインを表示できます。

これには、次のように 2 つの異なるモデルがあります。