Adding Smart Alerts

Introduction

Smart Alerts provide you with automatically generated alerting configurations so you can receive alerts based on out-of-the-box blueprints such as website slowness, javascript errors, and HTTP status codes.

Select a blueprint you would like to be alerted for, choose an arbitrary scope, for example, by geolocation, browser, OS, etc., and the system automatically creates a tailored alert for you.

Add an alert

  1. On the sidebar, click Websites.
  2. Click the name of your website and then click Add Alert.

Simple mode

By default, you create an alert in the simple mode which involves three steps; select an alert, confirm your scope, and select an alert channel. Simple mode enables you to select alerts with zero configuration involved, removing the need to create queries or define thresholds.

To create an alert in advanced mode, which allows you to investigate and modify any automatically configured alert setting, click Switch to Advanced Mode.

Select an alert

Select one of the following predefined blueprints that you want to create an alert for.

Blueprint Description
JS errors Click Select JS error to select an existing JavaScript error message that you want to be alerted for. Alternatively, you can choose the error message by providing a JavaScript message pattern using equal, contain, starts with, or ends with a defined string.
Slowness Select Slowness to receive alerts when the onLoad Time exceeds expectations derived from historical data. onLoad timing exists for each page load and models the time until navigation is complete; for example, the loading spinner has stopped.
HTTP status codes Select a specific HTTP status code you would like to be alerted for when they occur more often than usual.

Confirm your scope

The scope, your current open website, is automatically selected. By applying our Unbounded Analytics queries, you can further scope the alert to a specific subset of website traffic, for example, by geolocation, browser, or user.

Each query filter connects with the AND logic operator; therefore, a website beacon needs to match all the filters applied:

  • Specific pages.
  • Browser types.
  • Operating systems.
  • Countries.
  • Meta: specify additional metadata that you may use to annotate page loads. Select one of the available keys, a predefined value, and then select an operator.

Add alert channels

Click Select Alert Channel, and from the list of preconfigure channels, select the channels to receive the alerts. For information about creating channels, see Alert Channels.

Advanced mode

So that you have a full understanding and control over your alerts, advanced mode enables you to inspect the configuration of each preconfigured alert and modify if need be. In addition to the selections available in simple mode, the advanced mode offers the following.

Scope

The same selections are available as per the simple mode. For information, see Confirm your scope.

Trigger

Select one of the following predefined blueprints that you want to be alerted for.

JS errors

The same selections are available as per the simple mode. For information, see Select an alert.

The additional scope is that you can also select which metric is used for an alert evaluation; errors rate or errors count. Whichever metric you select, Instana automatically derives a threshold value based on the past 4 weeks of data, which can also be modified.

Alerts JS errors

Slowness

The same selections are available as per the simple mode. For information, see Select an alert.

You can also select which percentile metric is used for alert evaluation. An alert is triggered when the percentage of website page loads, with the onLoad time below the threshold, is less than the corresponding percentile number. Depending on the amount of available historical data, Instana suggests a static or a dynamic baseline. Additionally, you can choose between a daily or weekly seasonality baseline.

The static baseline value can be directly modified. Daily or weekly seasonality can be tuned by using the sensitivity parameter, which defines how much should outliers deviate from the expected value before it’s considered a violation.

Note: In specific scenarios, the following message is displayed; “Insufficient data to compute a baseline for the selected configuration”. This occurs when the threshold is set to Baseline (Weekly Seasonality) or to Baseline (Daily Seasonality), and the amount of traffic is not sufficient enough to compute the baseline. Should this occur, we recommend resetting the threshold to Static threshold.

Alerts Slowness

HTTP status codes

The same selections are available as per the simple mode. For information, see Select an alert.

You can also select which metric is used for alert evaluation; status code count or status code rate. Whichever metric you select, Instana recommends a threshold value based on historical data that can be modified.

Alerts HTTP status codes

Time threshold

So that the alert is triggered, time threshold allows you to impose additional conditions on how the defined threshold on the metric should be violated.

The following typical conditions, often used in practice, are offered out-of-the-box:

  • Persistence of time: Select a time window. When the metric violates a defined threshold over the defined time window, you are alerted.
  • The number of violations over time: Select a time window and the number of violations. When the metric violates the threshold a specified amount of times during the given time window, you are alerted.
  • User impact: Specify the number or percentage of impacted users. When the number of users is impacted during the given time window, you are alerted.

Alert channels

Click Select Alert Channel, and from the list of preconfigure channels, select the channels to receive the alerts. It is required to select at least one alert channel. For more information, see Alert Channels.

Alert properties

Adding additional alert properties is optional; however, it provides you with the additional configuration that best suits your needs. Along with editing the current title and description of the alert, you can also define the alert level; warning or critical, and select whether the alert triggers an incident. For more information, see Alerting.