Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Comment: Published by Scroll Versions from this space and version 20.7

    It is important that you configure alerts appropriately to To ensure that you do not miss any alerts or receive false alerts, you must configure alerts appropriately'Alert Sensitivity Tuning'  (AST) helps you configure configure alerts with appropriate sensitivity . AST provides historical data by providing historical data for the metric or the baseline being configured and hence helps you visualize . AST also visualizes the impact of the alerting alert configuration. For more information, see Alert Sensitivity Tuning.

    Anchor
    Fine-tuneConditionEvaluation
    Fine-tuneConditionEvaluation
    Create a Health Rule and Fine-tune Metric Evaluation

    You can create a health rule to monitor the parameters of an application entity and fine-tune the sensitivity of a health rule using Alert Sensitivity Tuning (AST).

    Info
    titlePrerequisites
    • You must be a SaaS customer.
    • You must be monitoring a business transaction, a service endpoint, or a remote service (affected entity).
    1. In the entity (BT, SEP, or remote services) UI, select an entity from the list.
    2. Right-click the entity and click Create new Health Rule. The Create Health Rule UI is displayed.
    3. Configure the health rule overview details. For more information, see Configure Heath Rule Details.
    4. In the Affected Entities panel, select the entities to be monitored.
    5. In the Critical Criteria panel, select +Add Condition
    6. Configure the health rule condition as follows:
    7. In the
    8. .
    9. If required. select the Warning Criteria panel and define warning conditions as described in step 6. 
    10. Click Save. The health rule is saved.

    Anchor
    Configure
    Configure
    Configure the Health Rule Condition

    1. Enter a name for the condition in the first field of the condition row
    2. , enter a name for the condition
    3. .
      This name is used in the generated notification text and in the AppDynamics console to identify the violation.
    4. From the drop-down list
    5. below the Add Condition button, select Single Metric metric
    6. next to the condition name field, select the single metric or metric expression to evaluate the condition.
        From the Value drop-down list, select a qualifier for the metric from the following options
        1. Single Metric:

          Qualifier Type

          Description

          Minimum

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

          Maximum

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

          Value

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

          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.


          1. From the Value drop-down list, select a qualifier for the metric from the following options:

          2. Click Select a Metric. Metric Selection

      1.  window is displayed
          1.  dialog box appears. The metric browser in the Metric Selection 

      2. window
          1. dialog box displays metrics appropriate to the health rule.

          2. Select a metric from the list for the business transaction. Click Select Metric
            A graphical view of the metric data for the last 8

      3. hours is displayed
          1. hours appears.

            Image Modified

            Info

            If you want to view the metric data for 1 day or 3 days, you can select the time period using the drop-down

      4. menu
          1. list.

          2. From the drop-down list after the metric, select the type of comparison to evaluate the metric.

            • To limit the effect of the health rule to conditions during which the metric is within a defined range—standard deviations or percentages—from the baseline, select Within Baseline from the

      5. menu.
            • drop-down list. 
              To limit the effect of the health rule to when the metric is not within that defined range, select Not Within Baseline. Then select the following:
               -baseline to

      6. use, the
            • use 
               -numeric qualifier of the unit of evaluation

      7. , and the

            •  -unit of evaluation

      8. .

            • For example:

              No Format
              Within Baseline of the Default Baseline by 3 Baseline Standard Deviations
            • 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:

              No Format
              Value of Errors per Minute > 100
            • To compare the metric with a baseline, select < Baseline or > Baseline from the drop-down list, and then select

      9. the
            • the 
              following:
               - baseline to use

      10. , the

            •  - numeric qualifier of the unit of evaluation

      11. , and the

            •  - unit of evaluation. 
              You can use the Baseline Standard Deviation or Baseline Percentage as the unit of evaluation. For example:

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

              See Dynamic Baselines for information about the baseline options.

              Info
              titleBaseline Percentages

              The baseline percentage is the percentage above or below the established baseline at which the condition will trigger. For example, if 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.

      12.  
            • To prevent health rule violations from being triggered when the sample sets are too small, these rules are not evaluated if the load—the number of times the value has been measured—is less than 1000. For example, if 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.
              Depending on the baseline configuration you define, a graphical view of the metric data for the given baseline configuration is displayed. The graphical view is instantly updated when you update any configuration. You can also view granular details by

      13. modifying
            • zooming in on the graphical view. The metric data presented in the graph helps you calibrate the sensitivity of the metric evaluation.
              Image Modified

        1. Metric Expression:
          1. Select the Metric Expression option from the drop-down list and click Add Expression. The Metric Expression window appears that allows you to construct a mathematical expression to use as a metric. For example, the following expression is created to measure the number of calls per CPU: Value of {calls} {cpu} > 1.

          2. In the Variable Declaration panel of the Mathematical Expression builder, click + Add variable to add a variable.

          3. In the Variable Name field, enter a name for the variable.
          4. From the drop-down list next to the Variable Name field, 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.

            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.

          5. Click Select a metric to open an embedded metric browser. To avoid erroneous evaluations, if any metric in the expression has a null value, the health rule is not evaluated.

            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
          6. Repeat Steps I through V for every metric that you use in the expression. You can remove a variable by clicking the Delete icon.
          7. 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.
          8. When the expression is built, click Save.

          9. Back on the Critical Criteria tab, select < Specific value or > Specific Value from the menu to compare the value of the metric evaluation with a static literal value, then enter the specific value in the text field. For example:

            Code Block
            languageyml
            Value of {calls} / {cpu} > 1

            A graphical view of the metric data for the last 8 hours appears.

            Image Added

            Info

            You can view the metric data for 1 day or 3 days by selecting the time period using the drop-down menu.

      14. If you want the condition to evaluate to true

      15. whenever
      16. when a configured metric does not return any data during the evaluation time frame,

      17. check the 
      18.  select the Evaluate to true on no data option. 
        This option does not affect the evaluation of the unknown in the case where there is no 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 evaluates to unknown for the first 30 minutes even if the Evaluate to true on no data

      19.  box
      20.  option is

      21. checked
      22. selected.

      23. 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.

        Info
        • You can define a persistence threshold for a condition only if you have defined an evaluation time frame of 30 minutes or less.
      24. Note
        • If you define a persistence threshold for a condition, the metric data is plotted directly on the AST graph. If you do not define a persistence threshold, a 'moving average' for the selected metric is plotted. For more information, see Why
      25. use 'moving average'?
      26. Specify the evaluation scope in the Critical Criteria and Warning Criteria panels, select the average of all nodes.

        Info

        AST graphical view is displayed only when you set the health rule evaluation scope to

      27. '
      28. the average for all nodes

      29. '
      30. .

      31. If required. select the Warning Criteria panel and define warning conditions as described in step 6. 
      32. Click Save. The health rule is saved.