• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、 を参照してください。

問題を作成する

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

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

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

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

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

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

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

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

要件と制限

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

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

クエリの追加に関する重要な注意事項:

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

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

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

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

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

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

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

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

重要

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

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

  • クエリでは、 uniques または keyset 構文を使用する必要があります。Uniques は最大 10,000 件の結果を返します。 uniqueskeysetを確認してください。次に、クエリの例をいくつか示します。

    From PageAction select uniques(countryCode)
    From PageView select keyset() SINCE 1 day ago
  • uniques および keyset コンポーネントが値のリストを返す限り、ほぼすべての NRQL クエリを使用できます。

  • ネストされた変数はサポートされていません。変数内に変数を含めることはできません。

いくつかの例

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

まだお持ちでない場合は、以下で無料の New Relic アカウントを作成して、今すぐデータの監視を開始してください。

Copyright © 2024 New Relic株式会社。

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