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

まず、テンプレート変数を定義します。これは、ウィジェットを作成するために NRQL クエリで使用する変数です。

変数を定義するには:

1. 変数のない新しいダッシュボードから、編集をクリックします ボタンをクリックし、左上隅にある [+ 変数の追加] ボタンをクリックします。変数の追加が完了したら、 [編集を終了]をクリックします。

   ダッシュボードにウィジェットが含まれている場合は、 [+ 変数を追加] ボタンをクリックします。

   

2. 変数の追加ワークフローを完了します。以下は、各フィールドのルールとヒントです。

   フィールド	詳細
   クエリで使用する名前	変数の名前。これは、 {{...}}で囲まれたクエリで使用するものです。たとえば、ここで名前としてcountryを使用する場合、クエリを記述するときに{{country}}で変数を呼び出します。 変数名は文字で始める必要があり、文字、数字、アンダースコアを含めることができます。
   表示名	オプション。このように変数がダッシュボードの上に表示されるため、ダッシュボードのユーザーは変数が何を表しているかがわかります。これを空白のままにすると、メインの名前の値が使用されます。
   タイプ	次の 3 つのオプションがあります。 クエリ: ドロップダウン メニューで使用されるオプションの動的リストを返すクエリを作成できます。たとえば、次のクエリはcountry値の動的リストを返します: SELECT uniques(countryCode) FROM PageAction since 2 days ago コピー クエリを作成する際の規則とヒントについては、「クエリ型変数」を参照してください。 List : ドロップダウン メニューのオプションに入力するために使用されるコンマ区切りの値のリスト。たとえば、次のようなリストを使用してcountry値のリストを手動で定義できます。 ES, US, CA. テキスト フィールド: 選択する値のドロップダウンの代わりに、これにより、ダッシュボード ユーザーは入力したテキストをフィルタリングできます。
   アカウント	queryタイプにのみ存在します。複数のアカウントを持つ組織の場合、これは照会されるアカウントを設定します。
   クエリ	uniques (attribute)を使用してここにクエリを記述します。
   複数選択	オプション。このオプションを使用すると、ドロップダウンで単一の選択ではなく、同時に複数の選択を許可できます。
   デフォルト値	オプション。これらは、ダッシュボードがフィルター処理するデフォルト値です。たとえば、上記のcountryクエリを使用した場合、デフォルト値としてESを入力すると、ダッシュボードはその値に自動的にフィルターをかけます。すべての可能性を選択することもできます。 WHERE句で複数の値を使用するには、 =の代わりにINを使用する必要があります。
   出力フォーマット	これにより、変数によって生成されたデータをクエリで処理する方法を変更できます。ここで選択したオプションは、後でウィジェットに追加するクエリに関連しています。ほとんどのクエリで使用されるより一般的なオプションであるため、 デフォルトの オプションは文字列です。 デフォルトの オプションを次のいずれかに変更できます。 String : 変数が文字列を生成する場合に使用します。 Number : 数値を生成する場合に使用します。 識別子: イベント名やファセット名など、クエリの一部を置き換える場合に使用します。

   country 値のテンプレート変数がどのようになるかを示す次の例を参照してください。

   

   テンプレート変数を定義したら、作成したテンプレート変数を使用するウィジェットを追加できます。

テンプレート変数を構成したら、クエリで定義した変数を使用するウィジェットがダッシュボードに必要になります。

ウィジェットを作成するには:

1. ダッシュボードから、右上隅にある [+ ウィジェットを追加] ボタンをクリックします。

2. 2 つのオプションがあります。

   • グラフを追加します。 クエリ ビルダーを使用してウィジェットを作成します。
   • テキスト、画像、またはリンクを追加します。 Markdown エディターを使用して、独自のコンテンツを追加するウィジェットを作成します。

3. グラフの追加 オプションを選択します。

4. クエリを追加し、 [実行]をクリックします。

   ステップ 1 で説明した例に従います。

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

   コピー
   

5. [保存]をクリックします

タイプ NRQL/ENUMの変数を作成するときに、表示オプション セクションから複数値オプションを有効にすることができます。

{{MultiValue}} という名前の変数を作成し、一意のすべての eventId のリストを返すクエリの例を次に示します。

SELECT uniques(eventId) FROM AjaxRequest

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

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

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

次に、2 つのテンプレート変数を使用するクエリの例を示します。これは、 countryCode および city テンプレート変数がすでに作成されており、それらの値が 1 つであることを前提としていることに注意してください。

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

ここに例を示します。次に示すように、文字列変数を定義します。

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

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句の後に使用して、さまざまな値でグループ化できます。

たとえば、 countryCodeとcityの 2 つの可能な値を持つリスト型の{{location}}変数を作成するとします。出力形式をidentifierに設定します。

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

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

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

たとえば、 55と90の 2 つの可能な値を持つタイプlistの{{percentile}}変数を作成できます。出力形式をnumberとして設定したいと思います。

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

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

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

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