Anomaly health checks

StackState Self-hosted v5.0.x

This page describes StackState version 5.0.

Go to the documentation for the latest StackState release.

To use anomaly health checks, the Autonomous Anomaly Detector StackPack must be installed.


The Autonomous Anomaly Detector (AAD) looks for deviations in metric streams. It annotates the metric streams with anomalies and generates corresponding anomaly events. The anomaly events can be viewed in the event perspective and also serve as an input for health checks. Health checks can react to anomaly events and set the component health state to the DEVIATING (orange). Without a health check responding to generated anomaly events, a component would not change its health state based on found anomalies.

Anomaly health checks are automatically placed on components by the StackPacks but you can also manually create an anomaly health check.

Manually add an anomaly health check to a component

Follow the instructions below to add an anomaly health check to a component.

  1. In the StackState UI Topology Perspective, select the component that you want to add an anomaly health check to.

    • Detailed information abou the component will be displayed in the right panel Selection details tab.

  2. Click the ADD NEW HEALTH CHECK button under Health in the right panel Selection details tab.

  3. Add the following arguments:

    • anomalyDirection - the direction the found anomaly must have for the check to go to a DEVIATING (orange) health state. You can choose from:

      • Rise - to detect peaks, for example in a latency metric stream.

      • Drop - to detect sudden drops, for example in the number of threads free in a thread pool.

      • Any - to detect both rises and drops, for example when detecting both hot and cold deviations in data center temperature.

    • metricStream - a metric stream that is available on the component to detect the anomalies on.

    • event - leave unchanged. This is an instance of an anomaly event that the check will react to.

  4. Click CREATE to activate the check.

You can automate the creation of such checks, like any other checks, using the component templates.

Check function: Autonomous metric stream anomaly detection

When enabled, the autonomous metric stream anomaly detection check function will behave as follows:

  • The Autonomous metric stream anomaly detection check will remain in an UNKNOWN (gray) health state unless an anomaly is found.

  • When an anomaly is found, the check will go to a DEVIATING (orange) health state.

  • Only HIGH severity anomalies change the health status of the check to DEVIATING.

  • It can take between 5 to 25 minutes before an anomaly is detected, depending on the granularity of the metric stream and the size of the anomaly. Only anomalies lasting for several minutes are considered to be HIGH severity anomalies.

  • Once an anomaly is found, the DEVIATING health state will remain for at least 8 minutes.

Advanced users of StackState can create custom anomaly check functions.

See also

Last updated