フィールドオプションとオーバーライド
このドキュメントのトピックは、Grafana バージョン 8.x をサポートする Grafana ワークスペース向けです。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 10 での作業」を参照してください。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 9 での作業」を参照してください。
このセクションでは、Amazon Managed Grafana のフィールドオプションおよびフィールドオーバーライドとは何か、およびそれらの使用方法について説明します。
Grafana ワークスペースで使用されるデータモデルであるデータフレームは、時系列とテーブルのクエリ結果の両方が統合された列指向のテーブル構造です。この構造内の各列は、フィールドと呼ばれます。フィールドは、単一の時系列またはテーブル列を表すことができます。
フィールドオプションを使用すると、視覚的表現でのデータの表示方法を変更できます。オプションとオーバーライドを適用してもデータは変更されません。Amazon Managed Grafana でのデータの表示方法が変更されます。
フィールドオプション
パネルエディタの [フィールド] タブには、標準とカスタムの両方のフィールドオプションがあります。このタブで行われた変更は、すべてのフィールド (シリーズと列) に適用されます。例えば、単位をパーセンテージに変更すると、すべての数値フィールドがパーセンテージで表示されます。フィールドオプションを適用する方法については、「すべてのフィールドを設定する」で説明します。
フィールドのオーバーライド
フィールドのオーバーライドは、パネルエディタの [オーバーライド] タブに追加できます。このタブには [フィールド] タブと同じオプションを追加できますが、特定のフィールドのみの適用となります。オーバーライドを適用する方法については、「特定のフィールドを設定する」で説明します。
使用可能なフィールドオプションとオーバーライド
フィールドオプションの種類は、フィールドオプションとフィールドオーバーライドの両方に共通しています。唯一の違いは変更の適用先で、すべてのフィールド ([フィールド] タブに適用) かフィールドのサブセット ([オーバーライド] タブに適用) かが異なります。
-
標準フィールドオプション は、変換を許可するすべてのパネルの視覚的表現に適用されます。
-
テーブルのフィールドオプション は、テーブルパネルの視覚的表現にのみ適用されます。
すべてのフィールドを設定する
[フィールド] タブでオプションを変更すると、すべてのフィールドのデータの表示方法を変更することができます。[オーバーライド] タブからは、特定のフィールドのフィールドオプションをオーバーライドすることができます。詳細については、「特定のフィールドを設定する」を参照してください。
例えば、小数オプションを変更すると、すべてのフィールドに表示される小数点以下の桁数が変更されます。オプションの詳細については、「標準フィールドオプション」および「テーブルのフィールドオプション」を参照してください。
フィールドオプションを変更する
オプションはいくつでも変更できます。
フィールドオプションの変更方法
-
編集するパネル、パネルタイトル、[編集] の順に選択します。
-
[フィールド] タブを選択します。
-
変更するオプションを見つけます。以下を定義できます。
-
標準フィールドオプション (変換を許可するすべてのパネル視覚的表現に適用されます)
-
テーブルのフィールドオプション (テーブルパネルの視覚的表現にのみ適用されます)
-
-
フィールドに値を記入してオプションを追加します。オプションをデフォルト値に戻すには、フィールドの白い文字を削除します。
-
ダッシュボードの編集が完了したら、[保存] を選択します。
フィールドオプションの例
結果セットが、「時間」と「温度」の 2 つのフィールドで構成されるデータフレームである場合を例にします。
時系 | temperature |
---|---|
2020-01-02 03:04:00 | 45.0 |
2020-01-02 03:05:00 | 47.0 |
2020-01-02 03:06:00 | 48.0 |
この構造の各フィールド (列) にフィールドオプションを適用してその値の表示方法を変えることができます。例えば、単位を温度 > 摂氏に設定すると、次の表になります。
時系 | temperature |
---|---|
2020-01-02 03:04:00 | 45.0 °C |
2020-01-02 03:05:00 | 47.0 °C |
2020-01-02 03:06:00 | 48.0 °C |
この例では、小数点に値が無いため不要になります。小数を auto
からゼロ (0
) に変更すると、次の表になります。
時系 | temperature |
---|---|
2020-01-02 03:04:00 | 45 °C |
2020-01-02 03:05:00 | 47 °C |
2020-01-02 03:06:00 | 48 °C |
特定のフィールドを設定する
オーバーライドを使用して、1 つ以上のフィールドの設定を変更することができます。オーバーライドのフィールドオプションは、特定の視覚的表現で使用可能なフィールドオプションとまったく同じです。唯一の違いは、適用するフィールドを選択する点です。
例えば、すべての数値フィールドまたは列に表示される小数点以下の桁数を変更するには、型が数値のフィールドの小数点オプションを変更します。オプションの詳細については、変換を許可するすべてのパネル視覚的表現に適用される「標準フィールドオプション 」およびテーブルパネルの視覚的表現のみに適用される「テーブルのフィールドオプション」を参照してください。
フィールドオーバーライドを追加する
フィールドオプションは、いくつでも上書きできます。
フィールドオーバーライドの追加方法
-
編集するパネル、パネルタイトル、[編集] の順に選択します。
-
[オーバーライド] タブを選択します。
-
[オーバーライドの追加先] を選択します。
-
オーバーライドルールを適用するフィールドを選択します。
-
[名前付きフィールド] – 使用可能なすべてのフィールドの一覧からフィールドを選択します。このセレクタでルールに追加するプロパティは、この単一フィールドにのみ適用されます。
-
[正規表現と一致する名前付きフィールド] – 正規表現でオーバーライドするフィールドを指定します。このセレクタでルールに追加するプロパティは、フィールド名が正規表現と一致するすべてのフィールドに適用されます。
-
[タイプ別フィールド] – 文字列、数値などのフィールドをタイプ別に選択します。このセレクタでルールに追加するプロパティは、選択した型のすべてのフィールドに適用されます。
-
-
[オーバーライドプロパティの追加] を選択します。
-
適用するフィールドオプションを選択します。
-
フィールドに値を追加してオプションを入力します。オプションをデフォルト値に戻すには、フィールドの白い文字を削除します。
-
[オーバーライドプロパティの追加] を選択して、このフィールドにオーバーライドを追加し続けるか、[オーバーライドの追加] を選択し、オーバーライドを追加する別のフィールドを選択できます。
-
完了したら、[保存] を選択します。
フィールドオーバーライドの削除
-
削除するオーバーライドがある [オーバーライド] タブを選択します。
-
オーバーライドの横にあるごみ箱アイコンを選択します。
フィールドオーバーライドの例
結果セットが、「時間」、「高温」、「低温」、「湿度」の 4 つのフィールドで構成されるデータフレームである場合を例にします。
時系 | 高温 | 低温 | 湿度 |
---|---|---|---|
2020-01-02 03:04:00 | 45.0 | 30.0 | 67 |
2020-01-02 03:05:00 | 47.0 | 34.0 | 68 |
2020-01-02 03:06:00 | 48.0 | 31.0 | 68 |
フィールドオプションの例 と同様に、摂氏単位を適用して小数点以下を削除します。表は次のようになります。
時系 | 高温 | 低温 | 湿度 |
---|---|---|---|
2020-01-02 03:04:00 | 45 °C | 30 °C | 67 °C |
2020-01-02 03:05:00 | 47 °C | 34 °C | 68 °C |
2020-01-02 03:06:00 | 48 °C | 31 °C | 68 °C |
温度フィールドは適切ですが、湿度フィールドが適切ではありません。これを修正するには、湿度フィールドにフィールドオプションオーバーライドを適用し、単位を [Misc] (その他) > % (0~100) に変更します。これにより、表が適切になりました。
時系 | 高温 | 低温 | 湿度 |
---|---|---|---|
2020-01-02 03:04:00 | 45 °C | 30 °C | 67% |
2020-01-02 03:05:00 | 47 °C | 34 °C | 68% |
2020-01-02 03:06:00 | 48 °C | 31 °C | 68% |
標準フィールドオプション
このセクションでは、使用可能なフィールドオプションについて説明します。アルファベット順に紹介します。
標準フィールドオプションは、ほとんどのビルトインの Grafana ワークスペースパネルに適用できます。新しいパネルとデータモデルに更新されていない古いパネルとコミュニティパネルの一部には、これらのフィールドオプションのすべてまたは一部が欠落します。
ほとんどのフィールドオプションは、編集するフィールドオプションボックスの外部を選択するか、Enter キーを押すまで、視覚的表現には影響しません。
これらのオプションの適用の詳細については、以下のセクションを参照してください。
小数
表示する値の小数点以下の桁数を設定します。Amazon Managed Grafana がデータソースによって提供される小数点以下の桁数をそのまま使用する場合、空白のままにします。
この設定を変更するには、 フィールドに数値を入力します。
データリンク
値または視覚的表現がリンクする URL を制御します。詳細と手順については、「データリンク」を参照してください。
Display name (表示名)
すべてのフィールドの表示タイトルを設定します。フィールドタイトルには変数を使用できます。テンプレート作成とテンプレート変数の詳細については、「テンプレートおよび変数」を参照してください。
複数の統計、フィールド、または系列が表示される場合、このフィールドは各統計のタイトルを制御します。式 (例: ${__field.name}
) を使用して、タイトルに系列名またはフィールド名のみを表示させることができます。
「Temp」という名前のフィールドがあり、ラベルが {"Loc"="PBI", "Sensor"="3"} である場合
式の構文 | 例 | レンダリング先 | 説明 |
---|---|---|---|
${__field.displayName}
|
構文と同じ |
Temp {Loc="PBI",
Sensor="3"}
|
フィールド名とラベルがある場合、{} 内が表示されます。レスポンスにラベルキーが 1 つしかない場合、ラベル部分において、Amazon Managed Grafana は括弧なしでラベルの値を表示します。 |
${__field.name}
|
構文と同じ |
Temp
|
フィールドの名前を表示します (ラベルなし)。 |
${__field.labels}
|
構文と同じ |
Loc="PBI", Sensor="3"
|
ラベルを表示します (名前なし)。 |
${__field.labels.X}
|
${__field.labels.Loc}
|
PBI
|
指定されたラベルキーの値を表示します。 |
${__field.labels.__values}
|
構文と同じ |
PBI, 3
|
ラベルの値をカンマ区切りで表示します (ラベルキーなし)。 |
特定のフィールドに対する式をレンダリングした後に値が空の文字列である場合、デフォルトの表示方法が使用されます。
最大
パーセンテージしきい値の計算に使用される最大値を設定します。すべての系列とフィールドに基づいて自動計算を行うには、この設定を空白のままにします。
最小
パーセンテージしきい値の計算に使用される最小値を設定します。すべての系列とフィールドに基づいて自動計算を行うには、この設定を空白のままにします。
値なし
フィールド値が空または null の場合に Amazon Managed Grafana が表示する値を入力します。
単位
フィールドで使用される単位を指定します。[単位]フィールドを選択し、目的の単位が見つかるまでドリルダウンします。選択した単位は、時間を除くすべてのフィールドに適用されます。
ユーザー定義の単位
単位ドロップダウンを使用して、ユーザー定義の単位、接頭辞や接尾辞、日付時刻形式を指定することもできます。
ユーザー定義の単位を選択するには、単位を入力し、ドロップダウンで最後の [Custom: xxx
] オプションを選択します。
-
suffix:<suffix>
: ユーザー定義の単位を値の後に表示。 -
time:<format>
: ユーザー定義の日付/時刻形式。例:time:YYYY-MM-DD
。形式の構文とオプションについては、「表示」を参照してください。 -
si:<base scale><unit characters>
: ユーザー定義の SI 単位。例:si: mF
。単位とソースデータスケールの両方を指定できるため、少し高度です。例えば、ソースデータがミリ (千分の一) 単位で表されている場合、単位の先頭にその SI スケール文字が付けられます。 -
count:<unit>
: ユーザー定義のカウント単位。 -
currency:<unit>
: ユーザー定義の通貨単位。
単位ピッカーにネイティブ絵文字を貼り付けて、ユーザー定義単位として選択することもできます。
[String units] (文字列の単位)
Amazon Managed Grafana は、文字列を解析して数値として表示することがあります。Amazon Managed Grafana に元の文字列を表示させるには、フィールドオーバーライドを作成し、string
単位の単位プロパティを追加します。
カラースキーム
フィールドの色オプションは、Amazon Managed Grafana が系列またはフィールドを色分けする方法を定義します。それぞれ動作が異なる複数のモードがあり、その有用性は、現在選択されている視覚的表現に大きく依存します。
連続色モードでは、最小値と最大値から割合を算出して色を補間します。
-
単一色 – カラーピッカーを使用して特定の色を設定します。これは、オーバーライドルールで最も便利です。
-
閾値から – 閾値から色を派生させます。これは、ゲージ、統計、テーブルの視覚的表現で使用できます。
系列別の色設定
Amazon Managed Grafana には、系列ごとに色を定義する配色機能があります。これは、グラフや円グラフなどで使用できます。
値別の色設定
Amazon Managed Grafana には、連続 (グラデーション) のカラースキーム機能もあります。これは、統計パネルやテーブルパネルなど、個々の値を色分けする視覚的表現で使用できます。
しきい値
しきい値を設定することで、値を基にフィールドの色を変更することができます。詳細と手順については、「しきい値」を参照してください。
値の配置
フィールド値または値の範囲を明示的なテキストに変換するルールを設定できます。複数の値を配置できます。
-
[配置タイプ]でオプションを選択します。
-
[値] に値を入力します。フィールド値が指定した値以上の場合、テキストが表示されます。
-
[開始]] と [終了] に範囲を入力します。フィールド値が範囲内である場合、テキストが表示されます。
-
-
[テキスト] は、フィールドで条件が満たされた場合に表示されるテキストです。このフィールドには変数を使用できます。