Use Duration Tracker Metrics

Duration tracker metrics let you track asset state durations based on the conditions that you specify. Your conditions can use the asset location, sensor attribute values, dynamic attribute values, and other asset metrics.

For example, your supply chain flow may require you to track the duration that a mobile asset spends in the warehouse. Or you may want to track the amount of time that a cold storage unit door is left open. Manufacturing scenarios may require you to track the duration of time for which sensor attribute values remain out of range.

Like other metrics, you can add duration tracker metrics to your organization and asset dashboards. You can also use duration tracker metrics in your rule conditions to generate incidents, warnings, or alerts if the threshold duration is violated.

Create a Duration Tracker Metric

The metric editor can be used to create a duration tracker metric for one or more assets of an asset type.

  1. Click Menu (Menu icon), and then click Design Center.
  2. Select Asset Types from the Design Center sub-menu.
  3. Select an asset type from the Asset Types list.
    You can also search for an asset type.
  4. Click Metrics.
  5. Click Create Metric Add icon.
  6. Enter a Name to identify the new metric.
  7. Select Duration Based under Metric Type.
  8. (Optional) Select a value under Keep Metric Data For.
    If you have unique storage requirements for historical data related to this metric, you can select an option that is different from the global settings defined under Storage Management on the application Settings page.
    For example, if you are calculating frequent metrics across a large number of assets, and the metric data is not required beyond a week, then you can select 7 Days under Keep Metric Data For to optimize storage.
  9. Select a Mode for the duration based metric:
    • Live: The time duration for which the metric conditions are currently being met. If the metric conditions are currently not met, then the Live value is zero.
    • Last: The time duration for which the metric conditions were last met.

      When the metric conditions go from currently being met to currently not being met, the value of Live is transferred to Last, and the Live value becomes zero.

    • Cumulative: The total time duration of all occurrences when the metric conditions were met.

      If you select Cumulative, you also need to select a Time Window. The cumulative occurrences are tracked over the Time Window you select. For example, if you select Weekly, then the total time duration of all occurrences over the past week is tracked.

    You can select more than one mode if required.
  10. Under Target, select All Assets of Type: AssetType to calculate the metric for each asset of the asset type. Alternatively, select Specific Assets of Type: AssetType and select one or more assets that you wish to monitor.
  11. Under Conditions, create one or more conditions.
    You can create location conditions based on whether an asset enters or exits a location. You can also create threshold conditions based on whether a sensor attribute, or pre-existing metric, exceeds a set threshold. You can create threshold conditions for dynamic attributes, too.
    To create a location condition:
    1. Select Location from the drop-down list.
    2. Select Entered or Exited in the second drop-down list:
    3. Select the location in the third list.
      The location is the name of a predefined place that you must have previously created in the application.
    To create a threshold condition:
    1. Select an asset sensor attribute or existing metric from the drop-down list.
    2. Select a threshold condition for the attribute in the second drop-down list.

      For example, a numeric attribute specifies conditions like Greater Than and Less Than.

    3. Specify an attribute value in the third field.

      For example, a complete condition may look like: maxtemp Greater Than 50.

      A complete condition that uses a system metric may look like: sys_openIncidents Greater Than 5.

  12. (Optional) Add additional conditions, as required.
  13. In the Fulfillment section, select an option for the Fulfill when field:
    • All Conditions Apply : Select this option to track the duration when all the conditions are met.

    • Any Conditions Apply: Select this option to track the duration when any of the conditions are met.

    Duration Based Metric: Described in Text

    The preceding example shows the metric editor for a duration-based metric that uses multiple conditions. The duration is tracked when the forklift is inside the warehouse and the forklift fuel level is less than 20.

    The following example shows the metric editor for a duration-based metric that uses a dynamic attribute condition. The metric tracks the duration for which an asset remains in maintenance.

    Duration Based Metric with Dynamic Attribute: Described in Text

  14. Click Save to create the metric.
You can next add the newly created metric to your dashboards, or use the metric in rule conditions.