When an alert is created in an app, the app will display a flyout panel with three main sections to configure:

    1. Action type and action details

    General alert details

    All alert share the following four properties in common:

    All alerts have name, tags, check every, and notify every properties in common

    Name

    The name of the alert. While this name does not have to be unique, the name can be referenced in actions and also appears in the searchable alert listing in the management UI. A distinctive name can help identify and find an alert.

    Tags

    A list of tag names that can be applied to an alert. Tags can help you organize and find alerts, because tags appear in the alert listing in the management UI which is searchable by tag.

    This value determines how frequently the alert conditions below are checked. Note that the timing of background alert checks are not guaranteed, particularly for intervals of less than 10 seconds. See Scale and performance for more information.

    Notify every

    This value limits how often actions are repeated when an alert instance remains active across alert checks. See for more information.

    Depending upon the Kibana app and context, you may be prompted to choose the type of alert you wish to create. Some apps will pre-select the type of alert for you.

    Each alert type provides its own way of defining the conditions to detect, but an expression formed by a series of clauses is a common pattern. Each clause has a UI control that allows you to define the clause. For example, in an index threshold alert the clause allows you to select an aggregation operation to apply to a numeric field.

    UI for defining alert conditions on an index threshold alert

    Action type and action details

    To add an action to an alert, you first select the type of action:

    Each action must specify a instance. If no connectors exist for that action type, click “Add new” to create one.

    Each action type exposes different properties. For example an email action allows you to set the recipients, the subject, and a message body in markdown format. See Action and connector types for details on the types of actions provided by Kibana and their properties.

    Using the template syntax {{variable name}}, you can pass alert values at the time a condition is detected to an action. Available variables differ by alert type, and a list can be accessed using the “add variable” button.

    Passing alert values to an action

    You can attach more than one action. Clicking the “Add action” button will prompt you to select another alert type and repeat the above steps again.

    Actions are not required on alerts. In some cases you may want to run an alert without actions first to understand its behavior, and configure actions later.

    Most Popular