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 and Views in question. For information on how to set permissions in LogScale's repositories, see Authorization.

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 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 interval selector on the top right, where to choose Time Window (e.g., Last 1h Live) or Fixed Time Range (e.g., Last 1h Static). For details on the timeframe you can set, see Expanding 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 as Auto, 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 As... button at the top right of the graph pane and select the Dashboard Widget option.

    Create Widgets

    Figure 123. Create Widgets


  8. In the Dashboard Widget dialog shown in figure Figure 124, “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 124. 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.

Move Widgets

Figure 125. Move Widgets


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 126. Repeated Query Indicator


Editing an Existing Widget

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

  • Edit in Search view — redirects you to the Search tab, where you can edit the query while in Editing Widget mode inside the selected widget.

  • 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.

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

  • Remove — deletes the widget from the dashboard.

Edit Widgets

Figure 127. Edit Widgets