テンプレート変数: ダッシュボードを動的にフィルタリングする

複数値オプションを有効にすると、ユーザーはドロップダウンから 1 つの値ではなく複数の値を選択できるようになります。これは、複数の基準で同時にデータをフィルタリングする場合に便利です。

クエリおよびリスト変数タイプでは、複数の値を使用できます。テキスト フィールド変数は複数値オプションをサポートしていません。

複数の値を有効にするには:

1. クエリまたはリスト テンプレート変数を作成するときは、 Multi-valueオプションを選択します。

2. ウィジェット クエリでは、複数の選択された値を処理するには、 =ではなくIN演算子を使用します。

   変数に{{MultiValue}}という名前を付け、このクエリを使用してその値を入力する例を次に示します。

   SELECT uniques(eventId) FROM AjaxRequest

   コピー

   次に、次のクエリでウィジェットを作成します。

   SELECT count(*) FROM AjaxRequest WHERE eventId IN ({{MultiValue}})

   コピー

一度に定義できるテンプレート変数は 1 つだけですが、同じウィジェット内で複数の変数を参照できます。

この例では、次の 2 つの変数を設定する必要があります。

1. countryCode 変数: このドキュメントで前述したクエリを使用します。

   SELECT uniques(countryCode) FROM PageAction SINCE 2 days ago

   コピー

2. city 同様のクエリを持つ変数:

   SELECT uniques(city) FROM PageView SINCE 1 week ago

   コピー

   上記のテンプレート変数を単一の値で使用してウィジェットを作成する例を次に示します。

   SELECT countryCode, city FROM PageAction 
   WHERE countryCode = {{countryCode}} AND city = {{city}}

   コピー

   変数が複数の値をサポートする場合（ city変数の場合はChicago 、 New York 、 Parisなど）、 IN使用する必要があります。

   SELECT countryCode, city FROM PageAction 
   WHERE countryCode IN ({{countryCode}}) AND city IN ({{city}})

   コピー

変数とregexを使用して、フィルターの一部が修正されていることが確実であれば、フィルターを作成できます。

LIKEを使用する場合は、この部分一致を使用する必要があります。

リリース バージョンでフィルター処理するとします。クエリはrelease-1234のようなものを返します。

aparseを使用して変数を作成し、バージョン番号を解析できます。

SELECT uniques(aparse(platformVersion, 'release-*')) FROM PageView

次に、次のクエリでウィジェットを作成します。

SELECT count(*) FROM PageAction 
WHERE aparse(platformVersion, 'release-*') IN ({{releaseversion}}) FACET platformVersion

または、 capture コマンドを使用することもできます。

SELECT count(*) FROM PageAction 
WHERE capture(platformVersion, r'release-(?P<platformVersion>\d+)') IN ({{releaseversion}}) FACET platformVersion

LIKE と RLIKE テンプレート変数として使用して、ダッシュボード内のデータをフィルタリングできます。この機能を使用するには、テンプレート変数の作成時に追加する値で、値の先頭と末尾に % ワイルドカード記号を使用する必要があります。

ここに例があります。次の値を持つ文字列テンプレート変数を定義します。

• クエリで使用する名前: line_filter

• タイプ： Text field

• デフォルト値: %@%.com

• 出力形式: String

  次に、ウィジェット グラフを作成し、次のように変数を使用できます。

  FROM NrdbQuery SELECT user WHERE user LIKE {{like_filter}}

  コピー

  またはこのように:

  FROM NrdbQuery SELECT user WHERE user RLIKE {{like_filter}}

  コピー

文字列出力形式で NRQL 型の変数を作成し、それを FACET 句の後に使用して、異なる値でグループ化できます。

たとえば、次のような{{userAgentName}}という名前のテンプレート変数を作成できます。

SELECT uniques(userAgentName) FROM PageAction

次に、次のクエリを使用してウィジェットを作成します。

SELECT count(*) FROM PageAction 
WHERE userAgentName={{userAgentName}} FACET userAgentName

identifier出力形式で変数を作成し、それをFACET句の後に使用して、さまざまな値でグループ化できます。

たとえば、 {{location}}変数を作成できます。

• クエリで使用する名前:location

• タイプ： List

• カンマで区切られた値: countryCodeと city

• 出力形式: Identifier

  次に、次のクエリを使用してウィジェットを作成します。

  SELECT count(*) FROM PageAction FACET {{location}}

  コピー

出力形式numberで変数を作成し、それをパーセンタイル関数内で使用できます。

たとえば、 {{percentile}}変数を作成できます。

• クエリで使用する名前:percentile

• タイプ： List

• カンマで区切られた値: 55と 90

• 出力形式: Number

  次に、次のクエリを使用してウィジェットを作成します。

  SELECT percentile(duration, {{percentile}}) FROM PageAction

  コピー

フィルタリングに変数を使用するには、次のように、作成した変数をWHERE句の右側に追加するだけです。

SELECT countryCode, city FROM PageAction 
WHERE countryCode IN ({{countryCode}})

デフォルトでは、「タイムピッカーを無視」オプションが有効になっています。つまり、ダッシュボードのタイムピッカーに別の値が選択されている場合でも、書き込みは常にデフォルトの1 hour時間範囲値を使用して実行されます。 5 minutes 、 3 hoursなど)。 この場合の例外は、クエリにSINCE句で明示的に時間範囲が設定されている場合です。次に例を示します。

SELECT uniques(eventId) 
FROM AjaxRequest 
SINCE 5 minutes ago

結果は過去 5 分間の範囲になります。

「タイムピッカーを無視する」オプションをオフにすると、タイムピッカーで選択した値で書き込みが実行されます。 たとえば、以下のスクリーンショットのように、変数編集フォームでタイムピッカーを 30 分に設定すると、「タイムピッカーを無視する」フィールドがオフに設定されます。

これにより、過去 30 分間の値が得られます。 タイムピッカーの値をDefaultに設定し、クエリにSINCE句が含まれている場合、最新の値を使用してクエリが実行されます。

場合によっては、異なる種類のデータに同じルールを適用するクエリがあることがあります。 以下は、データ型を除いて同一の 2 つのウィジェットの例です。

• ウィジェット 1:

  SELECT count(*) FROM DataType1 SINCE 1 day ago

  コピー

• イド 2:

  SELECT count(*) FROM DataType2 SINCE 1 day ago

  コピー

  2 つの別個の ウィジェット を作成する代わりに、Identifier[出力形式]のOutput format[識別子]を持つ変数を使用して 1 つの ウィジェット を作成できます。 次に、これをFROM句で使用して、さまざまなデータ型をクエリできます。

  たとえば、2 つの値DataType1とDataType2を持つList型の{{dataType}}変数を作成できます。 Output Format[出力形式を]Identifier[識別子]に設定します。

  

  次に、ウィジェットを作成して実行します。

  

ダッシュボード JSON の管理機能を使用すると、リストベースの変数の値にカスタム タイトルまたはラベルを定義できます。これにより、変数のドロップダウン メニューに表示される内容を変更できます。

たとえば、次のような変数があるとします。

{
    "name": "list_string",
    "items": [
      {
        "title": null,
        "value": "1"
      },
      {
        "title": null,
        "value": "2"
      },
      {
        "title": null,
        "value": "3"
      }
    ],
    "defaultValues": [],
    "nrqlQuery": null,
    "options": {
      "excluded": false
    },
    "title": "List of string",
    "type": "ENUM",
    "isMultiSelection": false,
    "replacementStrategy": "STRING"
  }

JSON を開いてtitleフィールドに値を追加すると、次のようになります。

{
  "name": "list_string",
  "items": [
    {
      "title": "Title One",
      "value": "1"
    },
    {
      "title": "Title Two",
      "value": "2"
    },
    {
      "title": "Title Three",
      "value": "3"
    }
  ],
  "defaultValues": [],
  "nrqlQuery": null,
  "options": {
    "excluded": false
  },
  "title": "List of string",
  "type": "ENUM",
  "isMultiSelection": false,
  "replacementStrategy": "STRING"
}

追加したタイトルは変数のドロップダウンに表示されます。これは変数やウィジェットのロジックにはまったく影響しません。

ウィジェット タイトルでテンプレート変数を使用すると、変数値を変更すると自動的に更新される動的なタイトルを作成できます。これは、表示されるデータに関するコンテキストを提供するのに役立ちます。

ウィジェットを編集するときに UI を介して、またはダッシュボード JSONを使用して、ウィジェット タイトルに変数を追加できます。

たとえば、「アラート」、「 APM 」、「ダッシュボード」、「カタログ」などの値を持つ{{products}}という名前の変数がある場合、 Page views per nerdlet: {{products}}のような動的なタイトルを持つウィジェットを作成できます。

変数ドロップダウンから「アラート」を選択すると、ウィジェットのタイトルが自動的に更新され、選択した値が表示されます。「アラート」、「APM」、「ダッシュボード」を複数選択すると、タイトルが更新され、選択したすべての値が表示されます。

この機能は、あらゆるテンプレート変数タイプ (クエリ、リスト、またはテキスト フィールド) で動作し、ユーザーは変数フィルターを確認しなくても、表示しているデータの内容を理解するのに役立ちます。

マークダウン ウィジェットでテンプレート変数を使用すると、変数の選択に基づいて更新される動的なテキスト コンテンツ、ドキュメント、または図を作成できます。これは、コンテキスト メモや Mermaid 図のような視覚化を作成する場合に特に強力です。

たとえば、「アラート」、「 APM 」、「ダッシュボード」、「カタログ」などの値を持つ変数{{products}}がある場合、それをマークダウン コンテンツでさまざまな方法で使用できます。

例1: 動的なテキストコンテンツ

変数 ({{products}}) をマークダウン テキストに直接含めて、選択内容に基づいて更新される動的なドキュメントを作成できます。

例2: ダイナミックマーメイドダイアグラム

Mermaid ダイアグラムのマークダウン テキスト内で変数 ({{products}}) を使用して、動的に更新されるフローチャートを作成することもできます。

この例では、図は、 {{products}}変数がどのデータを保持または破棄するかを決定する決定フローを示しています。変数の選択を変更すると、選択した製品を反映して図が更新されます。