変数

変数は、値のプレースホルダです。問合せやパネル・タイトルで、新しいダッシュボードの定義時に変数を使用できます。したがって、ドロップダウンを使用して値を変更すると、パネルのメトリック問合せが新しい値を反映して変更されます。

次の変数を使用できます:

• ターゲット・タイプ

  すべてのターゲット・タイプのリストを取得します。

  ノート:

  v4.0.0より前のバージョンのEM App for Grafanaを使用している場合は、変数をJSON文字列として指定する必要があります。

  
  
  
  
  
• ターゲット名

  特定のターゲット・タイプを指定して、すべてのターゲット名のリストを取得します。

  ノート:

  v4.0.0より前のバージョンのEM App for Grafanaを使用している場合は、変数をJSON文字列として指定する必要があります。

  
  
  
  
  
• 名前付き資格証明

  特定のターゲットに対して定義されていて、ターゲット・タイプとターゲット名で識別される、使用可能なEM名前付き資格証明のリストを取得します。

  ノート:

  v4.0.0より前のバージョンのEM App for Grafanaを使用している場合は、変数をJSON文字列として指定する必要があります。

  
  
  
  
  
• リポジトリ問合せ変数

  EM App for Grafana v4.0.0以降では、リポジトリ・データベースに対して実行されるリポジトリ問合せ変数が使用可能です。この変数の値は、後で問合せエディタの他のrawQueryで参照できます。指定されたSQL問合せが1つの列のみを返す場合、その列は変数のラベルと値の両方として使用されます。指定されたSQL問合せが2つ以上の列を返す場合、最初の列がラベルとして使用され、2番目の列が値として使用されます。ラベルはユーザーが選択できるように変数ドロップダウンに表示され、値は変数が使用されるときに置換される文字列です。

  
  
  
  
  
• 時間差

  EM App for Grafana v4.0.0以降では、時間差変数が利用可能になりました。この変数は、指定された時間単位で指定された開始値と終了値の間の時間差を計算するように定義できます。開始プロパティと終了プロパティの値は、他のテンプレート変数またはGrafana組込み変数${__from}と${__to}にすることができます。これらの組込み変数は、ユーザーが時間ピッカーで選択した時間範囲を表します。

  
  
  
  
  
• 時間ピッカー

  EM App for Grafana v4.0.0以降では、時間ピッカー変数が利用可能になりました。この変数は、UIから明示的に選択しなくても、時間ピッカーを自動的に変更するように定義できます。この変数の制御は、FromToまたはIntervalとUnitのいずれかで行われます。FromToとIntervalの両方の値は、他のテンプレート変数から取得する必要があります。変数定義時に値が既知の定数である場合、この変数を使用すると冗長になるためです。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