Dashboards

Use the Dashboards app to view visualisations and track metrics from a single or several entities. When you click on a widget or a panel in the dashboard, you can see more information.

On the Dashboards app, you can:

You can also create visualisations using Grafana.

Create a dashboard

To create a new dashboard:

  1. On the main page of the Dashboards app, click New. This opens the New dashboard window.
  2. Click to change the general settings.
  3. On the Dashboard name field, set the file name for the dashboard.
  4. On the Folder field, select which folder the dashboard will be saved in.
  5. To make the dashboard accessible to anyone in your organisation, tick the Is public? checkbox.
  6. To enable future changes to the dashboard, tick the Editable by default checkbox.
  7. Add panels to the dashboard. For details, see Add panels or widgets to a dashboard.
  8. Click Save.

Add panels or widgets to a dashboard

You can add a customisable panel or widget to your dashboard.

  1. While creating a new dashboard, click Add panel.
  2. On the Visualization drop-down list, select how you want the data to be presented visually. For details, see Work with charts.
  3. Under Configuration, set the query parameters for the data type. For details, see Use query filters.
  4. Under General settings, you can provide the panel name, specify the format, choose the chart style and layout, and more.
  5. Click Done.

Repeat the steps to add more panels to the dashboard.

Use query filters

You can filter data to quickly find what you are interested in.

  1. Under Data type, select whether to use Metrics or Logs.
  2. Depending on the data type, you can:
Data type Description
Metrics
  • Select the metric to be visualised under Metric Name. By default, metrics of all available attributes and dimensions are listed.
  • In the From field, select an attribute or dimension name and set conditions for your query. You will see a prompt to start the expression with {, followed by a list of available values. For more details, see Expressions.
Logs In the From field, select an attribute or dimension name and set conditions for your query. You will see a prompt to start the expression with {, followed by a list of available values. For more details, see Expressions.
  1. When needed, add another query by clicking . You can have both metrics and logs shown in the visualisation.

Work with charts

Charts convey a large amount of raw data and turn it into easy-to-understand visualisation. You can change between these chart styles by clicking the Visualization drop-down arrow:

Chart style Description
Graph Present data into commonly used charts (line chart by default).
Histogram Depict frequency distributions in bars of different lengths.
Timeline Plot data in a series of events.
Note: Aside from charts, there are several other visualisation styles for representing your data, such as KPI, Gauge, or Table.

You can change further customise how your charts look under General Settings.

Field Description Options
Format Define how metrics are displayed in charts. This ranges from data sizes (such as Bytes, Megabytes, Gigabytes, etc.), units of time (Seconds, Minutes, Days, etc.), currencies (GBP, USD, EUR, etc.), and more. Smart is used by default.
Number of decimals Select how many decimal points to use in the chart. 0 - 10
Limit Control the distribution used in the chart. Numeric value
Chart type Choose between the available chart types. This is available for Graph.
  • Linechart: best for plotting changes and fluctuations in values, such as during a period of time.
  • Barchart: opt for this to compare values through the length of bars.
  • Areachart: similar to a line chart, but the area under the line is filled in.
Chart layout Select how data in the chart is presented. This is available for Graph and Timeline.
  • Group: use to compare data in more than one category.
  • Stack: best for comparing parts of a whole since it shows data in a single bar.
Line thickness Set the thickness of the line used in the graph. This is available for Graph. 0 - 10
Line dash Set how many dashes there will be for lines in the graph. This is available for Graph. 0 - 50
Bins Choose how data is grouped into intervals. This is available for Histogram.
  • Time
  • Bins number
  • None
Color by Choose when to use colors in the chart. This is available for Timeline.
  • None
  • Threshold: changes color when the literal value is matched or the numeric value is equal to or higher than the breakpoint.
  • Severity: shows status indicators, either green (OK), orange (warning), or critical (red).
Animation Change the animation speed.
  • None
  • Fast
  • Slow

Create a dashboard from the Explore tab

Use the Explore tab as your starting point for searching and viewing data as well as trying out visualisations. If you want to save your work, you can also create a dashboard straight from the Explore tab.

  1. On the Explore tab, set the parameters for your query, including options for visualisation and general settings. Query parameters are set using an Expression.
  2. Click Save. This will open a new dashboard.
  3. Click Save.
  4. When prompted, provide the dashboard name and then click Save.

Import a dashboard

To import an existing dashboard:

  1. On the main page of the Dashboards app, click Import. This opens your file viewer.
  2. Select a compatible dashboard file to import.

Alternatively, you can drag and drop the dashboard file from your local machine into any folder in the Dashboards app.

When a dashboard file is imported successfully, the file is uploaded to Obcerv and the Created by field is assigned to the current user.

Share dashboard panels

Share any panel of dashboards you created or those that are publicly accessible to other users in your organisation.

  1. While viewing a dashboard, click beside the panel or widget that you want to share.
  2. Click Share. The URL to the dashboard panel will be copied to your clipboard.
  3. Send the link to other users so that they can view the dashboard panel.

Manage dashboards

On the main page of the Dashboards app, click beside each dashboard to see options such as exporting, copying, moving, or deleting it.

Permissions

Users with Operator roles can only edit and delete dashboards they created.

Users with administrator roles can manage any dashboard.

View dashboards

On the main page of the Dashboards app, click on a listed dashboard to open it. When viewing a dashboard, you will see widgets or panels that have been added to it. Each panel visualises data from one metric and can be further configured.

["Obcerv"] ["User Guide", "Video"]

Was this topic helpful?