Composite Metrics

A Composite Metric is a new, higher-level metric expression in Anodot based on your current metrics to which you apply arbitrary, specified mathematical transformation functions. A user-defined composite metric can be used and searched like an other metric when creating metric expressions anywhere in the system. Therefore they can be used when creating Dashboard charts and metrics, creating other metric expressions in the Metrics window in Alerts and in defining anomalies. 

In this article you will learn about:

Creating composite metrics 
Saving composite metrics 
Composite management 
Composite metric definition 
Setting a composite metric delay 
Duplicating composite metrics 
Deleting composite metrics

CREATING COMPOSITE METRICS

You can create composite metrics by navigating from the main Navigation panel to:

• Metrics [Save > Save as Composite Metric]
• Alerts [Alerts > New Alert]
• Composite Management [Management > Composite Management > New]

The procedure to create composite metrics is the same in all cases. Use the Metrics workspace in each of the windows to try out, explore and build combinations of functions, parameters and filters before saving the composite metric.  

Composite metrics must have:

• At least one wrapper function - a function, filter, or transformation applied to base metrics to create a composite metric.
• One or more property filters – One or more filters for refining the base metrics included in the composite.

Limitations
· Creating new composite metrics with existing ones is not supported.
· The definition of existing composite metrics cannot be changed. To make changes, duplicate it, make the changes and save under a new name.  

To create Metric Expressions, see Metric Expressions.

SAVING COMPOSITE METRICS

1. Create a composite metric.
2. Click Save > Save as Composite Metric. The Save Composite dialog box is displayed.
   
   Note: Save as Composite Metric is enabled only if the metric expression meets the requirements of a composite metric.
3. Enter a unique title in the Title field.
4. In the What are you measuring (what=) field either leave as-is [by default the name  entered in the Title field] or enter a more meaningful name of what is being measured. [Displayed only if 'what' is selected in the metric's panel].
5. To include Additional Properties, click More Details. You can select from the proposed additional common properties of the functions displayed and/or type  new properties. [Optional]
   
6. Click OK to validate the composite metric.
   Note: Each metric name is displayed on a separate line; hovering over the metrics will display the complete composite name.

COMPOSITE MANAGEMENT 

To view a complete list of the composite metrics, from the main Navigation panel, click Management > Composite Management.

Count is the total number of composite metrics displayed. If you have filtered the composites either by text or by owner the Count will show the number displayed out of the total number of composites.

Indicates that the composite delay has changed. Hover over the icon to display a tooltip  showing the percentage by which the delay has changed.

Indicates invalid or no data.

COMPOSITE METRIC DEFINITION

To view  composite metric definition

1.  On the main Navigation panel, click Management > Composite Management. 
2. Select the Composite metric for which you want to see the definition. The Management Panel is displayed, showing the
    - Owner of the composite
    - total metrics count for the selected composite metric
   
   Note,
    - Hover over a metric to display the complete metric definition 
    - If there is an error in the Composite metric, the cause is displayed in the panel.
   
   3. Click the View icon, to display the View Composite Metrics window.

SETTING A COMPOSITE METRIC DELAY

By default the delays in computing composite metrics are computed at the account level based on Anodot's information of the input metrics' delay. You can override the default and set delays per composite -  this avoids either very long delays which would allow all the composites to be calculated or shorter delays but with the result that the composites are not calculated accurately.

To set a delay

1. On the main Navigation panel, click Management > Composite Management. 
   Note: If the composite to which you want to add the delay already exists, skip to step 4.
2. Create a new composite metric, see Creating Composite Metrics. 
3. In the Composite Management window, choose the composite for which you want to set the delay. The Composite Management panel is displayed.
4. Click the More icon to display the Composite Delay dialog box.
   
   
   
5. The default is for Auto calculated delay enabled to be active. Anodot will automatically calculate the percentage of data points received and the corresponding wait-delay time.
   To override the default calculated delay:
   i.   Disable Auto calculated delay enabled.
   ii.  Select a Time unit [seconds/minutes/hours].
   iii.  Type a value in the Change delay time field.  
6. Click OK.

DUPLICATING COMPOSITE METRICS

1. On the main Navigation panel, click Management > Composite Management. 
2. Select the Composite metric which you want to duplicate. The Management Panel is displayed.
3. Click the Duplicate icon to display the Duplicate Composite Definition window.
4. Modify the Composite Metric.
5. Click Save. In the Save Composite dialog box, set the 'What' property for the generated metrics.
6. Click OK. The duplicated metric is validated and then displayed in the Composite Management window.

DELETING COMPOSITE METRICS

1.  On the main Navigation panel, click Management > Composite Management. 
2. Select the Composite metric which you want to delete. The Management Panel is displayed.
3. Click the Delete icon.
   Note: Deleting a Composite Metric may affect Dashboards and Alerts.