• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

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

カスタム ダッシュボードの場合、テンプレート変数を使用して、グラフやその他のウィジェットを動的にフィルター処理できます。テンプレート変数は、ダッシュボードをより便利にするのに役立ち、さまざまなユース ケースで再利用できるダッシュボードをより簡単に作成するのに役立ちます。

テンプレート変数を使用する理由

テンプレート変数は、ダッシュボードの作成者が選択した特定のメタデータ値に基づいてダッシュボード全体をフィルタリングする強力で動的な方法です。テンプレート変数を使用する利点は次のとおりです。

  • これにより、ダッシュボードが使いやすくなります。ユーザーはデータの構造を理解する必要がなく、設定したさまざまなフィルター オプションから簡単に選択できます。
  • これらを使用すると、再利用可能なダッシュボード テンプレートを作成できます。これを複製して、他の多くの用途に合わせて調整できます。

いくつかのテンプレート変数を含むダッシュボードの例を次に示します。これは、ダッシュボードの上部に表示されます。

テンプレート変数を使用すると、さまざまな変数とフィルターを設定して、必要なダッシュボード エクスペリエンスを作成できます。作成できるエクスペリエンスの例:

  • アプリ名を選択するドロップダウン
  • 特定の地域を選択するドロップダウン
  • 特定の期間またはその他の数値を選択するためのドロップダウン
  • フリー テキスト フィールドを使用して一致する文字列を検索するフィルター

要件と制限

テンプレート変数は、カスタム ダッシュボードのウィジェットを作成するコンテキストでのみ使用できます。(NRQLクエリでの変数の使用については、 NRQL変数を参照してください。)

テンプレート変数を含むクエリは、ダッシュボードのコンテキストでのみ使用できます。このため、一部のクエリ関連機能は動作しません。たとえば、 Export dashboard as PDFオプションは、変数を持つウィジェットをサポートしていません。

クエリの作成に関する制限については、「クエリの作成」を参照してください。

テンプレート変数を使用する

テンプレート変数の作成方法を順を追って説明し、その後、さまざまな種類のテンプレート変数の例をいくつか示します。

テンプレート変数の作成は、次の 2 つの部分で構成されます。

  1. テンプレート変数を定義する
  2. その変数を使用するようにウィジェットを作成または編集します

ステップ 1. テンプレート変数を定義する

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

変数を定義するには:

  1. 変数のないダッシュボードから、[変数の追加] をクリックします。(すでに変数が存在する場合は、変数の右側にある+アイコンをクリックします。)
  2. 変数の追加ワークフローを完了します。以下は、各フィールドのルールとヒントです。

フィールド

詳細

クエリで使用する名前

変数の名前。これは、 {{...}}で囲まれたクエリで使用するものです。たとえば、ここで名前としてcountryを使用する場合、クエリを記述するときに{{country}}で変数を呼び出します。

変数名は文字で始める必要があり、文字、数字、アンダースコアを含めることができます。

表示名

オプション。このように変数がダッシュボードの上に表示されるため、ダッシュボードのユーザーは変数が何を表しているかがわかります。これを空白のままにすると、メインの名前の値が使用されます。

タイプ

次の 3 つのオプションがあります。

  • クエリ: ドロップダウン メニューで使用されるオプションの動的リストを返すクエリを作成できます。たとえば、次のクエリはcountry値の動的リストを返します:

    SELECT uniques(countryCode) FROM PageAction since 2 days ago

    クエリを作成する際の規則とヒントについては、「クエリ型変数」を参照してください。

  • List : ドロップダウン メニューのオプションに入力するために使用されるコンマ区切りの値のリスト。たとえば、次のようなリストを使用してcountry値のリストを手動で定義できます。 ES, US, CA.

  • テキストフィールド: 選択する値のドロップダウンの代わりに、これにより、ダッシュボード ユーザーは入力したテキストをフィルタリングできます。

アカウント

queryタイプにのみ存在します。複数のアカウントを持つ組織の場合、これは照会されるアカウントを設定します。

デフォルト値

オプション。これらは、ダッシュボードがフィルター処理するデフォルト値です。たとえば、上記のcountryクエリを使用した場合、デフォルト値としてESを入力すると、ダッシュボードはその値に自動的にフィルターをかけます。すべての可能性を選択することもできます。

WHERE句で複数の値を使用するには、 =の代わりにINを使用する必要があります。

複数選択

オプション。このオプションを使用すると、ドロップダウンで単一の選択ではなく複数の選択を許可できます。

出力フォーマット

これにより、変数によって生成されたデータの処理方法を変更できます。デフォルトでは、値がどうなるかを自動的に把握しようとします。ただし、これを特定のものに変更できます。

  • String : 変数が文字列を生成する場合に使用します。
  • Number : 数値を生成する場合に使用します。
  • 識別子: イベント名やファセット名など、クエリの一部を置き換える場合に使用します。

country値のテンプレート変数の例については、このドキュメントの上部にあるスクリーンショットを参照してください。

テンプレート変数を定義したら、ウィジェットへのテンプレート変数の追加に進むことができます。

ステップ 2. 変数を使用するウィジェットを作成する

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

パート 1 で説明したcountry変数を使用するクエリを作成する例を次に示します。

SELECT countryCode FROM PageAction WHERE countryCode = {{countryCode}}

クエリで変数を使用する際に注意すべき重要な点がいくつかあります。

  • 定義した変数は、 {{ … }}ブラケット内に入ります。
  • 変数は文字列値を生成します。

右側に結果のウィジェットの例があり、左側にcountryドロップダウンがあります。

テンプレート変数の定義とその変数を参照するウィジェットの追加が完了したら、テンプレート変数バーからさまざまなオプションを選択し、選択に基づいてウィジェットが変化するかどうかを確認することで、期待どおりに機能していることを確認できます。

クエリ型テンプレート変数の書き方のルール

テンプレート変数の定義に関するセクションで説明したように、クエリ、リスト、およびテキスト フィールドの 3 つの変数タイプがあります。query-type 変数の作成は最も複雑です。これは、値を返す実際のクエリを作成する必要があるためです。値は、ダッシュボードの上部にあるテンプレート変数バーのドロップダウンに入力するために使用されます。

重要

これは、テンプレート変数を利用するクエリの記述とは異なるトピックであることに注意してください。

クエリ型変数の作成に関するルールとガイダンスを次に示します。

  • クエリはuniques構文を使用する必要があります。Uniques は最大 10,000 件の結果を返します。uniques構文を確認してください。クエリの例を次に示します: From PageAction select uniques(countryCode)
  • uniquesコンポーネントが値のリストを返す限り、ほぼすべての NRQL クエリを使用できます。
  • ネストされた変数はサポートされていません。変数内に変数を含めることはできません。

テンプレート変数の実装のいくつかの異なるタイプを次に示します。

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.