Panels

Panels are the building blocks of Lagoon dashboards which allow you to parse device data and generate various types of visualizations. Lagoon supports a wide number of panels useful for various kinds of data, such as time series graphs, maps, and dynamic images.

Panel Types

Static Panels

Data Panels

Organizational Panels


Creating a Panel

  1. Login to the Lagoon Console for your region, and open a dashboard.

  2. Click the Add panel button at the top of the dashboard.

  3. Select the type of panel you want to add.

    https://g.lagoon.soracom.io

    New panel

  4. Click the Panel Title, then select Edit to configure the panel.

    https://g.lagoon.soracom.io

    Edit panel


Importing a Panel

  1. Login to the Lagoon Console for your region, and open a dashboard.

  2. Click the Add panel button at the top of the dashboard.

  3. Select the type of panel you want to import.

    https://g.lagoon.soracom.io

    New panel

  4. Click the Panel Title, then hover over More... and select Panel JSON.

    https://g.lagoon.soracom.io

    Import panel

  5. Paste the JSON data of the panel you want to import, then click the Update button.

    Import panel


Panel Settings

Each Lagoon panel contains common panel settings, such as Title and Description. The following settings can be configured for each panel.

General

https://g.lagoon.soracom.io

General options

Info

Drilldown / detail link - Allows you to add arbitrary links to the Description of the panel, such as a link to a website containing related information, or to another dashboard.

Repeat - When dashboard Variables are used, this setting can be used to create multiple instances of the panel for each variable.

When using dashboard variables, please note that Lagoon does not support dynamically modifying metrics or queries with variables.

Metrics

https://g.lagoon.soracom.io

Metrics

For Data Panels, the Metrics settings are used to specify what data is used in the panel. Depending on panel type, additional settings may be available for controlling how the data is formatted, aggregated, or parsed with respect to the panel type.

When adding metrics, the following options are available:

Additional query parameters vary depending on the panel type. Refer to the documentation for each specific panel type for more information.

Time Range

https://g.lagoon.soracom.io

Time range

For Data Panels, the Time Range settings are used to adjust the range of data to use when generating the panel.

Override relative time - When the dashboard Time picker is set to a relative time range, this setting will override the dashboard time range, and instead use data from the time range specified in this setting. This setting has no effect when the dashboard time range is set to a custom absolute time range.

Add time shift - Shift the time range window by the amount specified, relative to the dashboard time range. When set, this setting will always apply to the panel regardless of whether the dashboard time range is set to a relative time range or an absolute time range.

Hide time override info - When the panel is using a time range that differs from the dashboard time range, info is displayed. This option supresses the info.


Sharing a Panel

When using Lagoon, you can create a URL link for a panel, including a specific time range, in order to share the panel with your team or other collaborators.

Anyone who accesses the panel using the link will be required to login to Lagoon using a Lagoon User associate with your Soracom account. If you are using Lagoon Pro, the user will also need sufficient privileges in order to view the panel.

  1. Login to the Lagoon Console for your region, and open a dashboard.

  2. Find the panel that you want to share.

  3. Click the Panel Title, then select Share.

    https://g.lagoon.soracom.io

    Share panel

  4. Select your link preferences, then click the Copy button to copy the link.

    Share panel

    • Current time range - Include the current time range in the link, so that users are shown the current data.
    • Template variables - Include template variables in the link.
    • Theme - Specify the dashboard theme to show.

Lagoon also gives you the ability to share an entire dashboard. Refer to the Dashboards documentation for more information.


Deleting a Panel

  1. Click the Panel Title, then select Remove.

    https://g.lagoon.soracom.io

    Remove panel

  2. Click the Remove button to confirm.