This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.

Skip to end of metadata
Go to start of metadata

This topic describes the detailed steps for configuring health rules using the health rule wizard. For more information about what these settings mean see Health Rules.

Access the Health Rule Wizard

  1. Click Alert & Respond in the menu bar.
  2. Click Health Rules either in the right panel or the left navigation pane.
  3. Select the context for the health rule from the pulldown menu.
  4. Do one of the following:
    • To create a new health rule, click the + icon.
    • To edit an existing health rule, select the health rule and click the Edit (pencil) icon.
    • To remove an existing health rule, select the health rule and click the Delete (-) icon.

Structure of the Health Rule Wizard

The health rule wizard contains four panels:

  • Overview: Sets the health rule name, enabled status, health rule type, health rule enabled period, and health rule evaluation time.
  • Affects: Sets the entities evaluated by the health rule. The options presented vary according to the health rule type set in the Overview panel.
  • Critical Condition: Sets the conditions, whether all or any of the conditions need to be true for a health rule violation to exist, and the evaluation scope (business transaction and node health policies defined at the tier level only); it also includes an expression builder to create complex expressions containing multiple metrics.
  • Warning Condition: Settings are identical to Critical Condition, but configured separately.

You can navigate among these panels using the Back and Next buttons at the bottom of each panel or by clicking their entries in the left panel of the wizard. You should configure the panels in order, because the configuration of the health rule type in the Overview panel determines the available affected entities in the Affects panel as well as the available metrics in the Condition panels.

Use the Health Rules Wizard

This section describes the procedure for creating health rules of one of the standard types.

Configure Generic Heath Rule Settings

You configure generic settings in the Overview panel.

  1. Enter a name. If a name already exists, you can change it.
  2. Check Enabled to enable the rule, clear the check box to disable it.
  3. Select a health rule type by clicking the name in the list.
    This setting affects metrics offered for configuration in subsequent panels in the wizard, so you must select a health rule type before continuing to other panels.
  4. If the health rule is always (24/7) enabled, check the Always check box.
    If the health rule is enabled only at certain times, clear the Always check box and either:
    1. Select a predefined time interval from the During these times drop-down menu
    2. Click +
      See To Create a New Health Rule Schedule below.

  5. Click the dropdown menu Use the last <> minutes of data and select a value between 1 and 360 minutes for the evaluation window. This is the amount of recent data to use to determine whether a health rule violation exists. This value applies to both critical and warning conditions. See Health Rule Evaluation Window.

  6.  In the Wait Time after Violation section, enter the number of minutes to wait before evaluating the rule again for the same affected entity in which the violation occurred. See Health Rule Wait Time After Violation.

  7. Save your configuration.

Create a Health Rule Schedule

  1.  In the Overview window of the Health Wizard, clear the Always check box if it is checked.
  2. Click + to the right of the During these times dropdown list.
     Enter a name for the schedule.
  3. Enter an optional description of the schedule.
  4. Enter the start and end times for the schedule as cron expressions. For example, the following custom schedule specifies a start time value of "* * 13 ? * 2-6" and end time of "* * 15 ? * 2-6", directing the health rule to be evaluated from 1pm to 3pm, Monday through Friday:

    For additional examples, you can select a built-in schedule from the During these times menu and click the View Schedule icon () to see the cron expression that makes up the built-in schedule. The Controller cron expression format is based on Quartz Scheduler cron expressions, so for more information, see the Quartz Scheduler documentation.
  5. Save your configuration.

After creating new health rule schedule, delete it by choosing it in the During these times menu and clicking the minus icon to the right of the menu. 

Configure Affected Entities

The Affects panel lets you define what your health rule affects. The choices you are offered depends on the health rule type you chose in the Overview panel. To use the panel: 

  1. Use the dropdown menu to select the the entities affected by this health rule.
    The entity affected and the choices presented in the menu depend on the health rule type configured in the Overview window.
    See Entities Affected by a Health Rule for information about the types of entities that can be affected by the various health rule types.
  2. If you select entities based on matching criteria, specify the matching criteria.
    For nodes, you can restrict the node on criteria such as meta-info, environment variables, and JVM system environment properties. Meta-info includes key value pairs for:
    • key: supportsDevMode
    • key:ProcessID
    • key: appdynamics.ip.addresses
    • any key passed to the agent in the appdynamics.agent.node.metainfo system property
  3. If you are configuring a JMX health rule, select the JMX objects that the health rule is evaluated on. See JMX Health Rules.

Configure Health Rule Conditions

The high-level process for configuring conditions is:

  1. Determine the number and kind of metrics the health rule should evaluate. For each performance metric you want to use, create a condition.
    1. You can use a single condition component or multiple condition components for a single condition state. 
    2. You can use values based on complex mathematical expressions.
  2. Decide whether the health rule is violated if all of the tests are true or if any single test is true.
  3. For business transaction performance health rules and node health rule types that specify affected entities at the tier level, decide how many of the nodes must be violating the health rule to produce a violation event. See Health Rule Evaluation Scope.
  4. To configure a critical condition use the Critical Condition window. To configure a warning condition use the Warning Condition window.

The configuration processes for critical and warning conditions are identical.

You can copy the settings between Critical and Warning condition panels and just edit the fields you desire. For example, if you have already defined a critical condition and you want to create a warning condition that is similar, in the Warning Condition window click  Copy from Critical Condition to populate the fields with settings from the Critical condition.

To Create a Condition:
  1. In the Critical Condition or Warning Condition window, click + Add Condition to add a new condition component.
    The row defining the component opens. See To Configure a Condition Component. Continue to add components to the condition as needed.
  2. From the drop-down menu above the components, select All if all of the components must evaluate to true to constitute violation of the rule. Select Any if a health rule violation exists if any single component is true.
  3. For health rules based on the following health rule types:
    1. business transaction 
    2. node health-hardware
    3. node health-transaction performance 
    you must specify evaluation scope:

  4.  If the Health Rule will violate if the conditions above evaluate to true section is visible, click the appropriate radio button to set the evaluation scope.

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

To Configure a Condition Component: 
  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 AppDynamics console to identify the violation.
  2. To select the metric on which the condition is based, do one of the following:
    1. To specify a simple metric, click the metric icon to open a small metric browser and select Specify a Metric from the Metric Tree.
      The browser display metrics appropriate to the health rule type. Select the metric to monitor and click Select Metric.
    2. To build an expression using multiple metric values, click the gear icon at the end of the row and select Use a mathematical expression of 2 or more metric values.
      This opens the mathematical expression builder where you can construct the expression to use as the metric.

      To Build an Expression for details on how to do this.
  3. From the Value drop-down menu before the metric, select the qualifier to apply to the metric from the following options:

    Qualifier Type

    What This Means


    The minimum value reported across the configured evaluation time length. Not all metrics have this type.


    The maximum value reported across the configured evaluation time length.  Not all metrics have this type.


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


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


    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.


    The value for the current minute.

    4. From the drop-down menu after the metric, select the type of comparison by which the metric is evaluated.

    1. To limit the effect of the health rule to conditions during which the metric is within a defined distance (standard deviations or percentages) from the baseline, select Within Baseline from the menu. To limit the effect of the health rule to when the metric is not within that defined distance, select Not Within Baseline. Then select the baseline to use, the numeric qualifier of the unit of evaluation and the unit of evaluation. For example:

      Within Baseline of the Default Baseline by 3 Baseline Standard Deviations
    2. To compare the metric with a static literal value, select < Specific value or > Specific Value from the menu, then enter the specific value in the text field. For example:

      Value of Errors per Minute > 100
    3. To compare the metric with a baseline, select < Baseline or > Baseline from the drop-down menu, and then select the baseline to use, the numeric qualifier of the unit of evaluation and the unit of evaluation. For example:

      Maximum of Average Response Time is > Baseline of the Daily Trend by 3 Baseline Standard Deviations

      You can construct this condition in the UI as follows:

      See Dynamic Baselines for information about the baseline options.

      Baseline Percentages

      The "baseline percentage" is the percentage above or below the established baseline at which the condition will be triggered. If, for example, you have a baseline value of 850 and you have defined a baseline percentage of "> 1%", the condition is true if the value is > [850+(850x0.01)] or 859.  In addition, to prevent too small sample sets from triggering health rules violations, these rules are not evaluated if the load (the number of times the value has been measured) is less than 1000. So if, for example, a very brief time slice is specified, the rule may not violate even if the conditions are met, because the load is not large enough.

  4. The Evaluate to true on no data option controls the evaluation of the condition in cases where any metric on which the condition is based returns no data. The default when no data is returned is for the condition to evaluate to unknown. If the health rule is based on all the conditions evaluating to true, having no data returned may affect whether the health rule triggers an action.

    If you want the condition to evaluate to true whenever a metric on which the condition depends returns no data, check the Evaluate to true on no data option. Note however that this option does not affect the evaluation of unknown in the case where there is not yet enough data for the rule to evaluate. For example, if the health rule is configured to evaluate the last 30 minutes of data and a new node is added, the condition will evaluate to unknown for the first 30 minutes even if the Evaluate to true on no data box is checked. 

    If you want all of the conditions to evaluate to true, you can check Evaluate all as true on no data instead of specifying the option for each condition separately. If you check his option and then add more conditions, new conditions will not be affected automatically. To apply this option to the added conditions, uncheck and then check the Evaluate all as true on no data check box again when you are finished adding conditions.

  5. Click Save when done. 


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

  • Agents may not be connecting with controllers due to communication errors for a couple of minutes.
  • Data may be delayed for a couple of minutes due to latency issues.

You can avoid occasional 1-2 minute metric loss due to network issues or late arrival by configuring your Health Rule as follows:
  1. Select Nodes for what the Health Rule affects. Tiers can be set, but more often we recommend setting Nodes.
  2. Select Node Health - Hardware, JVM, CLR as the Type.
  3. Use the last 5 minutes, with a wait time of 10 minutes.
  4. Set your condition to be the Sum of < Specific Value of 3.

This will generate a violation when the agent is down for more than 2 minutes in the last 5 mins.


To remove a condition component:

Remove a component condition by clicking the delete icon.

To build an expression:

To access the expression builder to create a complex expression as the basis of a condition, click the gear icon at the end of the row and select Use a mathematical expression of 2 or more metric values.

In the expression builder, use the Expression pane to construct the expression. Use the Variable Declaration pane to define variables based on metrics to use in the expression.

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

  1. In 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. Click Select a metric to open an embedded metric browser
  4. From the drop-down menu select the qualifier for the metric.
  5. Repeat steps 1 through 4 for each metric that you will use in the expression.
    You can remove a variable by clicking the delete icon.
  6. Build the expression by clicking the Insert Variable button to insert variables created in the Variable Declaration pane.  
  7. When the expression is built, click Use Expression.

Custom Metrics in Multiple Entities

To specify Hardware Resources, JVM, and CLR metrics in multiple entities using a wildcard, you can use the procedure described in Specify Metrics in Multiple Entities Using a Wildcard.

To create a health rule on a custom metric in a single business transaction, node, or overall application performance, you specify the health rule type as "custom" and when you configure the condition component, in the Select Metric window choose Specify a Metric from the Metric Tree and select the metric from the embedded metric browser.

A different use case is to create a rule that evaluates a custom metric that exists across various entities, for example across several nodes. You want to do this with one health rule, you do not want to create a separate health rule for each node. In this case, you need to specify the custom metric using the relative metric path to the metric instead of selecting the metric from the embedded metric browser.

First get the relative path to the metric and then configure the health rule using that relative path.

To get the relative metric path for a multi-entity metric:
  1. Navigate to the Metric Browser by selecting Metric Browser in the left navigation pane.
  2. Select the metric that you want to use for the condition.
  3. Right-click and select Copy Full Path.
  4. Save this value in a file from which you can copy it later.

The following example gets the metric path for the CPU %Busy metric for the Inventory Server tier. This would be appropriate to use in a health rule that affects all the nodes in that tier.

To configure a health rule that evaluates the custom metric over multiple entities:
  1. In the Overview panel of health rule wizard choose the health rule type for the kind of entity that you are monitoring.
  2. In the Affects panel select the affected entity.
  3. When you create the condition component that uses the metric, in the Select Metric window choose Specify a Relative Path Metric.
  4. Crop the relative metric path that you saved from the metric browser by doing one of the following:
    1. For all health rule types except Node Health-Hardware, JVM, CLR or Custom, crop the path to use the metric name alone - for example, Average Wait Time (ms)) 
    2. For Node Heath-Hardware, JVM, CLR and Custom health rule types, crop the path to use everything after the entity, for example, after the Node name. In the example below the cropped path would look like this. 
  5. Paste the cropped relative metric path in the relative metric path field of the Select Metric window.
  6. Click Select Metric.

Additional Considerations

  • Your application status is based on health rules for the current time range. If you disable old health rule policies, or enable new ones, you might see errors in red in your application status, even if there are no current critical events based on the new policies. To verify that your new or disabled health rule policies have taken effect, change the time range in your dashboard to a smaller, more recent timeframe.

  • When you are configuring health rules for business transactions with a very fast average response time (ART) such as 25 ms, using standard deviation as a criterion can cause the health rule to be violated too frequently. This is because a very small increase in response time can represent multiple standard deviations. In this case, consider adding a second condition that sets a minimum ART as a threshold. For example, if you don't want to be notified unless ART is over 50 ms, you could set your threshold as: ART > 2 Standard Deviations and ART > 50 ms.

  • Similarly, when configuring health rules for calls-per-minute (CPM) metrics, the health rule may never be violated if the condition is using standard deviations, and the resulting value is below zero. In this case, consider adding a second condition that checks for a zero value, such as: CPM < 2 Standard Deviations and CPM < 1.
  • No labels