Managing Dashboard Widgets

You can create several widgets for your dashboards, and change the appearance of existing ones.

For details on the available widgets you can create, see Widgets.

Note

You can create dashboard widgets or modify them only if you have the Administer Dashboards permission on the Repositories & Views in question. For information on how to set permissions in LogScale's repositories, see Managing Users & Permissions.

Creating a New Widget

To create a dashboard widget, follow these steps.

  1. Go to the Repository and Views tab in the main LogScale User Interface and pick a repository.

  2. Click the Search tab from the top menu bar.

  3. Enter a query of your choice, one that would best suit your data. In the example figure Creating a New Widget:

    logscale
    groupBy(method)
  4. Click the Time Selector on top, to choose the time interval (e.g., Last 1d). For details on the timeframe you can set, see Change Time Frame.

    Note

    The active search interval used is saved along with the widget.

  5. From the dropdown menu on the top left, choose the preferred or compatible chart — one chart type is selected by default e.g. Auto (Table) depending on the query you have entered.

  6. Click Run — you should now see the graph or table in the main pane; if not, check again the time interval you have selected, as it should be consistent with your data set.

  7. Click the Save menu at the top right of the graph pane and select the Dashboard Widget option.

    Creating Widgets

    Figure 142. Creating Widgets


  8. In the Dashboard Widget dialog shown in Figure 143, “Dashboard Widget dialog”, enter information as required:

    • Dashboard — specify which dashboard to add the widget to. You have the option of creating a new dashboard along with the new widget.

    • Widget — choose whether it is a new widget. You have the option of replacing an existing widget by selecting it from the dropdown.

    • Widget Title — provide a title to the new widget.

    • Widget Description — provide a description for the new widget.

    • Open Dashboard after Save checkbox — click it to have your new widget opened in the dashboard.

    Dashboard Widget dialog

    Figure 143. Dashboard Widget dialog


  9. Your new widget now appears in the dashboard's pane — click the pencil icon on the top right to enter Editing Dashboard mode: this allows you to resize your widget, or drag and move it next to other widgets.

  10. Once you're happy with your adjustments, click Save, otherwise Discard Changes.

Editing Dashboard

Figure 144. Editing Dashboard


Creating Widgets with Live join() Functions

There is a known limitation about join() functions that are not supported when running in live queries — the details are explained at Limitations of Live Joins.

This limitation causes these queries not truly running live in your widget, but running repeatedly instead, to show results that are as recent as possible.

When you create a widget with such a query, an indicator in the User Interface notifies you on how old the query is — that is, when it was the last time it has been executed (e.g., Just now, 1 minute ago):

Repeated Query Indicator

Figure 145. Repeated Query Indicator


Editing an Existing Widget

Once a widget is created, there are several actions you can perform with it. Click the three-dot menu icon on the upper right corner of each widget to:

  • Edit in search view — takes you to Editing Widget mode in the Search tab, where you can edit the query for your widget. The query will use the live setting of the dashboard, and the values set in parameters in the query are also carried over into the search view.

  • Styling — opens the Styling panel, where you can modify the properties for a different look&feel of the widget. For details on each widget's specific properties, see Widgets.

  • Interactions — opens the Interactions panel for that widget. See Managing Dashboard Interactions for details.

  • Duplicate — creates an identical widget that will be saved in the dashboard as #2.

  • Remove — deletes the widget from the dashboard.

Edit Widgets

Figure 146. Edit Widgets