Creating Dashboards and Widgets

Security Requirements and Controls

There are two ways to create a new dashboard within a repository or view:

  • From the Search page of the User Interface, starting with a new search: this will create a new dashboard and a new widget together. This method is generally used when you're working with a search query that you want to preserve by saving it directly as a new widget. See Create from a Query.

  • From the Dashboards page of the User Interface: this method is used when you want an empty dashboard that will contain all the widgets you'll create, or when you intend to import/duplicate an existing dashboard. See Create from Dashboards tab.

Create from a Query

To create a new dashboard (and its widget) from a search, these are the 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.

  4. Click the Time Selector on top to choose the time interval (e.g., Last 1d). The active search interval used is saved along with the widget. For details on the timeframe you can set, see Change Time Interval.

  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, see Widgets for details on all widgets available.

  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 Dashboard Widget

    Figure 97. Creating Dashboard Widget

  8. In the Dashboard Widget dialog popping up, enter information as required:

    • Dashboard — Select New Dashboard from menu and enter a name for your new dashboard. You have the option of assigning the widget you're creating to an existing dashboard, if there is any.

    • 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 98. Dashboard Widget dialog

  9. Click Save: your new dashboard is being created and appears in the main pane.

  10. Optionally, click the pencil icon on the top right to resize or rename your widget, change the description etc., see Editing Dashboards for more information.

Create from Dashboards tab

To create a new dashboard from the Dashboards page, follow these steps.

  1. Click the Repositories and views tab and pick the repository or view where to create your dashbord.

  2. Select the Dashboards tab from the top menu bar. There you'll see a list of dashboards, if you have any.

    Dashboards tab

    Figure 99. Dashboards Tab

  3. Click the + New Dashboard button.

  4. In the New Dashboard dialog box, choose how to create the dashboard:

    • Empty Dashboard — creates from scratch an empty blank dashboard, one that will serve as a container for your Widgets. This is the default option, where you are prompted to provide only the Name for the dashboard.

    • Duplicate Existing — creates a copy of an existing dashboard, whether it is in the current or another repository or view: you are prompted to pick which one from the Source repository or view dropdown. Then pick the dashboard you want to copy from the Duplicate Template dropdown:

      Duplicate a Dashboard

      Figure 100. Duplicate a Dashboard

    • From Template — allows you to create a dashboard based on a template generated from another dashboard. Drag&drop a file or browse your computer to use such template.

    • From Package — allows you to invoke dashboard templates that are part of LogScale packages, provided that such packages are installed in the repository where you want to create the dashboard. For more information on how to install a package and access a package template, see Packages.