翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
フィールドオプションとオーバーライド
このドキュメントトピックは、Grafana バージョン 8.x をサポートする Grafana ワークスペース向けに設計されています。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 での作業。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業。
このセクションでは、Amazon Managed Grafana のフィールドオプションとフィールドオーバーライドとは何か、およびそれらを使用する方法について説明します。
Grafana ワークスペースで使用されるデータモデルであるデータフレームは、時系列とテーブルの両方のクエリ結果を統合する列指向のテーブル構造です。この構造内の各列はフィールド と呼ばれます。フィールドは、単一の時系列またはテーブル列を表すことができます。
フィールドオプションを使用すると、視覚化でのデータの表示方法を変更できます。適用するオプションとオーバーライドは、データを変更せず、Amazon Managed Grafana によるデータの表示方法を変更します。
フィールドオプション
標準とカスタムの両方のフィールドオプション は、パネルエディタのフィールドタブにあります。このタブで行われた変更は、すべてのフィールド (シリーズと列) に適用されます。例えば、単位をパーセンテージに変更すると、数値を持つすべてのフィールドがパーセンテージで表示されます。でフィールドオプションを適用する方法について説明しますすべてのフィールドを設定する。
フィールドオーバーライド
フィールドオーバーライドは、パネルエディタのオーバーライドタブに追加できます。フィールドタブと同じオプションを追加できますが、特定のフィールドにのみ適用されます。でオーバーライドを適用する方法について説明します特定のフィールドを設定する。
使用可能なフィールドオプションとオーバーライド
フィールドオプションタイプは、フィールドオプションとフィールドオーバーライドの両方に共通です。唯一の違いは、変更がすべてのフィールド (フィールドタブに適用) に適用されるか、フィールドのサブセット (オーバーライドタブに適用) に適用されるかです。
-
標準フィールドオプション は、変換を許可するすべてのパネル視覚化に適用されます。
-
テーブルフィールドオプション はテーブルパネルの視覚化にのみ適用されます。
すべてのフィールドを設定する
すべてのフィールドのデータの表示方法を変更するには、フィールドタブのオプションを変更できます。オーバーライドタブで、特定のフィールドのフィールドオプションをオーバーライドできます。詳細については、「特定のフィールドを設定する」を参照してください。
例えば、小数オプションを変更することで、すべてのフィールドに表示される小数点以下の桁数を変更できます。オプションの詳細については、標準フィールドオプション「」および「」を参照してくださいテーブルフィールドオプション。
フィールドオプションを変更する
オプションはいくつでも変更できます。
フィールドオプションを変更するには
-
編集するパネルを選択し、パネルタイトルを選択し、編集を選択します。
-
フィールドタブを選択します。
-
変更するオプションを見つけます。以下を定義できます。
-
標準フィールドオプション。変換を許可するすべてのパネル視覚化に適用されます。
-
テーブルフィールドオプション。テーブルパネルの視覚化にのみ適用されます。
-
-
フィールドに値を追加してオプションを追加します。オプションをデフォルト値に戻すには、フィールド内のホワイトテキストを削除します。
-
ダッシュボードの編集が完了したら、保存 を選択します。
フィールドオプションの例
結果セットが、時間と温度の 2 つのフィールドで構成されるデータフレームであるとしましょう。
| time | 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 |
この構造の各フィールド (列) には、値の表示方法を変更する方法でフィールドオプションを適用できます。例えば、単位を温度 > 摂氏に設定して、次の表を作成できます。
| time | 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 |
この場合、小数点以下は意味しません。10 進数を から 0 (0) auto に変更すると、次の表になります。
| time | 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 つ以上のフィールドの設定を変更できます。オーバーライドのフィールドオプションは、特定の視覚化で使用できるフィールドオプションとまったく同じです。唯一の違いは、適用するフィールドを選択することです。
例えば、数値 に一致する型を持つフィールドの 10 進数オプションを変更することで、すべての数値フィールドまたは列に表示される小数点以下の桁数を変更できます。オプションの詳細については、「変換を許可するすべてのパネル視覚化標準フィールドオプションに適用される」および「テーブルパネルの視覚化のみに適用されるテーブルフィールドオプション」を参照してください。
フィールドオーバーライドを追加する
フィールドオプションは、必要な数だけ上書きできます。
フィールドオーバーライドを追加するには
-
編集するパネルを選択し、パネルタイトルを選択し、編集を選択します。
-
オーバーライドタブを選択します。
-
のオーバーライドを追加 を選択します。
-
オーバーライドルールを適用するフィールドを選択します。
-
名前のフィールド – これを使用して、使用可能なすべてのフィールドのリストからフィールドを選択します。このセレクタを使用してルールに追加するプロパティは、この単一のフィールドにのみ適用されます。
-
正規表現に一致する名前のフィールド – これを使用して、正規表現で上書きするフィールドを指定します。このセレクタを使用してルールに追加するプロパティは、フィールド名が正規表現と一致するすべてのフィールドに適用されます。
-
タイプ のフィールド – 文字列、数値などのフィールドをタイプ別に選択します。このセレクタを使用してルールに追加するプロパティは、選択したタイプに一致するすべてのフィールドに適用されます。
-
-
オーバーライドプロパティを追加 を選択します。
-
適用するフィールドオプションを選択します。
-
フィールドに値を追加してオプションを入力します。オプションをデフォルト値に戻すには、フィールド内のホワイトテキストを削除します。
-
上書きプロパティを追加 を選択して、このフィールドに上書きを追加し続けるか、上書きを追加 を選択して、上書きを追加する別のフィールドを選択できます。
-
完了したら、[Save] (保存) を選択します。
フィールドオーバーライドを削除する
-
削除するオーバーライドを含むオーバーライドタブを選択します。
-
オーバーライドの横にあるごみ箱アイコンを選択します。
フィールドオーバーライドの例
結果セットは、時間、高温度、低温度、湿度の 4 つのフィールドで構成されるデータフレームであるとしましょう。
| time | 高温度 | 低温度 | 湿度 |
|---|---|---|---|
| 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 |
のフィールドオプションを適用フィールドオプションの例して摂氏単位を適用し、小数点以下を削除しましょう。これにより、次の表が表示されます。
| time | 高温度 | 低温度 | 湿度 |
|---|---|---|---|
| 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) に変更します。これにより、より理にかなったテーブルが作成されます。
| time | 高温度 | 低温度 | 湿度 |
|---|---|---|---|
| 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 キーを押すまで、視覚化には影響しません。
これらのオプションの適用の詳細については、以下のセクションを参照してください。
10 進数
このオプションは、値をレンダリングするときに含める小数の数を設定します。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}
|
Syntax と同じ |
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>カスタム通貨単位の 。
単位ピッカーにネイティブ絵文字を貼り付けて、カスタム単位として選択することもできます。
文字列単位
Amazon Managed Grafana は、文字列を解析して数値として表示することがあります。Amazon Managed Grafana に元の文字列を表示させるには、フィールドオーバーライドを作成し、ユニットでstringユニットプロパティを追加します。
カラースキーム
フィールドの色オプションは、Amazon Managed Grafana がシリーズまたはフィールドを色分けする方法を定義します。動作が異なるモードが複数あり、そのユーティリティは、現在選択されている視覚化に大きく依存します。
連続色モードは、最小と最大に対する値の割合を使用して色を補間します。
-
単一色 – カラーピッカーを使用して設定された特定の色。これは、オーバーライドルールから最も役立ちます。
-
しきい値から – 一致するしきい値から派生した色。これは、ゲージ、統計、およびテーブルの視覚化に役立ちます。
シリーズ別の色
Amazon Managed Grafana には、シリーズごとに色を定義するカラースキームが含まれています。これは、グラフや円グラフなどに役立ちます。
値別の色
Amazon Managed Grafana には、連続 (グラデーション) のカラースキームも含まれています。これは、統計パネルやテーブルパネルなど、個々の値を色分けする視覚化に役立ちます。
しきい値
しきい値を使用して、値に基づいてフィールドの色を変更できます。詳細と手順については、「しきい値」を参照してください。
値マッピング
このオプションを使用して、フィールド値または値の範囲を明示的なテキストに変換するルールを設定できます。複数の値マッピングを追加できます。
-
マッピングタイプ — オプションを選択します。
-
値 – 値を入力します。フィールド値が 値以上の場合、テキストが表示されます。
-
開始と終了 – 範囲を入力します。フィールド値が範囲内の値以上である場合は、テキストが表示されます。
-
-
テキスト – フィールドで条件が満たされた場合に表示されるテキスト。このフィールドは変数を受け入れます。
