Track Asset Metrics in the Map View

Use the KPI ribbon to track cumulative metrics or key performance indicators (KPIs) for assets appearing in the Map view. You can search for a place or zoom into a location in the map to see cumulative statistics for the location.

The KPI ribbon in the Oracle IoT Asset Monitoring Cloud Service Map lets you track key metrics for your monitored assets, such as located assets, assets connected, assets available, assets utilization, and open incidents.

The following system metrics or KPIs appear in the KPI ribbon, by default:

• Located Assets: Shows the number of assets located in the current view. This number may increase, as you zoom out to include more places. The number may decrease, as you zoom into the assets belonging to a specific place.

• Assets Connected:Shows the percentage of connected assets in the current view. An asset counts as connected if the application has heard from the asset sensors in the last one hour.

• Asset Utilization:Shows the percentage of utilized assets in the current view. An asset counts as utilized if the asset is not present in its assigned storage place.

• Asset Availability:Shows the percentage of available assets in the current view. An asset counts as available if there are no open outage incidents reported for the asset.

• Open Incidents: Shows the number of open, or unresolved, incidents for assets in the current view. Incidents help flag issues, such as outages, for the maintenance staff to work on.

The system metrics are based on live data. A live metric value is refreshed every two minutes.

If you have created user-defined metrics for your environment, you can add these to the KPI ribbon to display the metric values aggregated over the assets that appear in the map. See Define Your Own Metrics for more information on creating user-defined metrics to track asset data relevant to your business processes.

The KPI ribbon in the map view can show a maximum of five metrics. If you wish to add a user-defined metric, you will need to remove a pre-existing metric and add the new metric.

Access the Map View Metrics

Switch to the Map view to track the metrics or key performance indicators (KPIs) for the assets located in the map.

In the Operations Center, click Map () in the menu bar.

The system metrics, and any added user-defined metrics, appear in the KPI ribbon below the map.

Add a Metric to the Map View

Add a metric or Key Performance Indicator (KPI) to the Dashboard to display aggregated metric data across applicable assets.

1. Click the Menu () icon, and then click Map.
2. Click the Configure Metrics () icon in the KPI ribbon below the map.
3. Click the Add Metric () icon.
   If you already have five KPIs in the KPI ribbon, you would need to remove a KPI before you can add a new one on the KPI ribbon.
4. Under Type, select Metrics or Sensor Attributes.
   If you are adding a user-defined metric, you must have created the metric before adding it to the Dashboard. See Define Your Own Metrics for more information on creating user-defined metrics.
5. Select the corresponding Metric or Sensor Attribute.
6. Select the Aggregation for your metric.
   The aggregation is performed across all assets of the metric asset type.
   For example, you may want to calculate the average of the temperature metric across your temperature sensors. Alternatively, you may want to display the maximum temperature amongst all your temperature sensors.
7. Select a Label for your KPI ribbon metric. The default label uses the name of the metric that you selected.
   The Label can be different from the metric name. For example, if you are aggregating the maximum temperature across assets, you may use Maximum Temperature to highlight this fact.
8. (Optional) Specify an optional Unit to display against the metric value.
   For example, if the metric measures the pressure in pounds per square inch, you may want to use psi.
9. Select a Color for your KPI ribbon metric.
10. Select an appropriate display type for your metric.
11. Click OK to add the metric to the KPI ribbon.
12. Click Save to save the KPI ribbon changes.

Edit a Metric in the Map View

Edit a metric that appears in the KPI ribbon to change its aggregation settings, label, or appearance.

1. Click the Menu () icon, and then click Map.
2. Click the Configure Metrics () icon.
3. Click the Edit () icon for the metric you want to edit.
4. Edit the available metric settings like aggregation, label, unit, color, and appearance.
   The aggregation is performed across all visible assets of the metric asset type.
   For example, you may want to calculate the average of the temperature metric across temperature sensors visible in the map. Alternatively, you may want to display the maximum temperature amongst the temperature sensors visible in the map.
   The Label can be different from the metric name. For example, if you are aggregating the maximum temperature across assets, you may use Maximum Temperature to highlight this fact.
5. Click OK.
6. Click Save to save your KPI ribbon changes.

Change the Location of a Metric in the KPI Ribbon

Change the location of a metric or Key Performance Indicator (KPI) in the KPI ribbon, so the metrics appear in the order you require.

1. Click the Menu () icon, and then click Map.
2. Click the Configure Metrics () icon in the KPI ribbon below the map.
3. Click and drag a KPI, using the Handle (), to a new location on the ribbon.
4. Click Save.

Remove a Metric from the Map View

Remove a metric or Key Performance Indicator (KPI) from the map view when it is no longer required, or when you want to make space for a new metric.

1. Click the Menu () icon, and then click Map.
2. Click the Configure Metrics () icon in the KPI ribbon below the map.
3. Click the Delete () icon for the metric that you want to remove from the map view.
4. Click Save to save your KPI ribbon changes.