AQL または汎用 API データ・ソース ( Time Period や Time Valueなど) を使用して、すべてのウィジェットで使用できるパラメーターを作成します。 共通のパラメーターおよびデフォルト値を使用すると、ウィジェット用に個々の照会を作成したり編集したりするのにかかる時間を短縮できます。
始める前に
以下の AQL の例のように、パラメーターは中括弧内に表示されます。
中括弧は、引用符付きストリング (引用符で囲まれたストリング・リテラル) 名の AQLステートメントでも使用されるため、引用符付きストリング内の左中括弧の前にエスケープ文字として円記号 (¥) を使用する必要があります。 この構文により、 引用符付きストリングがパラメーターとして解釈されて、誤った照会結果が生じることがなくなります。 引用符付きストリングの中に円記号がある場合は、エスケープ文字としてさらに円記号を追加します。
手順
- 「イベントおよびフロー・メトリック」 ダッシュボードなど、AQL ベースまたは汎用の API ベースのウィジェットを含むダッシュボードから、ダッシュボード・メニュー () をクリックします。
「パラメーター値の管理」 ウィンドウに、ワークスペースで既に作成されているパラメーターが表示されます。 いずれかのパラメーターにデフォルト値がある場合は、 「デフォルト値」 列にリストされます。 「出現回数」 列は、各パラメーターを使用するウィジェットの数を示します。 数字の上にポインターを置くと、そのパラメーターを使用するウィジェットが表示されます。
- パラメーターのデフォルト値を設定するには、 「その他のオプション」 アイコンをクリックし、フィールド にデフォルト値を入力してから、 「保存」をクリックします。
注:
- このアクションにより、このパラメーターを使用するすべてのウィジェットについてデフォルト値が設定され、パラメーター・カードが自動的に更新されます。 あるいは、特定のウィジェットのパラメーターの値を追加できます。
- パラメーターのデフォルト値を変更すると、展開またはピン留めされたダッシュボードおよびウィジェットを除き、ワークスペース内でパラメーターが使用されるすべての場所で値が変更されます。 値をデフォルト値として設定しない場合は、更新された変更は現行セッションにのみ適用されます。 ただし、値をデフォルトとして設定する場合は、現行セッションの値でもその値が使用されます。
- 事前定義された SYSTEM:username パラメーターは、ログインしているユーザーのユーザー名を返します。 システム・パラメーターは読み取り専用であり、デフォルト値を変更することはできません。
- 事前定義された SYSTEM:timerange パラメーターは、時間セレクター値を表します。
- ワークスペースにパラメーターを追加するには、 「追加」をクリックし、パラメーターに名前とデフォルト値を指定して、 「保存」をクリックします。
- パラメーターを削除する前に、そのパラメーターがいずれのウィジェットにも属していないことを確認してください。これを確認するには、数字の上にカーソルを移動すると、そのパラメーターを使用しているウィジェットの名前が表示されます。 それらのウィジェットからパラメーターを削除した後、「削除」をクリックします。
- 「ダッシュボードに戻る」 をクリックしてメイン・ビューに戻り、作業を続行します。
