Analytics Configuration

About Analytics Configuration

Configuration allows the user to define existing asset model attributes to use in asset filters.

The Analytics Configuration module allows you to view, add, modify, or delete attributes that are used in existing asset filters. You need special access permission to add, modify, or delete existing asset model attributes to the analytics configuration. You cannot modify or delete attributes configuration that have been used in an asset filter.

Important: You can only use system attributes and custom attributes that have been previously ingested into your tenant's asset model. Using non-existing model attributes in your configuration will not add them to the asset model, nor will they show up for use in the asset filters as they do not exist.

What is Analytics Configuration?

During asset filter creation or modification, you can apply rules to define asset applicability based on certain attributes. You should not define attributes that do not exist in your tenant's asset model. For example, you can define filter assets with all 7FA frame sizes except for assets with 7FA.05 as its Equipment Code. In the context of asset filter, you can add rules to define the key value pairs for these attributes. In this case, the rule with the IS operator can be applied to the attributes Frame Size and Equipment Code that have values 7FA and 7FA.05 respectively.

The Analytics Configuration module maintains the attributes configuration used in the asset filter rules. The rules are then used for retrieving results from the Predix Essentials Asset Model. Example 1 below, shows a rule that can be defined in the Asset section of the asset filter. This filter criteria Asset Type is GE90, where Asset Type is an Attribute and GE90 is the Value. Asset Type is an Attribute that must be defined within the Analytics Configuration in order to be used within an Asset Filter.

Example 1:

Return assets where 
Asset Type is GE90
Note: Attributes defined within the Analytics Configuration must be identical to the attributes defined within the Predix Essentials Asset Model.

There are currently five columns present within the Configuration:

  • Asset
  • Segment
  • Site
  • Enterprise
  • Custom Attributes
    Important: Using custom attributes in asset filters is only available for tenants that have the feature enabled in the analytic_tenant_config table during tenant provisioning. Contact your tenant or system administrator if you want to configure asset filters with custom attributes.

Asset, Segment, Site, and Enterprise align with the asset business hierarchy in the Predix Essentials Asset Model. The Custom Attributes column maintains attributes that are not linked to the asset business hierarchy. However, these attributes must be defined as part of your ingested asset model before using them in the Analytics Configuration.

Add Asset Filter Attributes

You can add asset filter attributes that are used to apply operational rules during analytic deployment for each analytic level.

About This Task

The analytic levels are consistent with the asset model and include:
  • Asset
  • Segment
  • Site
  • Enterprise

You can create an asset filter that contains specified attributes and their values. You can use asset filters during asset selection in deployment to determine the assets needed to deploy the analytic.

Procedure

  1. In the module navigation menu, navigate to Analytics > Configuration.
  2. Select + Filter Attribute button in the desired level to add the attribute.
  3. Enter the attribute name.
  4. Select the blue check mark when finished to save your changes.

    The new attribute is saved and becomes available within the Configuration.

Modify Asset Filter Attributes

You can modify asset filter attributes that are used to apply operational rules during analytic deployment for each analytic level.

About This Task

The analytic levels are consistent with the asset model and include:
  • Asset
  • Segment
  • Site
  • Enterprise

You can modify the asset filter attributes and their values. You can use the configuration to filter assets during asset selection in deployment to determine the assets and attributes needed to deploy the analytic.

Procedure

  1. In the module navigation menu, navigate to Analytics > Configuration.
  2. Select the attribute to modify.
  3. Make necessary modifications to the attribute
  4. Select the blue check mark when finished to save your changes.

    The modifications are saved in the Configuration.