変換

変換は視覚化に渡される前に一連の結果を処理します。Amazon Managed Grafana パネルエディタの [変換] タブで変換にアクセスします。

変換を使用して、フィールドの名前変更、個別の時系列の結合、クエリ間の計算などを実行できます。大きなダッシュボードや大量のクエリがある場合、あるパネルのクエリ結果を別のパネルで再利用できれば、パフォーマンスが大幅に向上する可能性があります。

Amazon Managed Grafana は画面に一覧される順序で変換を適用します。各変換ではパイプライン内の次の変換に渡される新しい結果セットが作成されます。

この順序により結果が大きく異なる場合があります。例えば、縮小変換を使用して 1 つの列のすべての結果を 1 つの値に集約する場合、変換はその 1 つの値にのみ適用できます。

前提条件

変換を適用する前に、次のすべてが実行済みである必要があります。

変換の適用

変換は、パネルエディタの下部ペインの、[クエリ] タブの隣の [変換] タブから使用できます。

問題が発生した場合は、バグアイコンを選択して [変換をデバッグ] します。

変換を削除する場合、ごみ箱アイコンを選択します。

変換タイプおよびオプション

Grafana ワークスペースには次の変換が含まれます。

削減

結果を 1 つの値に簡略化する場合は、[削減] 変換を適用します。削減では基本的に時間コンポーネントを削除します。テーブルとして視覚化する場合は、列が 1 行 (値) に減少します。

[計算] フィールドに、1 つ以上の計算タイプを入力します。計算選択肢のリストの表示を選択します。利用可能な計算の詳細については、「計算リスト」を参照してください。

少なくとも 1 つの計算を選択すると、Amazon Managed Grafana では選択した計算を使用して 1 つの値が表示されます。複数の計算を選択すると、複数の値が表示されます。

マージ

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

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

クエリ A

クエリ B

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

名前に基づいてフィルタリングする

この変換を使用してクエリ結果の一部を削除します。

Amazon Managed Grafana には [識別子] フィールドが表示され、クエリが返すフィールドが続きます。

フィルターは次の 2 つのいずれかの方法で適用できます。

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

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

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

フィールドの整理

この変換を使用して、クエリが返すフィールドの名前を変更、並べ替え、非表示にします。

Amazon Managed Grafana ではクエリが返すフィールドのリストが表示されます。以下の任意の変更を行うことができます。

フィールドにより結合 (外部結合)

この変換を使用してフィールドで設定された結果から複数の時系列を結合します。

この変換は、フィールドからの結果を計算できるようにするため、クエリを組み合わせる場合に役立ちます。

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

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

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

この変換を選択すると、Amazon Managed Grafana により、ラベル付けされたすべてのデータがフィールドに自動的に変換されます。

例えば、2 つの時系列のクエリ結果を考慮しましょう。

1: labels Server=Server A, Datacenter=EU 2: labels Server=Server B, Datacenter=EU

この変換により次の表が表示されます。

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

グループ化の条件

この変換は設定されたフィールドで各フレームをソートします。reverse がチェックされているとき、値は逆の順序で返されます。

グループ化の条件

この変換では、指定されたフィールド (列) 値でデータをグループ化し、各グループの計算を処理します。使用可能な計算は削減変換の場合と同じです。

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

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

2020-07-07 10:32:20 | server 2 | 90 | Overload
2020-07-07 09:30:05 | server 2 | 88 | OK
2020-07-07 09:25:05 | server 2 | 88 | OK

2020-07-07 11:34:20 | server 3 | 62 | OK
2020-07-07 10:31:22 | server 3 | 55 | OK
2020-07-07 09:30:57 | server 3 | 62 | Rebooting

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

データをグループ化するフィールドを選択すると、他のフィールドにさまざまな計算を追加でき、その計算は行の各グループに適用されます。例えば、これらの各サーバーの平均 CPU temperature の計算について考えましょう。CPU Temperature フィールドに適用される平均計算を追加して、以下を取得できます。

これらの計算を複数追加できます。例えば、次の計算を使用できます。

グループ化の条件変換では次の結果が生成されます。

この変換を使用すると、時系列から一部のキー情報を抽出して便利な方法で表示できます。

シリーズから行

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

この変換の結果には、Time、Metric、Value の 3 つの列が含まれます。Metric 列が追加されると、メトリクスの元となったクエリを確認できます。ソースクエリで Label を定義して、この値をカスタマイズします。

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

クエリ A

クエリ B

Series to rows 変換を適用すると次の結果が得られます。

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

この変換により、Grafana ワークスペースでデータを直接フィルタリングして、クエリ結果から一部のデータポイントを削除できます。1 つ以上の定義済み条件と一致するデータを含めるか除外するかを選択できます。その条件は選択したフィールドに適用されます。

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

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

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

複数の条件をフィルターに追加できます。複数の条件がある場合、追加した条件のすべてまたはいずれかと一致する行に、含めたり除外したりするためのアクションを適用するかどうかを選択できます。

有効でない条件、または設定が不完全である条件は無視されます。

変換のデバッグ

変換の入力および出力結果のセットを表示するには、変換行の右側にあるバグアイコンを選択します。

Amazon Managed Grafana の変換行の下に変換デバッグビューが表示されます。