Using Dashboards

When using an existing dashboard within your LogScale instance, you can choose to navigate around the dashboard view, change, share and alter the dashboard, and configure the dashboard access.

Main Operations

The following operations can be performed with each dashboard:

  • Wall Monitors & Shared URLs — allows to share read-only dashboards. See Sharing Dashboards section below for more details.

  • Duplicate — creates an identical dashboard. You are prompted to provide:

    • Dashboard Name is the name you assign to the copied dashboard.

    • Target Repository or View is the repository or view where you want to store your copied dashboard.

  • Rename — allows you to change the name of the existing dashboard.

  • Export as template — allows you to create a template from the current dashboard, which you may reuse for new empty dashboards, as explained in Creating a New Dashboard.

  • Delete — deletes the dashboard and all its widgets. Removal of a dashboard cannot be undone!

You can access the menu for the above operations in three ways:

  • From the All Dashboards tab — click the cog icon under each repository name:

Dashboard Options from All Dashboards tab

Figure 116. Dashboard Options from All Dashboards tab

  • Inside a given repository, from the main Dashboards page — click the three-dot menu next to each dashboard:

Dashboard Options from Dashboard Page

Figure 117. Dashboard Options from Dashboard Page

  • Directly from the main dashboard pane — click the three-dot menu (⋮) on the upper right corner:

Dashboard Options from Main Pane

Figure 118. Dashboard Options from Main Pane

Sharing Dashboards

One of the most popular features in LogScale is sharing dashboards with an external audience, publicly or to a limited group, granting this audience a read-only access and allowing them to have the dashboard displayed on a wall-monitor. You may also use this feature to provide read-only access to another device.

To share dashboards, follow these steps:

  1. Access the dropdown menu shown in Figure 116, “Dashboard Options from All Dashboards tab” and select Wall Monitors & Shared URLs.

  2. A dialog box will open — enter a name in the Link Name field, one that will remind you by whom or for what the link will be used.

  3. Once created, the link is added in the dialog under the Active dashboard URL column; click Copy link to copy it.

Create Link

Figure 119. Create Link

You can now use the copied link either in the web browser of a computer with a wall-monitor, or to share it with someone else to use in their browser.

Since all shared URLs are read-only, no one can change your data or have access to more than what it is displayed in the dashboard.

Disabling Access to Shared Dashboards

Because shared dashboards are accessible to anyone who has a link to them, there is a risk of unwanted information disclosure; therefore, in some cases you might want to prevent certain users from accessing these dashboards. You can either:

When trying to access a shared dashboard that has been disabled afterward, two possible cases apply:

  • Users opened a shared dashboard before it became unavailable, meaning the dashboard is running — they are presented with an error and the dashboard changes status to reflect this. Furthermore, if access to that dashboard is reenabled, it will come back for these users, without any manual intervention needed.

  • Users attempt to open a link to a shared dashboard after it became unavailable — they do not get any error message and it will look like it isn't a real dashboard. If the dashboard is reenabled, these users will need to manually refresh the page to see the dashboard.

Restricting Access with IP Filters

Once you have created read-only dashboards with the option Wall Monitors & Shared URLs, you can restrict access to those dashboards to specific IP addresses. One way to do it is setting the IP filters with the GraphQL interface.

  1. From the User Interface, click on the circled question mark near the top right and select API Explorer:

    API Explorer Selected

    Figure 120. API Explorer Selected

  2. In the panel that pops up, enter a mutation like so:

    mutation {
      updateReadonlyDashboardIPFilter(ipFilter: "allow; deny all")

    In this example, only one IP address is allowed access and all others are denied access to any read-only dashboards.

  3. Click the right arrow-head button to execute it. The results will appear in the panel to the right:

IP Filtering Read-Only Dashboards

Figure 121. IP Filtering Read-Only Dashboards

To change an IP filter, execute the mutation again with the corrected or added values. This will replace the previous IP filters. Or, you can add multiple IP filters by separating them with a semi-colon.

Alternatively, you can set IP filters for read-only dashboards from the User Interface instead of having to use the GraphQL:

Setting IP Filters through User Interface

Figure 122. Setting IP Filters through User Interface