Adding a dashboard

Add a dashboard to display your IBM® Security QRadar® AQL query results. You can add panels to your dashboard to display the results of multiple queries.

About this task

Important: IBM Security QRadar AQL Plugin supports the events and flows Ariel databases. AQL function syntax is the same for both events and flows queries.
Important:

IBM Security QRadar AQL Plugin custom column names that are used with the AS operator do not support the following characters:

  • Capital letters
  • Spaces or underscores
  • Special characters

Procedure

  1. In your Grafana instance, from the navigation menu, click Dashboards.
  2. On the Dashboards page, click New > New Dashboard.
  3. On the New dashboard page, click Add visualization.
  4. On the Query tab, in the Data source field, select IBM Security QRadar AQL Plugin.
    Tip: You can add a dashboard panel that queries two or more data sources. To query more than one data source, select Mixed.
  5. In the Results Range field, enter a range value for this panel query. This value overrides the data source range configuration value.
  6. Enter your AQL query.
    Important: The following AQL query formatting is required:

    AQL DATEFORMAT function supports the following pattern.

    yyyy-MM-dd hh:mm:ss
    AQL Function Syntax
    Date / time

    Unix timestamp

    select starttime from events limit 5

    AQL DATEFORMAT function supports the following pattern.

    yyyy-MM-dd hh:mm:ss
    Numeric

    Calculations on fields require an AQL formatting function.

    select  long(starttime/1000*60) from events limit 5
    MetaData
    AQL metadata fields require double quotation marks and the AS operator, mapping to a known AQL data type.
    select "Events per Second Raw - Average 1 Min" as double from events
    select “element” as str from events
  7. Click Run Query.
  8. Optional: In the Title field, enter a name for your panel.
  9. Optional: Configure the parameters for your panel.
  10. To apply your panel changes and return to the Dashboard page, click Apply.
    Important: Applying your changes does not save your dashboard.
    • To add another panel to your dashboard from the Dashboard page, click the Add panel icon ().
    • To save your changes from the Dashboard page, click the Save icon (Save icon).
  11. To save your dashboard, click Save.
  12. In the Save dashboard panel, enter a name for your dashboard.
  13. In the Folder field, select a folder or enter a name to create a new folder, and then click Save.
    A Dashboard saved message is displayed. Your dashboard is saved on the Dashboard page in the folder that you chose.
  14. To edit your dashboard, follow these steps:
    1. On the Dashboards page, click the dashboard that you want to edit.
    2. On the panel that you want to edit, click the Menu icon (Menu icon), and then click Edit.
    3. Edit your dashboard, and then click Save.
    4. In the Save dashboard panel, enter a description of your changes, and then click Save.
  15. To delete your dashboard, follow these steps:
    1. On the Dashboards page, click your dashboard and then click the Dashboard settings icon (Dashboard settings icon).
    2. Click Delete Dashboard.
    3. In the Delete window, click Delete.