Configure Metrics Dashboards

This guide explains how to configure and manage Metrics Dashboards in WisDM, including projects, dashboards, widgets, metrics, filters, operations, layouts, and related management actions.

Only Organization Admins and Location Admins with access to the related locations can create and edit Metrics projects, dashboards, and widgets.

Create Your First Metrics Dashboard

This section walks you through the basic workflow of creating your first Metrics Dashboard in WisDM. In this example, you will create a Gateway Resource Dashboard to review CPU utilization for gateways in a selected location.

After completing this section, you will have a basic dashboard that shows a CPU utilization trend.

Item	Example Value
Project name	Apartment 1
Dashboard name	Gateway Resource Overview
Widget type	Line chart
Widget name	CPU Utilization Trend
Type	CPU and Memory Utilization
Metric	CPU Utilization
Operation	AVG
Filter label	Location = Apartment 1

Step 1: Create a Project

Create a project to group dashboards for the same site, customer, or monitoring scenario.

1. Go to Dashboard from the left navigation bar.
2. Click + Create Project.
3. Enter the project name, for example:

   Apartment 1 

4. Click Save.

The project appears as a project tab on the Dashboard page. For more details, see Create a New Project.

Step 2: Create a Dashboard

Create a dashboard under the project to organize widgets for gateway monitoring.

1. Open the project you created.
2. Click + Create dashboard.
3. Enter the dashboard name, for example:

   Gateway Resource Overview

4. Optionally, enter a dashboard description.
5. Click Save.

The dashboard appears under the selected project. For more details, see Create a New Dashboard.

Step 3: Add a Widget

Add a widget to display the CPU utilization metric.

1. Open the dashboard you created.
2. Click + Add widget.
3. Select + Create new.
4. Configure the widget details:
   • Widget type: Select Line chart.
   • Widget name: Enter CPU Utilization Trend.
   • Description: Optional.

For more widget configuration options, see Add a New Widget.

Step 4: Configure Metrics

In the Metrics to display section, configure the metric that the widget will show.

Use the following example settings:

Parameter	Example Value
Metric name	Average CPU Utilization
Type	CPU and Memory Utilization
Metric	CPU Utilization
Operation	AVG
Filter label	Location = Apartment 1

In this example, CPU Utilization is used to show CPU usage data that matches the selected filter and dashboard time range. The AVG operation calculates the average CPU utilization trend, and the Location filter limits the result to the selected site.

NOTE

For more guidance on metric meanings and recommended operations, see Metrics Reference.

Step 5: Retrieve and Save Metrics

1. Click Retrieve metrics to preview the metric result.
2. Check whether the returned data matches your expected gateway status.
3. If the result is correct, click Add widget to save the widget.

After the widget is saved, it appears on the dashboard.

NOTE

The retrieved result is based on the current dashboard time range. You can adjust the time range later from the dashboard toolbar.

Manage Projects

A project is used to group related dashboards together. You can create a project for a specific customer, site, deployment area, or use case. For example, you can create projects such as Apartment 1, Factory A, Warehouse Site, or City Deployment.

After creating a project, you can add one or more dashboards under it and configure widgets to monitor gateway metrics.

Create a New Project

1. Go to Dashboard from the left navigation bar.
2. Start creating a project.
   • If no project exists, click + Create Project.
   • If projects already exist, click the + button in the project tab area, and then select Create new project.
3. On the Create project page, enter the project name.
   • Project name: Required. Length: 1 to 50 characters. Can contain letters, numbers, and special characters.
     Example:

   Apartment 1

4. Click Save.

After the project is created, it appears as a project tab on the Dashboard page. You can then create dashboards under this project.

Copy an Existing Project

You can create a project by copying an existing project. This helps you reuse an existing dashboard structure instead of creating dashboards and widgets from scratch.

When a project is copied, the copied project includes the dashboards in the original project and their widget configurations, such as widget types, metric settings, filter labels, and layout.

NOTE

The copied project uses the same dashboard and widget configuration as the original project. After copying, update the project name, dashboard names, widget names, and filters as needed.

Duplicate a Specific Project

Use Duplicate project to quickly copy a specific project from the project tab area.

1. Locate the project you want to copy.
2. Click the action menu next to the project name.
3. Select Duplicate project.
4. The system creates a copy of the selected project in the current organization.

Make a Copy of Existing Projects

Use Make a copy of existing when you want to select one or more accessible projects and copy them.

1. Go to Dashboard from the left navigation bar.
2. Click the + button in the project tab area.
3. Select Make a copy of existing.
4. In the Select a project to create a copy dialog, select one or more projects.
5. Select the checkbox next to each project you want to copy.
6. Click Create.

The selected project or projects are copied into the current organization.

Edit a Project

Use Edit project to update the project name.

1. Go to Dashboard from the left navigation bar.
2. Locate the project you want to edit.
3. Click the action menu next to the project name.
4. Select Edit project.
5. Update the project name.
6. Click Save.

After saving, the updated project name is displayed in the project tab area.

Delete a Project

warning

Deleting a project cannot be undone. When a project is deleted, all dashboards and widgets under the project are also removed. Make sure the project and its dashboards are no longer needed before confirming the deletion.

Use Delete project to remove a project that is no longer needed.

1. Go to Dashboard from the left navigation bar.
2. Locate the project you want to delete.
3. Click the action menu next to the project name.
4. Select Delete project.
5. In the confirmation dialog, review the warning message.
6. Click Delete to confirm.

The project is deleted and removed from the project tab area.

Manage Dashboards

A dashboard is created under a project and is used to organize widgets for a specific monitoring purpose. For example, you can create dashboards for gateway status monitoring, resource usage monitoring, LoRaWAN® packet statistics, or cellular connectivity analysis. Each project can contain one or more dashboards.

Create a New Dashboard

Use Create dashboard to add a new dashboard under the selected project.

1. Go to Dashboard from the left navigation bar.
2. Open the project where you want to create a dashboard.
3. Start creating a dashboard.
   • If no dashboard exists under the selected project, click + Create dashboard.
   • If dashboards already exist under the selected project, click the + button in the dashboard tab area, and then select Create new dashboard.
4. On the Create dashboard page, enter the dashboard information.
   • Dashboard name: Required. Length: 1 to 100 characters. Can contain letters, numbers, and special characters.
   • Description: Optional. Length: Up to 500 characters. Can contain letters, numbers, and special characters.
5. Click Save.

After the dashboard is created, it appears as a dashboard tab under the selected project. You can then set the dashboard time range or add widgets to start visualizing metrics.

Copy an Existing Dashboard

You can create a dashboard by copying an existing dashboard. This helps you reuse an existing dashboard structure, including widgets, metric settings, filters, and layout.

Duplicate a Specific Dashboard

Use Duplicate dashboard when you want to quickly copy a specific dashboard.

1. Open the project that contains the dashboard.
2. Locate the dashboard you want to copy.
3. Open the dashboard action menu. You can do this from the dashboard list by clicking the action menu next to the dashboard name, or from inside the dashboard by clicking the action menu next to + Add widget.
4. Select Duplicate dashboard.

The system creates a copy of the selected dashboard under the current project.

Make a Copy of Existing Dashboards

Use Make a copy of existing when you want to select one or more existing dashboards and copy them into the current project.

1. Open the project where you want to copy dashboards.
2. Click the + button in the dashboard tab area.
3. Select Make a copy of existing.
4. In the Select a dashboard to create a copy dialog, select one or more dashboards.
5. Select the checkbox next to each dashboard you want to copy.
6. Click Create.

The selected dashboard or dashboards are copied into the current project with all existing widgets.

Set the Dashboard Time Range

The dashboard time range defines the time period used to retrieve and display metric data. The selected time range applies to all widgets on the current dashboard.

For example, if you select 7 days, all widgets on the dashboard display data from the last 7 days.

1. Open the project that contains the dashboard.
2. Open the dashboard you want to view or update.
3. Click the time range dropdown.
4. Select one of the available time options. Available options may include:
   • 24 hours: Data from now back to the last 24 hours
   • 7 days: Data from now back to the last 7 days
   • 30 days: Data from now back to the last 30 days
   • 90 days: Data from now back to the last 90 days
   • Custom: Defines a specific start date/time and end date/time for the dashboard. The selected range must be within the data retention period of your subscription, and the start time cannot be later than the end time.
     
     Available time range options depend on the subscription type.
     
     

     Subscription Type	Available Time Range Options	Maximum Data Retention
     Community	24 hours, 7 days, Custom	7 days
     Standard	24 hours, 7 days, 30 days, Custom	30 days
     Professional	24 hours, 7 days, 30 days, Custom	30 days
     Enterprise	24 hours, 7 days, 30 days, 90 days, Custom	90 days
     On demand	24 hours, 7 days, 30 days, 90 days, Custom	90 days

After the time range is updated, all widgets on the current dashboard are refreshed based on the selected time period.

Filter by Gateway Serial Number

The gateway serial number filter allows you to display dashboard data for specific gateways. The selected gateway serial number filter applies to all widgets on the current dashboard. By default, all gateway serial numbers are selected.

1. Open the project that contains the dashboard.
2. Open the dashboard you want to view or update.
3. Click the Select serial number dropdown.
4. Select one or more gateway serial numbers from the list. You can also type in the search field to quickly find matching gateway serial numbers.
5. Click Done to apply the filter.

After the filter is applied, all widgets on the current dashboard are refreshed based on the selected gateway serial number or set of gateways.

Edit a Dashboard

Use Edit dashboard to update the dashboard name or description.

1. Open the project that contains the dashboard.
2. Locate the dashboard you want to edit.
3. Click the action menu next to the dashboard name or the + Add widget button.
4. Select Edit dashboard.
5. Update the dashboard information.
   • Dashboard name: Required. Length: 1 to 100 characters. Can contain letters, numbers, and special characters.
   • Description: Optional. Length: Up to 500 characters. Can contain letters, numbers, and special characters.
6. Click Save.

After saving, the updated dashboard name or description is displayed in the project.

Manage Widget Layout

Use Edit layout to adjust the position and size of widgets on the current dashboard.

1. Open the dashboard you want to adjust.
2. Click the action menu next to the + Add widget button.
3. Select Edit layout.
4. Adjust the widgets as needed. You can:
   • Drag widgets to change their position.
   • Resize widgets to change how much space they use.
5. Click Save.

After saving, the updated layout is shown to users with access to the dashboard.

Delete a Dashboard

Use Delete to remove a dashboard that is no longer needed.

warning

Deleting a dashboard cannot be undone. Make sure the dashboard is no longer needed before confirming the deletion.

1. Open the project that contains the dashboard.
2. Locate the dashboard you want to delete.
3. Click the action menu next to the dashboard name or the + Add widget button.
4. Select Delete.
5. In the confirmation dialog, review the warning message.
6. Click Delete to confirm.

After deletion, the dashboard is removed from the current project.

Configure Widgets

A widget is a visual component on a dashboard. It displays one or more selected metrics using a specific visualization type, such as a single value, chart, or table.

Add a New Widget

Use Add widget to create a new widget on the current dashboard.

1. Open the project that contains the dashboard.
2. Open the dashboard where you want to add a widget.
3. Click + Add widget and select + Create new.
4. On the Add widget page, configure the widget details.
   • Widget type: Select how the metric data is displayed. For details, see Widget Types.
   • Widget name: Required. Enter the name displayed at the top of the widget. Length: 1 to 100 characters.
   • Description: Optional. Enter a short description. Length: Up to 500 characters.
   • Display legend: Enable this option to show the metric legend in the widget. This is useful when the widget contains multiple metrics.
   • Display threshold: Enable this option to show a threshold reference in the widget.
   • Threshold value: Required only when Display threshold is enabled. Enter an integer value using digits 0 to 9.
5. In the Metrics to display section, configure the metric information.
   • Color: Select the color used to display the metric in the widget. This option is available for chart widgets.
   • Metric name: Required. Enter the display name of the metric in the widget. Length: 1 to 100 characters.
   • Type: Select the metric group.
   • Metric: Select the specific metric to display. For details, see Metrics Reference.
   • Operation: Select how the metric value is calculated. For details, see Metric Operation.
6. Configure filter labels if needed.
   • Select a filter label, such as Location, Gateway serial number, or Firmware version.
   • Select an operator:
     • =: Includes data matching the selected value.
     • !=: Excludes data matching the selected value.
   • Select one or more values.
   • : Click this button to add another filter condition.
   • AND: Available when multiple filter conditions are added. The metric data must match all conditions.
   • OR: Available when multiple filter conditions are added. The metric data can match any of the conditions.
   • : Click this button to delete the selected filter condition. This button is available only when more than one filter condition exists.
   NOTE

   For supported filter types, operators, and usage guidance, see Metric Filters.

7. (Optional) For chart widgets, click + Add metric to add multiple metrics to the same widget. Configure the metric name, color, type, metric, operation, and filter labels for each added metric.
   • : Click this button to delete the selected metric section. This button is available only when more than one metric section exists.
8. Click Retrieve metrics to preview the result.
9. Click Add widget to save the widget.

After the widget is added, it appears on the current dashboard.

Copy an Existing Widget

You can create a widget by copying an existing widget. This helps you reuse an existing widget configuration, including widget type, metric settings, operation, filter labels, and display settings.

Duplicate a Specific Widget

Use Duplicate widget when you want to quickly copy a specific widget on the current dashboard.

1. Open the project that contains the dashboard.
2. Open the dashboard that contains the widget you want to copy.
3. Locate the widget you want to duplicate.
4. Click the action menu on the widget.
5. Select Duplicate widget.

The system creates a copy of the selected widget on the current dashboard.

Make a Copy of Existing Widgets

Use Make a copy of existing when you want to add a widget by reusing an existing widget configuration.

1. Open the project that contains the dashboard.
2. Open the dashboard where you want to add the widget.
3. Click + Add widget.
4. Select Make a copy of existing.
5. In the Select a widget to create a copy dialog, select one or more widgets.
6. Select the checkbox next to each widget you want to copy.
7. Click Create.

The copied widget is added to the current dashboard with the same configuration as the original widget. After copying, review and update the widget settings as needed.

Manage Widgets

Edit a Widget

Use Edit widget to update an existing widget, including its widget details, metric configuration, operation, filter labels, and display settings.

1. Open the project that contains the dashboard.
2. Open the dashboard that contains the widget you want to edit.
3. Locate the widget you want to update.
4. Click the action menu on the widget.
5. Select Edit widget.
6. Update the widget settings as needed.
   NOTE

   When editing a widget type, some options may become unavailable depending on the selected widget type or metric.

7. Click Retrieve metrics to preview the updated result.
8. Click Save to apply the changes.

After the widget is updated, the latest configuration is displayed on the dashboard.

Delete a Widget

Use Delete to remove a widget that is no longer needed.

warning

Deleting a widget cannot be undone. Make sure the widget is no longer needed before confirming the deletion.

1. Open the project that contains the dashboard.
2. Open the dashboard that contains the widget you want to delete.
3. Locate the widget you want to remove.
4. Click the action menu on the widget.
5. Select Delete.
6. In the confirmation dialog, review the warning message.
7. Click Delete to confirm.

After deletion, the widget is permanently removed from the dashboard.

Adjust Widget Layout and Size

Widget position and size are managed from the dashboard layout settings. For details, see Manage Widget Layout.