Ariel 照会言語 (AQL) ステートメントを使用してウィジェットを作成できます。 AQL は、 IBM® QRadar®内の Ariel データベースからイベント・データおよびフロー・データを抽出、フィルタリング、および操作するために使用する構造化照会言語です。
始める前に
AQL データ・ソースに基づいてダッシュボード項目を作成するために QRadar Pulse で使用する Ariel 照会言語については、「 IBM QRadar Ariel 照会言語ガイド 」の以下のトピックを参照してください。
このタスクについて
管理者は、他のユーザーのウィジェットやダッシュボードを作成することはできませんが、他のユーザーと独自のダッシュボードを共有することもできます。
手順
- ダッシュボードの構成をクリックします。
「ダッシュボードの構成」 画面に、使用可能なウィジェットのライブラリーがそれぞれの詳細とともに表示されます。
- 新規ウィジェットの作成をクリックします。
- 「 新規ダッシュボード項目 」ページで、ウィジェットの名前と説明を入力します。
- 照会 セクションのデータ・ソース・リストから AQL を選択し、AQL ステートメントを入力します。 詳しくは、 ダッシュボード・グラフ用の AQL 照会の作成のヒントを参照してください。
- ステートメントに既存のパラメーターを挿入します。 パラメーターの挿入アイコンをクリックし、関連するパラメーターごとに「挿入」をクリックします。
- パラメーターのデフォルト値を変更するには、 パラメーターの表示 アイコンをクリックし、デフォルト値を設定した後で 保存 をクリックします。
パラメーターのデフォルト値を変更すると、展開またはピン留めされたダッシュボードおよびウィジェットを除き、ワークスペース内でパラメーターが使用されるすべての場所で値が変更されます。 値をデフォルト値として設定しない場合は、更新された変更は現行セッションにのみ適用されます。 ただし、値をデフォルトとして設定する場合は、現行セッションの値でもその値が使用されます。
ヒント: 事前定義された SYSTEM:username パラメーターは、ログインしているユーザーのユーザー名を返します。 システム・パラメーターは読み取り専用であり、デフォルト値を変更することはできません。
- ワークスペースにパラメーターを追加するには、 追加をクリックし、パラメーターに名前とデフォルト値を指定し (必要な場合)、 保存をクリックします。
ヒント: ダッシュボード上のウィジェットに初めてパラメーターを追加すると、ダッシュボードに 「パラメーター」 カードが表示されます。 ウィジェットからパラメーターを削除し、ダッシュボード内にそのパラメーターを使用するウィジェットがそれ以上なくなれば、パラメーター・カードは表示されなくなります。
- データ・ソースをポーリングする頻度を示すリフレッシュ時間を選択してください。 選択された照会時間より長いリフレッシュ頻度を選択してください。 デフォルトのリフレッシュ頻度は 5 分ごとです。 リフレッシュ時間が短いほど、 IBM QRadarのパフォーマンスへの影響が大きくなります。 リフレッシュ頻度のタイマーは、照会の完了後に開始します。
例えば、リフレッシュ頻度が毎分で、照会の完了に 3 分かかる場合、3 分間の実行が終了した後で初めてリフレッシュ頻度が開始します。
- 照会の実行をクリックします。
データ結果が返されない場合、最初にウィジェットを作成するときにグラフを構成することはできません。 フィールドの条件をあまり厳しくないものにして、照会を再実行してください。
AQL 照会に値が指定されていないパラメーターが含まれる場合は、それらを「パラメーター」ページで入力します。 照会が正常に実行されるように、各パラメーターの値を入力します。 照会が成功した場合、ステートメントの横に結果が表示されます。
- ビュー セクションでビューを作成します。
同じ照会から複数のビューおよびグラフを作成できるため、ビューには固有の名前を付けてください。 デフォルトでは、タイトル・バーにあるグラフのタイトルと状況が表示されます。それらを非表示にするには、その他のオプション・アイコンをクリックして、設定を「オフ」に切り替えます。
- グラフ・タイプを選択し、関連プロパティーを構成します。 使用するグラフ・タイプを決定する際に役立つユース・ケースについては、 ウィジェット・グラフ・タイプを参照してください。
- グラフの外観をプレビューし、 保存をクリックします。
ヒント: グラフのラベルは使用されている照会から取得されます。 プレビューでわかりにくい場合は、「ビュー」セクションでラベルを編集します。
結果
照会を再実行することなく、ウィジェットを編集して保存することができます。 例えば、新規イベントを選出するには期間の長さが不十分である場合や、照会の実行時にマグニチュードまたは重大度の値が適用可能でない場合など、照会によって結果が返されない場合、ウィジェットを保存できます。 照会を編集する場合、ウィジェットを保存する前に照会を再実行する必要があります。
ウィジェットを削除すると、そのウィジェットが属するすべてのダッシュボードからそのウィジェットが削除されます。 削除されたダッシュボードにパラメーターが含まれている場合、それらのパラメーターは削除されません。