Related Pages:

You can define a condition or a set of conditions to evaluate the performance metrics of your application.

Use the following options to evaluate the conditions:

Create a Condition

  1. In the Critical Condition or Warning Condition window, click + Add Condition to add a new condition component. A row defining the condition is displayed.
  2. Configure the Condition as required.
  3. Continue to add conditions as required. You can add a maximum of 8 conditions. Conditions are designated as A, B, C, and so on.
  4. From the drop-down list above the conditions, select:
  5. For health rules based on the following health rule types, select:

    You must specify the evaluation scope in the Critical Criteria and Warning Criteria panels.

    You can use Alert Sensitivity Tuning to configure health rule conditions for a business transaction, a service endpoint or a remote service only. You must set the health rule evaluation criteria to 'average of all nodes'. For more information, see Alert Sensitivity Tuning.

    If you select the percentage of nodes, enter the percentage. If you select the number of nodes, enter an absolute number.

Evaluating Serverless Tiers

When you monitor serverless entities comprising tiers for AWS Lambda, the health rules are evaluated as described below.

Health Rule TypeAffected EntitiesCondition Evaluation CriteriaEvaluation
  • Business transactions
  • Service endpoints
  • Error rates
serverless tier(s)The BT AverageMetrics are aggregated at the tier level.
serverless node(s)
  • Any node
  • % of the Nodes
  • Number of the Nodes
Metrics for serverless tiers are aggregated at the tier level, while the metrics for other tiers are evaluated as per the defined criteria.
Tier/Node Health (Transaction Performance)serverless tier(s)
  • The Tier Average (average for all Nodes in the Tier)
  • Any node
  • % of the Nodes
  • Number of the Nodes
Metrics for serverless tiers are aggregated at the tier level, regardless of the evaluation criteria defined.
serverless node(s)
  • The Tier Average (average for all Nodes in the Tier)
  • Any node
  • % of the Nodes
  • Number of the Nodes
The performance of serverless tiers is not evaluated for Tier/Node Health (Hardware) health rules. AWS does not offer node-level dashboards or metrics because the serverless platform runtime instances spin up and down on-demand.
Tier/Node Health (Hardware)
  • serverless tier(s)
  • serverless node(s)
-The performance of serverless tiers is not evaluated for Tier/Node Health (Hardware) health rules. AWS does not offer node-level dashboards or metrics because the serverless platform runtime instances spin up and down on-demand.

Configure a Condition

  1. In the first field of the condition row, enter a name for the condition.
    This name is used in the generated notification text and in the  console to identify the violation. 

    Ensure that you enter a unique name for each condition you define.

  2. From the drop-down list below the Add Condition button, define metrics to evaluate the condition, select:
  3. From the drop-down list after the metric, select the type of comparison to evaluate the metric.

  4. If you want to define a 'Persistence Threshold' for the condition to reduce false alerts: 

    1. Select 'Trigger only when a violation occurs __ times in the last __ min(s)'.

    2. Define the number of times metric performance data should exceed the defined threshold to constitute a violation.

    3. If required, adjust the evaluation time frame by setting an alternate evaluation time frame.

    You can define a persistence threshold for a condition only if you have defined an evaluation time frame of 30 minutes or less.

  5. If you want to control the health rule status when metric data is unavailable for evaluation, use one of following options for Evaluation for "no data" scenarios:
  6. Click Save when done. 

Evaluation of Agent Availability Metrics

Using Health Rule Conditions to evaluate agent availability metrics can result in false positives. For example:

You can configure the health rules such that you get notified of any occasional one-to-two minute metric loss due to network issues,  or when an agent fails to communicate to the controller Configure your Health Rule as follows:
  1. Select Nodes that the health rule affects. You can also set Tiers, however, it is recommended that you set Nodes.
  2. Select Node Health - Hardware, JVM, CLR as the health rule Type.
  3. Use the last five minutes, with a wait time of ten minutes.
  4. Set your condition to be the Sum of < Specific value of three.

This configuration generates a violation when the agent is down for more than two minutes during the last five minutes.

Health Rule Violation for Agent Availability Metrics

The purpose of the availability metrics is to check if the applications monitored by agents are available.

If an agent goes down due to any reasons, the controller does not get the status of the corresponding application.

If a health rule is created for an availability metric, the health rule violates when the agent is down, and an alert is generated. This is because the situation is considered as no data received from the source and health rule is evaluated. In such case, the health rule violation does not indicate that your application is down. You can ignore such alert and disable the health rule.

The option Evaluate to True on No Data does not have any impact on such health rules.

Build an expression

To access the expression builder to create a complex expression as the basis of a condition, select the Metric Expression option from the drop-down list and click Add Expression. The Metric Expression window is displayed that allows you to construct a mathematical expression to use as a metric. 

For example, the following expression is created to measure the percent of slow business transactions. See the screenshot that follows for the UI location where each step is performed. 

  1. In the Variable Declaration pane of the Mathematical Expression builder, click + Add variable to add a variable.
  2. In the Variable Name field enter a name for the variable.
  3. From the drop-down list, select the qualifier for the metric from the following options:

    Qualifier Type

    Description

    Minimum

    The minimum value reported across the configured evaluation time length. This qualifier is not available for all the metrics.

    Maximum

    The maximum value reported across the configured evaluation time length. This qualifier is not available for all the metrics.

    Value

    The arithmetic average of all metric values reported across the configured evaluation time length. This value is based on the type of the metric.

    If you select the time rollup as SUM for custom metrics, the Value is the arithmetic sum of all metric values reported across the configured evaluation time length.

    Sum

    The sum of all the metric values reported across the configured evaluation time length.

    Count

    The number of times the metric value has been measured across the configured evaluation time length.

    Group CountThe number of nodes contributing to a metric value, generally relevant for application or tier level metrics.

    Current

    The value for the current minute.

  4. Click Select a metric to open an embedded metric browser.

    A health rule is not evaluated if any metric in the expression has a null value. This is to avoid erroneous evaluations as shown in the following examples:

    ExpressionNull ValueEvaluation
    a-b-c
    a
    entire expression is evaluated negative
    a/bb
    the number 'a' is divided by zero, evaluates to an error
    a*b
    a or b
    entire expression is evaluated as zero
  5. Repeat steps 1 through 4 for each metric that you use in the expression.
    You can remove a variable by clicking the delete icon.
  6. In the Expression pane, build the expression by clicking Insert Variable to insert variables created in the Variable Declaration pane along with appropriate mathematical signs.
  7. When the expression is built, click Save.

Create a Custom Boolean Expression

Once you define all the conditions required for the health rule, you can create a custom boolean expression to evaluate the health rule.

  1. From the drop-down list above the conditions, select Custom option.
  2. Enter a combination of conditions using AND and/or OR operators. For example, (A OR B) AND C.

    Ensure that you enter a valid combination of conditions using AND and OR operators, else the evaluation fails.

  3. Click Save.

Modify the Custom Boolean Expression

  1. Select the expression in the Condition Combination field.
  2. Edit the boolean expression as required.
  3. Click Save.

Delete a condition

Delete a condition component by clicking the delete (X) icon.

If you delete a condition, update the boolean expression accordingly.