翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
変換
このドキュメントトピックは、Grafana バージョン 8.x をサポートする Grafana ワークスペース向けに設計されています。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 での作業。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業。
変換は、結果セットが視覚化に渡される前に処理します。Amazon Managed Grafana パネルエディタの変換タブで変換にアクセスします。
変換を使用して、フィールドの名前変更、別々の時系列の結合、クエリ間での数学などを行うことができます。大きなダッシュボードや重いクエリがある場合、あるパネルから別のパネルにクエリ結果を再利用できれば、パフォーマンスが大幅に向上する可能性があります。
注記
変換によって、グラフ化できないデータが発生することがあります。この場合、Amazon Managed Grafana はビジュアライゼーションに提案を表示します。テーブルの視覚化に切り替える提案を選択します。これは、多くの場合、変換がデータに対して何をしているのかをよりよく理解するのに役立ちます。
Amazon Managed Grafana は、画面に表示される順序で変換を適用します。すべての変換は、パイプライン内の次の変換に渡される新しい結果セットを作成します。
この順序は、結果の外観に大きな違いをもたらす可能性があります。例えば、変換を減らすを使用して 1 つの列のすべての結果を 1 つの値に要約する場合、変換はその 1 つの値にのみ適用できます。
前提条件
変換を適用する前に、以下のすべてが満たされている必要があります。
-
クエリを入力し、データソースからデータを返しました。クエリの詳細については、「クエリ」を参照してください。
-
次のいずれかの視覚化など、クエリをサポートする視覚化を適用しました。
-
バーゲージ
-
Gauge
-
グラフ
-
ヒートマップ
-
ログ
-
Stat
-
テーブル
-
変換の適用
変換は、パネルエディタの下部ペインの クエリ タブの横にある 変換 タブから使用できます。
変換を適用するには
-
変換を追加するパネルで、パネルタイトルを選択し、編集 を選択します。
-
[Transform] (変換) タブを選択します。
-
変換を選択します。
表示される変換行で、変換オプションを設定できます。
-
別の変換を適用するには、「変換を追加」を選択します。次の変換は、前の変換によって返された結果セットに作用することに注意してください。
問題が発生した場合は、バグアイコンを選択して変換をデバッグします。
変換を削除するには、ごみ箱アイコンを選択します。
変換タイプとオプション
Grafana ワークスペースには、次の変換が含まれます。
トピック
削減
結果を 1 つの値に簡素化する場合は、Reduce 変換を適用します。減らすと、基本的に時間コンポーネントが削除されます。テーブルとして視覚化すると、列が 1 行 (値) に減少します。
計算フィールドに、1 つ以上の計算タイプを入力します。選択すると、計算の選択肢のリストが表示されます。使用可能な計算については、「」を参照してください計算リスト。
少なくとも 1 つの計算を選択すると、Amazon Managed Grafana は選択した計算を使用して 1 つの値を表示します。複数の計算を選択すると、複数の値が表示されます。
マージ
この変換を使用して、複数のクエリの結果を 1 つの結果にまとめます。これは、テーブルパネルの視覚化を使用する場合に役立ちます。マージできる値は、同じ行に結合されます。共有フィールドに同じデータが含まれている場合は、値をマージできます。
次の例では、2 つのクエリがテーブルデータを返します。データは、変換を適用する前に 2 つの別々のテーブルとして視覚化されます。
クエリ A
時間 | ジョブ | 稼働時間 |
---|---|---|
2020-07-07 11:34:20 | node | 25260122 |
2020-07-07 11:24:20 | postgre | 123001233 |
クエリ B
時間 | ジョブ | エラー |
---|---|---|
2020-07-07 11:34:20 | node | 15 |
2020-07-07 11:24:20 | postgre | 5 |
マージ変換を適用した後の結果は次のとおりです。
時間 | ジョブ | エラー | 稼働時間 |
---|---|---|---|
2020-07-07 11:34:20 | node | 15 | 25260122 |
2020-07-07 11:24:20 | postgre | 5 | 123001233 |
名前に基づいてフィルタリングする
この変換を使用して、クエリ結果の一部を削除します。
Amazon Managed Grafana は識別子フィールドを表示し、その後にクエリによって返されるフィールドが表示されます。
フィルターは、次の 2 つの方法のいずれかで適用できます。
-
正規表現式を入力します。
-
フィールドを選択して、そのフィールドのフィルタリングを切り替えます。フィルタリングされたフィールドは濃い灰色のテキストで表示され、フィルタリングされていないフィールドには白いテキストが表示されます。
クエリによるデータのフィルタリング
1 つ以上のクエリを非表示にする場合は、複数のクエリがあるパネルでこの変換を使用します。
Amazon Managed Grafana は、クエリ識別文字をダークグレーテキストで表示します。フィルタリングを切り替えるには、クエリ識別子を選択します。クエリ文字が白の場合、結果が表示されます。クエリ文字が暗い場合、結果は非表示になります。
フィールドを整理する
この変換を使用して、クエリによって返されるフィールドの名前を変更、並べ替え、または非表示にします。
注記
この変換は、単一のクエリを持つパネルでのみ機能します。パネルに複数のクエリがある場合は、フィールドで結合 (外部結合) 変換を適用するか、追加のクエリを削除する必要があります。
Amazon Managed Grafana は、クエリによって返されるフィールドのリストを表示します。次のいずれかの変更を行うことができます。
-
フィールドを一時停止してフィールドの順序を変更します。カーソルが手になり、フィールドを新しい場所にドラッグできます。
-
フィールド名の横にある目のアイコンを選択して、フィールドを非表示または表示します。
-
名前変更ボックスに新しい名前を入力して、フィールドの名前を変更します。
フィールドで結合 (外部結合)
この変換を使用して、フィールドで設定された結果から複数の時系列を結合します。
この変換は、フィールドから結果を計算できるようにクエリを組み合わせる場合に便利です。
計算からフィールドを追加する
この変換を使用して、他の 2 つのフィールドから計算された新しいフィールドを追加します。各変換では、1 つの新しいフィールドを追加できます。
-
Mode – モードを選択します。
-
行を減らす – 選択したフィールドの各行に、選択した計算を個別に適用します。
-
バイナリオプション - 選択した 2 つのフィールドから 1
sum
行の値に基本的な数学演算 (multiply
、 など) を適用します。
-
-
フィールド名 – 新しいフィールドの計算に使用するフィールドの名前を選択します。
-
計算 - Amazon Managed Grafana が新しいフィールドを作成するときに使用する計算を選択します。フィールドを選択すると、計算の選択肢のリストが表示されます。使用可能な計算の詳細については、「」を参照してください計算リスト。
-
エイリアス – (オプション) 新しいフィールドの名前を入力します。これを空白のままにすると、 フィールドには計算に一致する名前が付けられます。
-
すべてのフィールドを置き換える – (オプション) 他のすべてのフィールドを非表示にし、計算フィールドのみを視覚化に表示する場合は、このオプションを使用します。
フィールドへのラベル付け
注記
この変換を適用するには、クエリがラベル付きフィールドを返す必要があります。
この変換を選択すると、Amazon Managed Grafana はラベル付きデータをすべてフィールドに自動的に変換します。
例えば、2 つの時系列のクエリ結果があるとします。
1: labels Server=Server A、Datacenter=EU 2: labels Server=Server B、Datacenter=EU
この変換により、次の表が表示されます。
時間 | [サーバー] | Datacenter | 値 |
---|---|---|---|
2020-07-07 11:34:20 | サーバー A | EU | 1 |
2020-07-07 11:34:20 | サーバー B | EU | 2 |
値フィールド名 。値フィールド名 Server
として を選択した場合、Server
ラベルの値ごとに 1 つのフィールドを取得します。
時間 | Datacenter | サーバー A | サーバー B |
---|---|---|---|
2020-07-07 11:34:20 | EU | 1 | 2 |
グループ化の基準
この変換は、設定されたフィールドで各フレームをソートします。reverse
をチェックすると、値は逆の順序で返されます。
グループ化の基準
この変換は、指定されたフィールド (列) 値でデータをグループ化し、各グループの計算を処理します。使用可能な計算は、Reduce 変換の場合と同じです。
元のデータの例を次に示します。
時間 | Server ID | CPU 温度 | サーバーステータス |
---|---|---|---|
2020-07-07 11:34:20 | サーバー 1 | 80 | シャットダウン |
2020-07-07 11:34:20 | サーバー 3 | 62 | OK |
2020-07-07 10:32:20 | サーバー 2 | 90 | オーバーロード |
2020-07-07 10:31:22 | サーバー 3 | 55 | OK |
2020-07-07 09:30:57 | サーバー 3 | 62 | 再起動 |
2020-07-07 09:30:05 | サーバー 2 | 88 | OK |
2020-07-07 09:28:06 | サーバー 1 | 80 | OK |
2020-07-07 09:25:05 | サーバー 2 | 88 | OK |
2020-07-07 09:23:07 | サーバー 1 | 86 | OK |
この変換には 2 つのステップがあります。まず、データをグループ化する 1 つ以上のフィールドを指定します。これにより、ソートした場合と同じフィールドの値がすべてグループ化されます。例えば、 Server ID
フィールドでグループ化すると、次のようにデータがグループ化されます。
時間 | Server ID | CPU 温度 | サーバーステータス |
---|---|---|---|
2020-07-07 11:34:20 | サーバー 1 | 80 | シャットダウン |
2020-07-07 09:28:06 | サーバー 1 | 80 | OK |
2020-07-07 09:23:07 | サーバー 1 | 86 | OK |
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
フィールドに適用された平均計算を追加して、以下を取得できます。
Server ID | CPU 温度 (平均) |
---|---|
サーバー 1 | 82 |
サーバー 2 | 88.6 |
サーバー 3 | 59.6 |
また、これらの計算を複数追加できます。例えば、次の計算を使用できます。
-
フィールド では
Time
、Last 値を計算して、サーバーごとに最後のデータポイントがいつ受信されたかを確認できます。 -
フィールド では
Server Status
、各サーバーの最後の状態値を知るために、Last 値を計算できます。 -
フィールド では
Temperature
、Last 値を計算して、各サーバーの最新のモニタリング温度を確認することもできます。
Group By 変換では、次の結果が生成されます。
Server ID | CPU 温度 (平均) | CPU 温度 (最新) | 時間 (最終) | サーバーステータス (最新) |
---|---|---|---|---|
サーバー 1 | 82 | 80 | 2020-07-07 11:34:20 | シャットダウン |
サーバー 2 | 88.6 | 90 | 2020-07-07 10:32:20 | オーバーロード |
サーバー 3 | 59.6 | 62 | 2020-07-07 11:34:20 | OK |
この変換を使用すると、時系列からいくつかのキー情報を抽出し、便利な方法で表示できます。
シリーズから行へ
この変換を使用して、複数の時系列データクエリの結果を 1 つの結果にまとめます。これは、テーブルパネルの視覚化を使用する場合に役立ちます。
この変換の結果には、、Time
、 Metric
の 3 つの列が含まれますValue
。Metric
列が追加され、メトリクスのソースとなるクエリを確認できます。ソースクエリLabel
で を定義して、この値をカスタマイズします。
以下の例では、2 つのクエリが時系列データを返します。変換が適用される前に、2 つの個別のテーブルとして視覚化されます。
クエリ A
時間 | 温度 |
---|---|
2020-07-07 11:34:20 | 25 |
2020-07-07 10:31:22 | 22 |
2020-07-07 09:30:05 | 19 |
クエリ B
時間 | 湿度 |
---|---|
2020-07-07 11:34:20 | 24 |
2020-07-07 10:32:20 | 29 |
2020-07-07 09:30:57 | 33 |
Series to rows
変換を適用すると、次の結果が得られます。
時間 | メトリクス | 値 |
---|---|---|
2020-07-07 11:34:20 | 温度 | 25 |
2020-07-07 11:34:20 | 湿度 | 22 |
2020-07-07 10:32:20 | 湿度 | 29 |
2020-07-07 10:31:22 | 温度 | 22 |
2020-07-07 09:30:57 | 湿度 | 33 |
2020-07-07 09:30:05 | 温度 | 19 |
値でデータをフィルタリングする
この変換により、Grafana ワークスペースでデータを直接フィルタリングし、クエリ結果から一部のデータポイントを削除できます。定義した 1 つ以上の条件に一致するデータを含めるか除外するかを選択できます。条件は、選択したフィールドに適用されます。
この変換は、データソースが値でネイティブにフィルタリングしない場合に役立ちます。共有クエリを使用している場合は、これを使用して値を絞り込んで表示することもできます。
すべてのフィールドで使用できる条件は次のとおりです。
-
正規表現 - 正規表現式を一致させます。
-
Is Null – 値が null の場合に一致。
-
Is Not Null – 値が null でない場合は一致します。
-
Equal – 値が指定された値と等しい場合に一致します。
-
Different – 値が指定された値と異なる場合に一致します。
数値フィールドで使用可能な条件は次のとおりです。
-
Greater – 値が指定された値より大きい場合に一致します。
-
下限 — 値が指定された値よりも小さい場合に一致します。
-
Greater or equal – 値が指定された値以上の場合に一致します。
-
lower or equal – 値が指定された値以下の場合に一致します。
-
範囲 — 指定された最小値と最大値の間の範囲に一致します。最小と最大が範囲に含まれます。
フィルターには複数の条件を追加できます。複数の条件がある場合は、追加した条件のすべてまたはいずれかに一致する行にインクルードアクションまたは除外アクションを適用するかどうかを選択できます。
有効でない、または設定が不完全である条件は無視されます。
デバッグ変換
変換の入力セットと出力結果セットを表示するには、変換行の右側にあるバグアイコンを選択します。
Amazon Managed Grafana は、変換行の下に変換デバッグビューを表示します。