変数
変数は、値のプレースホルダーです。 変数は、問合せ、パネル・タイトルおよび新規ダッシュボードの定義時に使用できます。 そのため、ドロップダウンを使用して値を変更すると、パネルのメトリック問合せが新しい値を反映するように変更されます。
次の変数を使用できます:
- ターゲット・タイプ
すべてのターゲット・タイプのリストをフェッチします。
ノート:
v4.0.0より前のGrafanaのEMアプリケーションのバージョンを使用している場合は、変数をJSON文字列として指定する必要があります。
- ターゲットの名前
特定のターゲット・タイプを指定して、すべてのターゲット名のリストをフェッチします。
ノート:
v4.0.0より前のGrafanaのEMアプリケーションのバージョンを使用している場合は、変数をJSON文字列として指定する必要があります。
- 名前付き資格証明
ターゲット・タイプおよびターゲット名で識別される、特定のターゲットに定義されている使用可能なEMの名前付き資格証明のリストをフェッチします。
ノート:
v4.0.0より前のGrafanaのEMアプリケーションのバージョンを使用している場合は、変数をJSON文字列として指定する必要があります。
- リポジトリ問合せ変数
Grafana v4.0.0のEMアプリケーションから、リポジトリ・データベースに対して実行される「リポジトリ問合せ」変数が使用可能になります。 この変数の値は、後で問合せエディタの他のロー問合せで参照できます。 指定したSQL問合せが1つの列のみを返す場合、変数の
label
と「値」の両方として使用されます。 指定したSQL問合せが2つ以上の列を返す場合、最初の列が「ラベル」として使用され、2番目の列が「値」として使用されます。 「ラベル」はユーザーが選択できる変数ドロップダウンに表示され、値は変数が使用されるときに置換される文字列です。 - 時差
Grafana v4.0.0のEMアプリケーションから、「時間差異」変数が使用可能であり、指定した「単位」の時間の指定された「開始」値と「宛先」値の間の時間差を計算するように定義できます。 「開始」および「宛先」プロパティの値は、他のテンプレート変数またはGrafana組込み変数${__from}および${__to}です。 これらの組込み変数は、ユーザーが時間ピッカーで選択した時間範囲を表します。
- 時間ピッカー
Grafana v4.0.0のEMアプリケーションから、「時間ピッカー」変数が使用可能であり、UIから明示的に選択せずに、時間ピッカーを自動的に変更するように定義できます。 この変数のコントロールは、FromToまたは「間隔」および「単位」のいずれかです。 FromToと「間隔」の両方の値は、他のテンプレート変数から取得する必要があります。これは、値が変数の定義時に既知の定数である場合、この変数を使用すると冗長になるためです。 FromToは、<from> ; <to>または<from>という形式の値に解決する必要があります。<from>および<to>は、広く認識されている日時文字列(ISO 8601、RFC 2822、UNIXタイムスタンプなど)または相対Grafana文字列(now-6d、now-6hなど)です。 値が<from>という形式の値に解決される場合は、<from> ;nowと同等です。
許容値書式の例を次に示します:
now-6d;now, now-6d, 1669158747;1669168747, 1669158747, 2022-01-01;2022-01-31, 2022-01-01