Event Management tag based alert grouping definition form

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Event Management tag based alert grouping definition form

    The Tag Based Alert Clustering Definition form in Event Management allows you to create or modify definitions that group alerts based on tags. This form helps you configure criteria to cluster related alerts efficiently, improving alert management and response.

    Show full answer Show less

    Key Features

    • Name: Unique identifier for each alert clustering definition.
    • Active: Enables or disables the definition; active by default.
    • Order: Determines the sequence in which definitions are applied to incoming alerts; lower values have higher priority.
    • Domain: Read-only field indicating the domain of the record.
    • Assignment Group: Specifies the team responsible for alerts matching this definition. Global rules run before assignment group-specific rules.
    • Description: Optional field for additional details about the definition.
    • Filter: Defines conditions alerts must meet to be considered for clustering based on tags. Includes a Preview option to view matching alerts. Filters are case sensitive by default but can be configured otherwise.
    • Override Group Description: Allows customization of alert group descriptions instead of the default "Group of alerts" prefix.
    • Clustering Timeframe: Sets the maximum time interval (in minutes) between alerts to be grouped together, ranging from 0 to 1440 minutes.
    • Tag Based Alert Clustering Tags: Selects the specific alert tags that trigger inclusion in the alert group. Tags must be pre-defined on the Tag Based Alert Clustering Tags page.

    Practical Application for ServiceNow Customers

    This form enables you to tailor alert grouping by defining precise filters and tags, ensuring that related alerts are clustered effectively. By setting the order and assignment groups, you control the processing priority and responsible teams, enhancing alert triage and resolution. Customizing group descriptions improves clarity in alert communication. The clustering timeframe helps manage alert relevance over time, avoiding unnecessary noise.

    The form for creating or modifying a tag based alert clustering definition displays detailed information about the definition.

    Table 1. Tag based alert clustering definition form
    Field Description
    Name Name of the alert clustering definition.

    Definition names must be unique.

    Active Select to activate the definition. This option is selected by default.
    Order The order by which definitions are tested for incoming alerts. Those with lower Order values are tested first.

    When an alert matches one of the definitions' filters, it continues searching for more definitions.

    Default value = 1000

    Domain The domain in which the current record was created. Read-only.
    Assignment group Assignment group that works on the alert.

    If no assignment group is defined in the alert rule, then this alert rule is considered as a global rule.

    When the rules are running – first the global rules run and then the rules that belong to the assignment group of the alert.

    Description Enter an optional description of the alert clustering definition.
    Filter Set conditions that incoming alerts must meet to be measured by the alert clustering definition's tags. If the tags correspond to alerts that exist in the system and are within the Clustering timeframe (minutes) value, the incoming alerts join with the existing alerts to form an alert group.
    After configuring the filter, you can click the Preview button to view how many existing alerts match the filter's condition.
    Note:
    • Matching alerts are not automatically included together in an alert group. Alerts are grouped only if they have corresponding alert clustering tags.
    • Filter parameters are case sensitive by default. To disable case sensitivity, set the sa_analytics.correlation_case_sensitive parameter to false.
    • You can also configure alert fields to be excluded from the search, using the sn_em_tbac.tag_excluded_alert_fields property. By default, the following are excluded by this property:
      • type
      • event_class
    Override group description Default group descriptions begin with a “Group of alerts” prefix, followed by the description of the primary alert in the group. You may override this group description by selecting the Override group description check box. Then, in the Custom description field, type a description. This description is used as the description of the groups that are created by this alert clustering definition.
    Note:
    You cannot save the form if you left the Custom description field blank or with the default 'Group of alerts' text.
    Clustering timeframe The maximum time, in minutes, allowed between the first alert and subsequent alerts for them to be grouped together. For example, a value of 60 indicates that any alert generated within 60 minutes of the first alert in the group (the oldest alert) is included in the alert group. Any alert generated after this 60-minute window from the initial alert is not included in the group.

    Permitted values = 0-1440

    Tag Based Alert Clustering Definitions Tags M2M Select the alert clustering tags to be assigned to the alert clustering definition. Alerts that meet the criteria specified in the selected tags are included in the alert group.

    The available options are the tags created on the Tag Based Alert Clustering Tags page.