Spaces method and path for this operation:
Refer to Spaces for more information.
Body
object
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the CCR read exceptions rule. These parameters are appropriate when
rule_type_idismonitoring_ccr_read_exceptions.Additional properties are allowed.
-
Value is
monitoring_ccr_read_exceptions. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the cluster health rule. These parameters are appropriate when
rule_type_idismonitoring_alert_cluster_health.Additional properties are allowed.
-
Value is
monitoring_alert_cluster_health. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the CPU usage rule. These parameters are appropriate when
rule_type_idismonitoring_alert_cpu_usage.Additional properties are allowed.
-
Value is
monitoring_alert_cpu_usage. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the disk usage rule. These parameters are appropriate when
rule_type_idismonitoring_alert_disk_usage.Additional properties are allowed.
-
Value is
monitoring_alert_disk_usage. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the ES version mismatch rule. These parameters are appropriate when
rule_type_idismonitoring_alert_elasticsearch_version_mismatch.Additional properties are allowed.
-
Value is
monitoring_alert_elasticsearch_version_mismatch. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the Kibana version mismatch rule. These parameters are appropriate when
rule_type_idismonitoring_alert_kibana_version_mismatch.Additional properties are allowed.
-
Value is
monitoring_alert_kibana_version_mismatch. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the license expiration rule. These parameters are appropriate when
rule_type_idismonitoring_alert_license_expiration.Additional properties are allowed.
-
Value is
monitoring_alert_license_expiration. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the logstash version mismatch rule. These parameters are appropriate when
rule_type_idismonitoring_alert_logstash_version_mismatch.Additional properties are allowed.
-
Value is
monitoring_alert_logstash_version_mismatch. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the memory usage rule. These parameters are appropriate when
rule_type_idismonitoring_alert_jvm_memory_usage.Additional properties are allowed.
-
Value is
monitoring_alert_jvm_memory_usage. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the missing monitoring data rule. These parameters are appropriate when
rule_type_idismonitoring_alert_missing_monitoring_data.Additional properties are allowed.
-
Value is
monitoring_alert_missing_monitoring_data. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the nodes changed rule. These parameters are appropriate when
rule_type_idismonitoring_alert_nodes_changed.Additional properties are allowed.
-
Value is
monitoring_alert_nodes_changed. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the large shard size rule. These parameters are appropriate when
rule_type_idismonitoring_shard_size.Additional properties are allowed.
-
Value is
monitoring_shard_size. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the thread pool search rejections rule. These parameters are appropriate when
rule_type_idismonitoring_alert_thread_pool_search_rejections.Additional properties are NOT allowed.
-
Value is
monitoring_alert_thread_pool_search_rejections. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the thread pool write rejections rule. These parameters are appropriate when
rule_type_idismonitoring_alert_thread_pool_write_rejections.Additional properties are NOT allowed.
-
Value is
monitoring_alert_thread_pool_write_rejections. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the anomaly detection rule. These parameters are appropriate when
rule_type_idisxpack.ml.anomaly_detection_alert".Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Default value is
true. -
Additional properties are NOT allowed.
-
Values are
record,bucket, orinfluencer. -
Minimum value is
0, maximum value is100. -
Minimum value is
1.
-
-
Value is
xpack.ml.anomaly_detection_alert. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the anomaly detection jobs health rule. These parameters are appropriate when
rule_type_idisxpack.ml.anomaly_detection_jobs_health".Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide testsConfig attributes Show testsConfig attributes object | null
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
-
-
-
Value is
xpack.ml.anomaly_detection_jobs_health. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the degraded docs rule. These parameters are appropriate when
rule_type_idisdatasetQuality.degradedDocs.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Additional properties are NOT allowed.
-
Value is
datasetQuality.degradedDocs. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the ES query rule. These parameters are appropriate when
rule_type_idis.es-query.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
The name of the numeric field that is used in the aggregation. This property is required when
aggTypeisavg,max,minorsum.Minimum length is
1. -
The type of aggregation to perform.
Default value is
count. -
Indicates whether to exclude matches from previous runs. If
true, you can avoid alert duplication by excluding documents that have already been detected by the previous rule run. This option is not available when a grouping field is specified.Default value is
true. -
Indicates whether the aggregation is applied over all documents (
all), grouped by row (row), or split into groups (top) using a grouping field (termField) where only the top groups (up totermSizenumber of groups) are checked. If grouping is used, an alert will be created for each group when it exceeds the threshold.Default value is
all. -
The type of query For example:
esQueryfor Elasticsearch Query DSL oresqlQueryfor Elasticsearch Query Language (ES|QL).Values are
searchSource,esQuery, oresqlQuery. Default value isesQuery. -
The number of documents to pass to the configured actions when the threshold condition is met.
Minimum value is
0, maximum value is10000. -
The sourceFields param is ignored.
Not more than
5elements. -
This property is required when
groupByistop. It specifies the number of groups to check against the threshold and therefore limits the number of alerts on high cardinality fields.Minimum value is
1. -
The threshold value that is used with the
thresholdComparator. If thethresholdComparatorisbetweenornotBetween, you must specify the boundary values.At least
1but not more than2elements. -
The comparison function for the threshold. For example: greater than, less than, greater than or equal to, between, or not between.
Values are
>,<,>=,<=,between, ornotBetween. -
The size of the time window (in
timeWindowUnitunits), which determines how far back to search for documents. Generally it should be a value higher than the rule check interval to avoid gaps in detection.Minimum value is
1. -
The type of units for the time window. For example: seconds, minutes, hours, or days.
-
-
Value is
.es-query. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the index threshold rule. These parameters are appropriate when
rule_type_idis.index-threshold.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
The name of the numeric field that is used in the aggregation. This property is required when
aggTypeisavg,max,minorsum.Minimum length is
1. -
The type of aggregation to perform.
Default value is
count. -
A Kibana Query Language (KQL) expression thats limits the scope of alerts.
-
Indicates whether the aggregation is applied over all documents (
all) or split into groups (top) using a grouping field (termField). If grouping is used, an alert will be created for each group when it exceeds the threshold; only the top groups (up totermSizenumber of groups) are checked.Default value is
all. -
The names of up to four fields that are used for grouping the aggregation. This property is required when
groupByistop.Minimum length is
1. -
This property is required when
groupByistop. It specifies the number of groups to check against the threshold and therefore limits the number of alerts on high cardinality fields.Minimum value is
1. -
At least
1but not more than2elements. -
The comparison function for the threshold. For example: greater than, less than, greater than or equal to, between, or not between.
Values are
>,<,>=,<=,between, ornotBetween. -
The field that is used to calculate the time window.
Minimum length is
1. -
The size of the time window (in
timeWindowUnitunits), which determines how far back to search for documents. Generally it should be a value higher than the rule check interval to avoid gaps in detection.Minimum value is
1. -
The type of units for the time window. For example: seconds, minutes, hours, or days.
-
-
Value is
.index-threshold. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the geo containment rule. These parameters are appropriate when
rule_type_idis.geo-containment.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Minimum length is
1. -
Minimum length is
1. -
Minimum length is
1. -
Minimum length is
1. -
Minimum length is
1. -
Minimum length is
1. -
Minimum length is
1. -
Minimum length is
1. -
Minimum length is
1. -
Minimum length is
1.
-
-
Value is
.geo-containment. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the transform health rule. These parameters are appropriate when
rule_type_idistransform_health.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Default value is
[](empty). -
Additional properties are NOT allowed.
Hide testsConfig attributes Show testsConfig attributes object | null
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
-
-
-
Value is
transform_health. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the APM anomaly rule. These parameters are appropriate when
rule_type_idisapm.anomaly".Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
The types of anomalies that are detected. For example, detect abnormal latency, throughput, or failed transaction rates.
At least
1element. Values aretxLatency,txThroughput, ortxFailureRate. -
The severity of anomalies that result in an alert: critical, major, minor, or warning.
Values are
critical,major,minor, orwarning. -
The environment from APM.
-
The service name from APM.
-
The transaction type from APM.
-
The size of the time window (in
windowUnitunits), which determines how far back to search for documents. Generally it should be a value higher than the rule check interval to avoid gaps in detection. -
The type of units for the time window: minutes, hours, or days.
-
-
Value is
apm.anomaly. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the error count rule. These parameters are appropriate when
rule_type_idisapm.error_rate.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Filter the errors coming from your application to apply the rule to a specific environment.
-
Filter the errors coming from your application to apply the rule to a specific error grouping key, which is a hash of the stack trace and other properties.
-
Perform a composite aggregation against the selected fields. When any of these groups match the selected rule conditions, an alert is triggered per group.
-
Additional properties are NOT allowed.
Hide searchConfiguration attribute Show searchConfiguration attribute object
-
Filter the errors coming from your application to apply the rule to a specific service.
-
The number of errors, which is the threshold for alerts.
-
A filter in Kibana Query Language (KQL) that limits the scope of the rule.
-
The time frame in which the errors must occur (in
windowUnitunits). Generally it should be a value higher than the rule check interval to avoid gaps in detection. -
The type of units for the time window: minutes, hours, or days.
-
-
Value is
apm.error_rate. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the transaction error rate rule. These parameters are appropriate when
rule_type_idisapm.transaction_error_rate.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Value is
apm.transaction_error_rate. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the transaction duration rule. These parameters are appropriate when
rule_type_idisapm.transaction_duration.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
The type of aggregation to perform.
Values are
avg,95th, or99th. -
Filter the rule to apply to a specific environment.
-
Perform a composite aggregation against the selected fields. When any of these groups match the selected rule conditions, an alert is triggered per group.
-
Additional properties are NOT allowed.
Hide searchConfiguration attribute Show searchConfiguration attribute object
-
Filter the rule to apply to a specific service.
-
The latency threshold value.
-
Filter the rule to apply to a specific transaction name.
-
Filter the rule to apply to a specific transaction type.
-
A Kibana Query Language (KQL) expression thats limits the scope of alerts.
-
The size of the time window (in
windowUnitunits), which determines how far back to search for documents. Generally it should be a value higher than the rule check interval to avoid gaps in detection. -
The type of units for the time window. For example: minutes, hours, or days.
-
-
Value is
apm.transaction_duration. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the synthetics monitor status rule. These parameters are appropriate when
rule_type_idisxpack.synthetics.alerts.monitorStatus.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Value is
xpack.synthetics.alerts.monitorStatus. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the synthetics tls rule. These parameters are appropriate when
rule_type_idisxpack.synthetics.alerts.tls.Additional properties are NOT allowed.
-
Value is
xpack.synthetics.alerts.tls. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the uptime monitor status rule. These parameters are appropriate when
rule_type_idisxpack.uptime.alerts.monitorStatus.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Value is
xpack.uptime.alerts.monitorStatus. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the uptime tls rule. These parameters are appropriate when
rule_type_idisxpack.uptime.alerts.tlsCertificate.Additional properties are NOT allowed.
-
Value is
xpack.uptime.alerts.tlsCertificate. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the uptime duration anomaly rule. These parameters are appropriate when
rule_type_idisxpack.uptime.alerts.durationAnomaly.Additional properties are NOT allowed.
-
Value is
xpack.uptime.alerts.durationAnomaly. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the metric inventory threshold rule. These parameters are appropriate when
rule_type_idismetrics.alert.inventory.threshold.Additional properties are allowed.
Hide params attributes Show params attributes object
-
Hide criteria attributes Show criteria attributes object
-
Additional properties are NOT allowed.
-
Value is
metrics.alert.inventory.threshold. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the metric threshold rule. These parameters are appropriate when
rule_type_idismetrics.alert.threshold.Additional properties are allowed.
Hide params attributes Show params attributes object
-
If true, an alert occurs if a group that previously reported metrics does not report them again over the expected time period. This check is not recommended for dynamically scaling infrastructures that might rapidly start and stop nodes automatically.
-
If true, an alert occurs if the metrics do not report any data over the expected period or if the query fails.
-
Any of: Hide attributes Show attributes
-
Value is
count. -
The threshold value that is used with the
comparator. If thecomparatorisbetween, you must specify the boundary values. -
The size of the time window (in
timeUnitunits), which determines how far back to search for documents. Generally it should be a value higher than the rule check interval to avoid gaps in detection. -
The type of units for the time window: seconds, minutes, hours, or days.
-
The threshold value that is used with the
warningComparator. If thewarningComparatorisbetween, you must specify the boundary values.
Hide attributes Show attributes
-
The threshold value that is used with the
comparator. If thecomparatorisbetween, you must specify the boundary values. -
The size of the time window (in
timeUnitunits), which determines how far back to search for documents. Generally it should be a value higher than the rule check interval to avoid gaps in detection. -
The type of units for the time window: seconds, minutes, hours, or days.
-
The threshold value that is used with the
warningComparator. If thewarningComparatorisbetween, you must specify the boundary values.
Hide attributes Show attributes
-
Value is
custom. -
The threshold value that is used with the
comparator. If thecomparatorisbetween, you must specify the boundary values. -
The size of the time window (in
timeUnitunits), which determines how far back to search for documents. Generally it should be a value higher than the rule check interval to avoid gaps in detection. -
The type of units for the time window: seconds, minutes, hours, or days.
-
The threshold value that is used with the
warningComparator. If thewarningComparatorisbetween, you must specify the boundary values.
-
-
A query that limits the scope of the rule. The rule evaluates only metric data that matches the query.
groupBy
string | array[string] Create an alert for every unique value of the specified fields. For example, you can create a rule per host or every mount point of each host. IMPORTANT: If you include the same field in both the
filterQueryandgroupBy, you might receive fewer results than you expect. For example, if you filter bycloud.region: us-east, grouping bycloud.regionwill have no effect because the filter query can match only one region.
-
-
Value is
metrics.alert.threshold. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the custom threshold rule. These parameters are appropriate when
rule_type_idisobservability.rules.custom_threshold.Additional properties are allowed.
Hide params attributes Show params attributes object
-
Hide criteria attributes Show criteria attributes object
-
Values are
recover,remainActive, oralertOnNoData. -
Additional properties are NOT allowed.
Hide searchConfiguration attributes Show searchConfiguration attributes object
index
string | object Required Any of: Hide attributes Show attributes
-
Hide fields attribute Show fields attribute object
-
Additional properties are NOT allowed.
Hide * attributes Show * attributes object
-
Minimum value is
0. -
Maximum length is
300. -
Additional properties are NOT allowed.
-
Maximum length is
1000. runtimeField
object Any of: Hide attributes Show attributes
-
Maximum length is
300. -
Additional properties are NOT allowed.
-
Minimum value is
0. -
Additional properties are NOT allowed.
-
Values are
keyword,long,double,date,ip,boolean, orgeo_point.
Hide attributes Show attributes
-
Hide fields attribute Show fields attribute object
-
Additional properties are NOT allowed.
Hide * attributes Show * attributes object
-
Maximum length is
300. -
Additional properties are NOT allowed.
-
Minimum value is
0. -
Values are
keyword,long,double,date,ip,boolean, orgeo_point.
-
-
-
Additional properties are NOT allowed.
-
Value is
composite.
-
-
Maximum length is
1000000. -
Additional properties are NOT allowed.
Hide subType attributes Show subType attributes object
-
Maximum length is
1000. Default value isstring.
-
-
Hide sourceFilters attributes Show sourceFilters attributes object
-
Additional properties are allowed.
-
Additional properties are NOT allowed.
-
Value is
observability.rules.custom_threshold. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. params
object Required The parameters for the log threshold rule. These parameters are appropriate when
rule_type_idislogs.alert.document.count.Any of: Hide attributes Show attributes
-
Additional properties are NOT allowed.
-
Hide criteria attributes Show criteria attributes object
-
Additional properties are NOT allowed.
-
Values are
s,m,h, ord.
Hide attributes Show attributes
-
Additional properties are NOT allowed.
-
Hide criteria attributes Show criteria attributes object
-
Additional properties are NOT allowed.
-
Values are
s,m,h, ord.
-
-
Value is
logs.alert.document.count. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the slo burn rate rule. These parameters are appropriate when
rule_type_idisslo.rules.burnRate.Additional properties are NOT allowed.
Hide params attributes Show params attributes object
-
Hide windows attributes Show windows attributes object
-
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
-
Value is
slo.rules.burnRate. -
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
Default value is
[](empty).Hide actions attributes Show actions attributes object
An action that runs under defined conditions.
-
Conditions that affect whether the action runs. If you specify multiple conditions, all conditions must be met for the action to run. For example, if an alert occurs within the specified time frame and matches the query, the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Defines the range of time in a day that the action can run. If the
startvalue is00:00and theendvalue is24:00, actions be generated all day.Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if
notify_whenis set toonThrottleInterval. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context.Default value is
{}(empty). -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Not more than
10elements. -
Additional properties are NOT allowed.
-
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
Indicates whether you want to run the rule on an interval basis after it is created.
Default value is
true. -
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The name of the rule. While this name does not have to be unique, a distinctive name can help you identify a rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the rule.
Default value is
{}(empty). -
The rule type identifier.
-
The check interval, which specifies how frequently the rule conditions are checked.
Additional properties are NOT allowed.
-
The tags for the rule.
Default value is
[](empty). -
Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
Responses
-
Indicates a successful call.
Hide response attributes Show response attributes object
-
Hide actions attributes Show actions attributes object
-
Defines a period that limits whether the action runs.
Additional properties are NOT allowed.
Hide alerts_filter attributes Show alerts_filter attributes object
-
Additional properties are NOT allowed.
Hide query attributes Show query attributes object
-
A filter written in Elasticsearch Query Domain Specific Language (DSL).
-
A filter written in Elasticsearch Query Domain Specific Language (DSL) as defined in the
kbn-es-querypackage.Hide filters attributes Show filters attributes object
-
A filter written in Kibana Query Language (KQL).
-
-
Additional properties are NOT allowed.
Hide timeframe attributes Show timeframe attributes object
-
Defines the days of the week that the action can run, represented as an array of numbers. For example,
1represents Monday. An empty array is equivalent to specifying all the days of the week.Values are
1,2,3,4,5,6, or7. -
Additional properties are NOT allowed.
-
The ISO time zone for the
hoursvalues. Values such asUTCandUTC+1also work but lack built-in daylight savings time support and are not recommended.
-
-
-
The type of connector. This property appears in responses but cannot be set in requests.
-
Additional properties are NOT allowed.
Hide frequency attributes Show frequency attributes object
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
Indicates whether the action is a summary.
-
The throttle interval, which defines how often an alert generates repeated actions. It is specified in seconds, minutes, hours, or days and is applicable only if 'notify_when' is set to 'onThrottleInterval'. NOTE: You cannot specify the throttle interval at both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.
-
-
The group name, which affects when the action runs (for example, when the threshold is met or when the alert is recovered). Each rule type has a list of valid action group names. If you don't need to group actions, set to
default. -
The identifier for the connector saved object.
-
The parameters for the action, which are sent to the connector. The
paramsare handled as Mustache templates and passed a default set of context. -
Indicates whether to use alert data as a template.
-
A universally unique identifier (UUID) for the action.
-
-
List of active snoozes for the rule.
-
Indicates that an alert occurs only when the specified number of consecutive runs met the rule conditions.
Additional properties are NOT allowed.
-
Indicates whether the API key that is associated with the rule was created by the user.
-
The owner of the API key that is associated with the rule and used to run background tasks.
-
Additional properties are NOT allowed.
Hide artifacts attributes Show artifacts attributes object
-
Additional properties are NOT allowed.
-
The name of the application or feature that owns the rule. For example:
alerts,apm,discover,infrastructure,logs,metrics,ml,monitoring,securitySolution,siem,stackAlerts, oruptime. -
The date and time that the rule was created.
-
The identifier for the user that created the rule.
-
Indicates whether you want to run the rule on an interval basis after it is created.
-
Additional properties are NOT allowed.
Hide execution_status attributes Show execution_status attributes object
-
Additional properties are NOT allowed.
-
Duration of last execution of the rule.
-
The date and time when rule was executed last.
-
Status of rule execution.
Values are
ok,active,error,warning,pending, orunknown. -
Additional properties are NOT allowed.
-
-
When flapping detection is turned on, alerts that switch quickly between active and recovered states are identified as “flapping” and notifications are reduced.
Additional properties are NOT allowed.
Hide flapping attributes Show flapping attributes object | null
-
Determines whether the rule can enter the flapping state. By default, rules can enter the flapping state.
-
The minimum number of runs in which the threshold must be met.
Minimum value is
2, maximum value is20. -
The minimum number of times an alert must switch states in the look back window.
Minimum value is
2, maximum value is20.
-
-
The identifier for the rule.
-
The date when the rule will no longer be snoozed.
-
Additional properties are NOT allowed.
Hide last_run attributes Show last_run attributes object | null
-
Additional properties are NOT allowed.
Hide alerts_count attributes Show alerts_count attributes object
-
Outcome of last run of the rule. Value could be succeeded, warning or failed.
Values are
succeeded,warning, orfailed. -
Outcome message generated during last rule run.
-
Order of the outcome.
-
Warning of last rule execution.
Values are
read,decrypt,execute,unknown,license,timeout,disabled,validate,maxExecutableActions,maxAlerts,maxQueuedActions, orruleExecution.
-
-
Monitoring details of the rule.
Additional properties are NOT allowed.
Hide monitoring attribute Show monitoring attribute object
-
Rule run details.
Additional properties are NOT allowed.
Hide run attributes Show run attributes object
-
Calculation of different percentiles and success ratio.
Additional properties are NOT allowed.
-
History of the rule run.
Hide history attributes Show history attributes object
-
Additional properties are NOT allowed.
Hide last_run attributes Show last_run attributes object
-
Additional properties are NOT allowed.
Hide metrics attributes Show metrics attributes object
-
Duration of most recent rule run.
-
Duration in seconds of rule run gap.
-
Additional properties are NOT allowed.
-
Total number of alerts created during last rule run.
-
Total number of alerts detected during last rule run.
-
Total time spent indexing documents during last rule run in milliseconds.
-
Total time spent performing Elasticsearch searches as measured by Kibana; includes network latency and time spent serializing or deserializing the request and response.
-
-
Time of the most recent rule run.
-
-
-
-
Indicates whether all alerts are muted.
-
List of identifiers of muted alerts.
-
The name of the rule.
-
Date and time of the next run of the rule.
-
Indicates how often alerts generate actions. Valid values include:
onActionGroupChange: Actions run when the alert status changes;onActiveAlert: Actions run when the alert becomes active and at each check interval while the rule conditions are met;onThrottleInterval: Actions run when the alert becomes active and at the interval specified in the throttle property while the rule conditions are met. NOTE: You cannot specifynotify_whenat both the rule and action level. The recommended method is to set it for each action. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values.Values are
onActionGroupChange,onActiveAlert, oronThrottleInterval. -
The parameters for the rule.
-
The rule revision number.
-
The rule type identifier.
-
Indicates whether the rule is running.
-
Additional properties are NOT allowed.
-
Identifier of the scheduled task.
-
Hide snooze_schedule attributes Show snooze_schedule attributes object
-
Duration of the rule snooze schedule.
-
Identifier of the rule snooze schedule.
-
Additional properties are NOT allowed.
Hide rRule attributes Show rRule attributes object
-
Indicates hours of the day to recur.
-
Indicates minutes of the hour to recur.
-
Indicates months of the year that this rule should recur.
-
Indicates the days of the month to recur.
-
Indicates seconds of the day to recur.
-
A positive or negative integer affecting the nth day of the month. For example, -2 combined with
byweekdayof FR is 2nd to last Friday of the month. It is recommended to not set this manually and just usebyweekday. -
Indicates the days of the week to recur or else nth-day-of-month strings. For example, "+2TU" second Tuesday of month, "-1FR" last Friday of the month, which are internally converted to a
byweekday/bysetposcombination. -
Indicates number of the week hours to recur.
-
Indicates the days of the year that this rule should recur.
-
Number of times the rule should recur until it stops.
-
Rule start date in Coordinated Universal Time (UTC).
-
Indicates frequency of the rule. Options are YEARLY, MONTHLY, WEEKLY, DAILY.
Values are
0,1,2,3,4,5, or6. -
Indicates the interval of frequency. For example, 1 and YEARLY is every 1 year, 2 and WEEKLY is every 2 weeks.
-
Indicates timezone abbreviation.
-
Recur the rule until this date.
-
Indicates the start of week, defaults to Monday.
Values are
MO,TU,WE,TH,FR,SA, orSU.
-
-
Skips recurrence of rule on this date.
-
-
The tags for the rule.
-
Deprecated in 8.13.0. Use the
throttleproperty in the actionfrequencyobject instead. The throttle interval, which defines how often an alert generates repeated actions. NOTE: You cannot specify the throttle interval at both the rule and action level. If you set it at the rule level then update the rule in Kibana, it is automatically changed to use action-specific values. -
The date and time that the rule was updated most recently.
-
The identifier for the user that updated this rule most recently.
-
Relative URL to view rule in the app.
-
-
Indicates an invalid schema or parameters.
-
Indicates that this call is forbidden.
-
Indicates that the rule id is already in use.
curl \
--request POST 'https://<KIBANA_URL>/api/alerting/rule/{id}' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--header "kbn-xsrf: true" \
--data '{"actions":[{"frequency":{"notify_when":"onActiveAlert","summary":false},"group":"query matched","id":"d0db1fe0-78d6-11ee-9177-f7d404c8c945","params":{"level":"info","message":"Elasticsearch query rule '{{rule.name}}' is active:\n- Value: {{context.value}} - Conditions Met: {{context.conditions}} over {{rule.params.timeWindowSize}}{{rule.params.timeWindowUnit}} - Timestamp: {{context.date}} - Link: {{context.link}}"}}],"consumer":"stackAlerts","name":"my Elasticsearch query ESQL rule","params":{"esqlQuery":{"esql":"FROM kibana_sample_data_logs | KEEP bytes, clientip, host, geo.dest | where geo.dest != \"GB\" | STATS sumbytes = sum(bytes) by clientip, host | WHERE sumbytes \u003e 5000 | SORT sumbytes desc | LIMIT 10"},"searchType":"esqlQuery","size":0,"threshold":[0],"thresholdComparator":"\u003e","timeField":"@timestamp","timeWindowSize":1,"timeWindowUnit":"d"},"rule_type_id":".es-query","schedule":{"interval":"1d"}}'
{
"actions": [
{
"frequency": {
"notify_when": "onActiveAlert",
"summary": false
},
"group": "query matched",
"id": "d0db1fe0-78d6-11ee-9177-f7d404c8c945",
"params": {
"level": "info",
"message": "Elasticsearch query rule '{{rule.name}}' is active:\n- Value: {{context.value}} - Conditions Met: {{context.conditions}} over {{rule.params.timeWindowSize}}{{rule.params.timeWindowUnit}} - Timestamp: {{context.date}} - Link: {{context.link}}"
}
}
],
"consumer": "stackAlerts",
"name": "my Elasticsearch query ESQL rule",
"params": {
"esqlQuery": {
"esql": "FROM kibana_sample_data_logs | KEEP bytes, clientip, host, geo.dest | where geo.dest != \"GB\" | STATS sumbytes = sum(bytes) by clientip, host | WHERE sumbytes > 5000 | SORT sumbytes desc | LIMIT 10"
},
"searchType": "esqlQuery",
"size": 0,
"threshold": [
0
],
"thresholdComparator": ">",
"timeField": "@timestamp",
"timeWindowSize": 1,
"timeWindowUnit": "d"
},
"rule_type_id": ".es-query",
"schedule": {
"interval": "1d"
}
}
{
"consumer": "alerts",
"name": "my Elasticsearch query KQL rule",
"params": {
"aggType": "count",
"excludeHitsFromPreviousRun": true,
"groupBy": "all",
"searchConfiguration": {
"index": "90943e30-9a47-11e8-b64d-95841ca0b247",
"query": {
"language": "kuery",
"query": "\"\"geo.src : \"US\" \"\""
}
},
"searchType": "searchSource",
"size": 100,
"threshold": [
1000
],
"thresholdComparator": ">",
"timeWindowSize": 5,
"timeWindowUnit": "m"
},
"rule_type_id": ".es-query",
"schedule": {
"interval": "1m"
}
}
{
"actions": [
{
"frequency": {
"notify_when": "onThrottleInterval",
"summary": true,
"throttle": "1d"
},
"group": "query matched",
"id": "fdbece50-406c-11ee-850e-c71febc4ca7f",
"params": {
"level": "info",
"message": "The system has detected {{alerts.new.count}} new, {{alerts.ongoing.count}} ongoing, and {{alerts.recovered.count}} recovered alerts."
}
},
{
"frequency": {
"notify_when": "onActionGroupChange",
"summary": false
},
"group": "recovered",
"id": "fdbece50-406c-11ee-850e-c71febc4ca7f",
"params": {
"level": "info",
"message": "Recovered"
}
}
],
"consumer": "alerts",
"name": "my Elasticsearch query rule",
"params": {
"esQuery": "\"\"\"{\"query\":{\"match_all\" : {}}}\"\"\"",
"index": [
"kibana_sample_data_logs"
],
"size": 100,
"threshold": [
100
],
"thresholdComparator": ">",
"timeField": "@timestamp",
"timeWindowSize": 1,
"timeWindowUnit": "d"
},
"rule_type_id": ".es-query",
"schedule": {
"interval": "1d"
}
}
{
"actions": [
{
"frequency": {
"notify_when": "onActionGroupChange",
"summary": false
},
"group": "threshold met",
"id": "48de3460-f401-11ed-9f8e-399c75a2deeb",
"params": {
"level": "info",
"message": "Rule '{{rule.name}}' is active for group '{{context.group}}':\n\n- Value: {{context.value}}\n- Conditions Met: {{context.conditions}} over {{rule.params.timeWindowSize}}{{rule.params.timeWindowUnit}}\n- Timestamp: {{context.date}}"
}
}
],
"alert_delay": {
"active": 3
},
"consumer": "alerts",
"name": "my rule",
"params": {
"aggField": "sheet.version",
"aggType": "avg",
"groupBy": "top",
"index": [
".test-index"
],
"termField": "name.keyword",
"termSize": 6,
"threshold": [
1000
],
"thresholdComparator": ">",
"timeField": "@timestamp",
"timeWindowSize": 5,
"timeWindowUnit": "m"
},
"rule_type_id": ".index-threshold",
"schedule": {
"interval": "1m"
},
"tags": [
"cpu"
]
}
{
"consumer": "alerts",
"name": "my tracking rule",
"params": {
"boundaryGeoField": "location",
"boundaryIndexId": "0cd90abf-abe7-44c7-909a-f621bbbcfefc",
"boundaryIndexTitle": "boundary*",
"boundaryNameField": "name",
"boundaryType": "entireIndex",
"dateField\"": "@timestamp",
"entity": "agent.keyword",
"geoField": "geo.coordinates",
"index": "kibana_sample_data_logs",
"indexId": "90943e30-9a47-11e8-b64d-95841ca0b247"
},
"rule_type_id": ".geo-containment",
"schedule": {
"interval": "1h"
}
}
{
"actions": [
{
"connector_type_id": ".server-log",
"frequency": {
"notify_when": "onActiveAlert",
"summary": false,
"throttle": null
},
"group": "query matched",
"id": "d0db1fe0-78d6-11ee-9177-f7d404c8c945",
"params": {
"level": "info",
"message": "Elasticsearch query rule '{{rule.name}}' is active:\n- Value: {{context.value}} - Conditions Met: {{context.conditions}} over {{rule.params.timeWindowSize}}{{rule.params.timeWindowUnit}} - Timestamp: {{context.date}} - Link: {{context.link}}"
},
"uuid": "bfe370a3-531b-4855-bbe6-ad739f578844"
}
],
"api_key_created_by_user": false,
"api_key_owner": "elastic",
"consumer": "stackAlerts",
"created_at": "2023-11-01T19:00:10.453Z",
"created_by": "elastic",
"enabled": true,
"execution_status": {
"last_execution_date": "2023-11-01T19:00:10.453Z",
"status": "pending"
},
"id": "e0d62360-78e8-11ee-9177-f7d404c8c945",
"mute_all": false,
"muted_alert_ids": [],
"name": "my Elasticsearch query ESQL rule",
"notify_when": null,
"params": {
"aggType": "count",
"esqlQuery": {
"esql": "FROM kibana_sample_data_logs | keep bytes, clientip, host, geo.dest | WHERE geo.dest != \"GB\" | stats sumbytes = sum(bytes) by clientip, host | WHERE sumbytes > 5000 | sort sumbytes desc | limit 10"
},
"excludeHitsFromPreviousRun\"": "true,",
"groupBy": "all",
"searchType": "esqlQuery",
"size": 0,
"threshold": [
0
],
"thresholdComparator": ">",
"timeField": "@timestamp",
"timeWindowSize": 1,
"timeWindowUnit": "d"
},
"revision": 0,
"rule_type_id": ".es-query",
"running": false,
"schedule": {
"interval": "1d"
},
"scheduled_task_id": "e0d62360-78e8-11ee-9177-f7d404c8c945",
"tags": [],
"throttle": null,
"updated_at": "2023-11-01T19:00:10.453Z",
"updated_by": "elastic\","
}
{
"actions": [],
"api_key_created_by_user": false,
"api_key_owner": "elastic",
"consumer": "alerts",
"created_at": "2023-07-14T20:24:50.729Z",
"created_by": "elastic",
"enabled": true,
"execution_status": {
"last_execution_date": "2023-07-14T20:24:50.729Z",
"status": "pending"
},
"id": "7bd506d0-2284-11ee-8fad-6101956ced88",
"mute_all": false,
"muted_alert_ids": [],
"name": "my Elasticsearch query KQL rule\"",
"notify_when": null,
"params": {
"aggType": "count",
"excludeHitsFromPreviousRun": true,
"groupBy": "all",
"searchConfiguration": {
"index": "90943e30-9a47-11e8-b64d-95841ca0b247",
"query": {
"language": "kuery",
"query": "\"\"geo.src : \"US\" \"\""
}
},
"searchType": "searchSource",
"size": 100,
"threshold": [
1000
],
"thresholdComparator": ">",
"timeWindowSize": 5,
"timeWindowUnit": "m"
},
"revision": 0,
"rule_type_id": ".es-query",
"running": false,
"schedule": {
"interval": "1m"
},
"scheduled_task_id": "7bd506d0-2284-11ee-8fad-6101956ced88",
"tags": [],
"throttle": null,
"updated_at": "2023-07-14T20:24:50.729Z",
"updated_by": "elastic"
}
{
"actions": [
{
"connector_type_id": ".server-log",
"frequency": {
"notify_when": "onThrottleInterval",
"summary": true,
"throttle": "1d"
},
"group": "query matched",
"id": "fdbece50-406c-11ee-850e-c71febc4ca7f",
"params": {
"level": "info",
"message": "The system has detected {{alerts.new.count}} new, {{alerts.ongoing.count}} ongoing, and {{alerts.recovered.count}} recovered alerts."
},
"uuid": "53f3c2a3-e5d0-4cfa-af3b-6f0881385e78"
},
{
"connector_type_id": ".server-log",
"frequency": {
"notify_when": "onActionGroupChange",
"summary": false,
"throttle": null
},
"group": "recovered",
"id": "fdbece50-406c-11ee-850e-c71febc4ca7f",
"params": {
"level": "info",
"message": "Recovered"
},
"uuid": "2324e45b-c0df-45c7-9d70-4993e30be758"
}
],
"api_key_created_by_user": false,
"api_key_owner": "elastic",
"consumer": "alerts",
"created_at": "2023-08-22T00:03:38.263Z",
"created_by": "elastic",
"enabled": true,
"execution_status": {
"last_execution_date": "2023-08-22T00:03:38.263Z",
"status": "pending"
},
"id": "58148c70-407f-11ee-850e-c71febc4ca7f",
"mute_all": false,
"muted_alert_ids": [],
"name": "my Elasticsearch query rule",
"notify_when": null,
"params": {
"aggType": "count",
"esQuery": "\"\"\"{\"query\":{\"match_all\" : {}}}\"\"\"",
"excludeHitsFromPreviousRun": true,
"groupBy": "all",
"index": [
"kibana_sample_data_logs"
],
"searchType": "esQuery",
"size": 100,
"threshold": [
100
],
"thresholdComparator": ">",
"timeField": "@timestamp",
"timeWindowSize": 1,
"timeWindowUnit": "d"
},
"revision": 0,
"rule_type_id": ".es-query",
"running": false,
"schedule": {
"interval": "1d"
},
"scheduled_task_id": "58148c70-407f-11ee-850e-c71febc4ca7f",
"tags": [],
"throttle": null,
"updated_at": "2023-08-22T00:03:38.263Z",
"updated_by": "elastic"
}
{
"actions": [
{
"connector_type_id": ".server-log",
"frequency": {
"notify_when": "onActionGroupChange",
"summary": false,
"throttle": null
},
"group": "threshold met",
"id": "dceeb5d0-6b41-11eb-802b-85b0c1bc8ba2",
"params": {
"level": "info",
"message": "Rule {{rule.name}} is active for group {{context.group} :\n\n- Value: {{context.value}}\n- Conditions Met: {{context.conditions}} over {{rule.params.timeWindowSize}}{{rule.params.timeWindowUnit}}\n- Timestamp: {{context.date}}"
},
"uuid": "07aef2a0-9eed-4ef9-94ec-39ba58eb609d"
}
],
"alert_delay": {
"active": 3
},
"api_key_created_by_user": false,
"api_key_owner": "elastic",
"consumer": "alerts",
"created_at": "2022-06-08T17:20:31.632Z",
"created_by": "elastic",
"enabled": true,
"execution_status": {
"last_execution_date": "2022-06-08T17:20:31.632Z",
"status": "pending"
},
"id": "41893910-6bca-11eb-9e0d-85d233e3ee35",
"mute_all": false,
"muted_alert_ids": [],
"name": "my rule",
"notify_when": null,
"params": {
"aggField": "sheet.version",
"aggType": "avg",
"groupBy": "top",
"index": [
".test-index"
],
"termField": "name.keyword",
"termSize": 6,
"threshold": [
1000
],
"thresholdComparator": ">",
"timeField": "@timestamp",
"timeWindowSize": 5,
"timeWindowUnit": "m"
},
"revision": 0,
"rule_type_id": ".index-threshold",
"running": false,
"schedule": {
"interval": "1m"
},
"scheduled_task_id": "425b0800-6bca-11eb-9e0d-85d233e3ee35",
"tags": [
"cpu"
],
"throttle": null,
"updated_at": "2022-06-08T17:20:31.632Z",
"updated_by": "elastic"
}
{
"actions": [],
"api_key_created_by_user": false,
"api_key_owner": "elastic",
"consumer": "alerts",
"created_at": "2024-02-14T19:52:55.920Z",
"created_by": "elastic",
"enabled": true,
"execution_status": {
"last_duration": 74,
"last_execution_date": "2024-02-15T03:25:38.125Z",
"status": "ok"
},
"id": "b6883f9d-5f70-4758-a66e-369d7c26012f",
"last_run": {
"alerts_count": {
"active": 0,
"ignored": 0,
"new": 0,
"recovered": 0
},
"outcome": "succeeded",
"outcome_msg": null,
"outcome_order": 0,
"warning": null
},
"mute_all": false,
"muted_alert_ids": [],
"name": "my tracking rule",
"next_run": "2024-02-15T03:26:38.033Z",
"notify_when": null,
"params": {
"boundaryGeoField": "location",
"boundaryIndexId": "0cd90abf-abe7-44c7-909a-f621bbbcfefc",
"boundaryIndexTitle": "boundary*",
"boundaryNameField": "name",
"boundaryType": "entireIndex",
"dateField": "@timestamp",
"entity": "agent.keyword",
"geoField": "geo.coordinates",
"index": "kibana_sample_data_logs",
"indexId": "90943e30-9a47-11e8-b64d-95841ca0b247"
},
"revision": 1,
"rule_type_id": ".geo-containment",
"running": false,
"schedule": {
"interval": "1h"
},
"scheduled_task_id": "b6883f9d-5f70-4758-a66e-369d7c26012f",
"tags": [],
"throttle": null,
"updated_at": "2024-02-15T03:24:32.574Z",
"updated_by": "elastic"
}