Compound metrics in alerts

Applies to NAM 2018

When creating a NAM alert, you can define a compound metric that is calculated based on other metrics.

For example, you could select Client TCP data packets and Server TCP data packets, and then define a compound metric called Client and Server TCP data packets as the sum of the client and server metrics. You can then trigger your alert based on the calculated result (the compound metric). Let's walk through a definition for that alert.

  1. Open the Alert configuration wizard to edit or create an alert, define the basic settings, and click Next.

  2. On the Triggering and propagation page, in the Dimensions section, set a dimension such as Analyzer with a filter type of http.

  3. In the Metrics section, add the Client TCP data packets and Server TCP data packets metrics.

    • Click Add metric to add a metric row as needed.
    • Select a metric from the Metric list for that row.
  4. Click Add compound metric
    The Add compound metric edit box is displayed.

  5. Give the compound metric a name. In this example, we are using Client and Server TCP data packets.

  6. Click in the edit box, press Ctrl+Shift to list available metrics, and select Client TCP data packets.

  7. Type the operator for your calculation, which in this case is +.

  8. Press Ctrl+Shift again and select Server TCP data packets.
    Now you have the expression <Client TCP data packets> + <Server TCP data packets> displayed in the edit box.

    Note

    You do not need to select metrics from the list if you know the syntax and the exact names of the available metrics. You can instead type the metric names (enclosed in < and > brackets) and the operator (+ in this example), but the lists will help you to avoid errors.

  9. Click Save.
    The new compound metric is listed in the Metrics section of your alert definition.

  10. Add a relevant Filter to the alert.
    For example, in the row for your new Client and Server TCP data packets compound metric, set Type to Value and Filter to <10 to trigger the alert if the value of your compound metric is calculated to be less than 10.

  11. Click Next to go to the Notifications page, where a basic notification is already defined for you.

  12. Click in the edit box to type any additional explanation needed to understand the alert.
    For example, add a line to the notification text, press Ctrl+Shift to list available metrics, select your new compound metric, and then type is less than 10. The line should look like:
    <Client and Server TCP data packets> is less than 10.

  13. If you have a recipient for the alert, select the recipient in the Alert recipients section.

  14. Click Next to review the summary.
    The Triggering and propagation section describes the conditions under which the alert will be sent. In this example, it should tell you that the alert will be raised when "Client and Server TCP data packets ( + ) metric value <10".

  15. Click Finish to save the alert.