Skip to main content
Documentation - HPE Usage and Analytics

Creating SmartTags for showback reporting

In a typical showback scenario, as a customer using HPE GreenLake resources, you want a breakdown of resource cost by unique identifier - for example, the cost of your devices or components by department or division (business unit). 

If your data collection doesn't tag resources to your business units, and you can't add a tag to map resources to your business units, you can use the Lookup tables and SmartTags  features in HPE Consumption Analytics to enable showback. 

In the previous step, you created a lookup table to define the relationship of your resources to your business units.  This page will walk you through creating a SmartTags rule for showback reporting, and running your SmartTag rule on your dataset, based on the showback scenario described above.

This article covers this step in the showback process:

CAP_showback_step7.png

See Working with showback for HPE GreenLake services for the full process chart and context.

Creating SmartTags rules

The HPE Consumption Analytics platform features a wizard to guide you through the three steps to create a SmartTags rule:

  1. Adding a rule to a data collection
  2. Defining the conditions that will trigger the rule - for each condition, you select one or more fields in your collected data, and define how HPE Consumption Analytics portal should search those fields to find a match. 
  3. Specifying actions the rule will perform on the data - for each action, you select one or more fields to be modified when the action is triggered.

The following steps will walk you through creating SmartTags rules to tag your resources to your business units for showback.

Adding a rule

The first step is to add a SmartTags rule for the appropriate data collection.

To add a rule

  1. Click SmartTags in the left navigation.
    The SmartTags page shows your collections, the SmartTags rules defined for each collection, and a rules preview table that enables you to see the effect of rules on your collected data:
    CAP_smarttags_main.PNG

  2. Click the arrow at left to expand the collection you want to maintain. 
  3. Click Add New Rule at right, above the rules preview table. 
  4. In the selection list, click the position where you want the rule to appear in the list: Before Selected Item, After Selected Item, or Add to End of List.
    The Create Rule wizard displays: 
    CAP_smarttags_rule_cond.PNG
    For each rule, you'll define one or more conditions and one or more actions.

    HPE Consumption Analytics portal runs rules in the order they are listed in the table, top-to-bottom.

    When you select a rule, the table will update to show you the cumulative effect of that rule and its preceding rules.

Defining conditions

The next step is to define the conditions that will trigger your rule.

If you don't specify a condition, the rule is triggered for every row in your dataset.  To select specific rows in your data, define one or more conditions for your rule.

To define conditions for your rule

On the Conditions page of the wizard, define one more conditions for the rule (or click Next to skip the condition, and proceed to specify an action).

For each condition, select one or more fields in your collected data, then define how HPE Consumption Analytics platform should search those fields to find a match.  

  1. Under Select Conditions, select a condition type (Field found in lookup is shown here).
    The detail overlay displays:
    CAP_smarttags_rule_cond_overlay.PNG

  2. Specify details for the condition.
  3. To add another field as part of this condition, click + Add New, and enter the required information for that field.
  4. If you defined multiple fields for this condition, toggle Match between Any and All to define whether either 'any' fields or 'all' fields you defined must be met to trigger the condition. 
  5. Click OK to add your condition to the rule summary box.
  6. Repeat this procedure for any other conditions you want to add.
  7. Click Next.
    The Actions page of the wizard displays:
    CAP_smarttags_rule_action.PNG

 

As you build a rule, the Create Rule wizard shows a textual representation of that rule.

Also, the Rule Preview section at the bottom of the wizard updates when you click Next, so you can see the impact of the rule before activating it.

For more details on the Field lookup match condition type, see Field found in lookup

If you need more details about condition types and how to define conditions, see Conditions in SmartTags rules.

Specifying actions 

The last step is to specify the actions the rule will perform on your dataset.

To specify actions for your rule

On the Actions page of the wizard:

  1. Under Select Actions, select an action type (Set field from lookup is shown here).
    The detail overlay displays:
    CAP_smarttags_rule_action_overlay.PNG

  2. Specify details for the action.
  3. Click OK to add your action to the rule summary box.
  4. Repeat this procedure for any other actions you want to add.
  5. Click Next.
    The Name page of the wizard displays:
    CAP_smarttags_rule_name.PNG

  6. On the Name page, enter a Name for the rule.
  7. Toggle Rule Status between Active and Inactive to either run or skip the rule when you run rules.

    Setting to Active allows your rule to be in effect for future data, to reflect your SmartTag settings.

    If you need to change the position of a rule in the list, you can drag and drop it to the desired position.

  8. Click Save to add the rule to the list of rules defined for the collection.

For more details on the Lookup field value action type, see Set field from lookup.

If you need more details about actions and how to define them, see Actions in SmartTags rules.  

For showback, the next step is to Run Rules Now

Running SmartTags rules

HPE Consumption Analytics portal will run your rules automatically after the next nightly collection. When this happens, historical data remains unchanged. If you want to apply your rules to historical data, use the Run Rules Now function.

You need at least one rule to activate SmartTags. 

HPE Consumption Analytics portal runs rules in the order they are listed in the table, top-to-bottom.

When you select a rule, the rules preview table updates to show you the cumulative effect of that rule and its preceding rules.

CAP_smarttags_main.PNG

To run rules now

  1. Click the ellipsis next to the collection with the rules you want to run, and select Run Rules Now.
    The Run Rules dialog displays:
    CAP_smarttags_rule_run_popup.PNG

  2. Select the Start Date and End Date for the span historical data you want to modify with your rules.
  3. Click Run.
    HPE Consumption Analytics portal immediately begins transforming your historical data according to your rules.

Enabling and disabling all SmartTags rules for a collection

If you want to enable or disable all SmartTags rules for a collection, you can toggle that option directly on the SmartTags page.

To enable/disable all SmartTags rules for a collection

  1. Click the ellipsis next to the collection with the SmartTags rules you want to enable or disable.
  2. Select Toggle Status.

Editing and deleting rules

You can edit or delete a SmartTags rule for a collection.

To edit or delete a rule

  1. Select the rule you want to edit or delete.
  2. Do one of the following:
     
    If you want to... Do this
    Edit the rule
    1. Click the Edit icon to display the Edit Rules wizard.
    2. Select the condition or action you want to edit.
    3. Enter your changes and click Save.
    Activate or deactivate the rule Click the Activate/Deactivate button to toggle between these states.
    Delete the rule
    1. Click the trash can icon.
    2. Click Delete to delete the rule.

Next step

Once you've completed this step, continue to the next article in the process path below.

Click + to expand, - to collapse: