<h2>Create or edit an event rule</h2><br/><div style="overflow-x:auto"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><meta content="text/html; charset=UTF-8" /><meta name="copyright" content="(C) Copyright 2025" /><meta name="DC.rights.owner" content="(C) Copyright 2025" /><meta name="generator" content="DITA-OT" /><meta name="DC.type" content="task" /><meta name="DC.title" content="Create or edit an event rule" /><meta name="abstract" content="You can create event rules to generate alerts for tracking and remediation. Use team-based integrations in event rules to make sure that connector ownership and execution of rules give precedence to general rules. Teams can maintain consistency and hierarchy while offering flexibility and customization options." /><meta name="description" content="You can create event rules to generate alerts for tracking and remediation. Use team-based integrations in event rules to make sure that connector ownership and execution of rules give precedence to general rules. Teams can maintain consistency and hierarchy while offering flexibility and customization options." /><meta name="DC.subject" content="Event Management create event rule, Save and upgrade, Update" /><meta name="keywords" content="Event Management create event rule, Save and upgrade, Update" /><meta name="DC.relation" scheme="URI" content="../../../product/event-management/concept/create-event-rules.html" /><meta name="DC.relation" scheme="URI" content="../../../product/it-operations-management/reference/r_ITOMApplications.html" /><meta name="DC.relation" scheme="URI" content="../../../product/it-operations-management/reference/itom-health-landing-page.html" /><meta name="DC.relation" scheme="URI" content="../../../product/event-management/concept/c_EM.html" /><meta name="DC.relation" scheme="URI" content="../../../product/event-management/concept/using-event-management.html" /><meta name="DC.relation" scheme="URI" content="../../../product/event-management/concept/processing-events.html" /><meta name="DC.relation" scheme="URI" content="../administer/field-administration/concept/c_PatternMatching.html" /><meta name="DC.relation" scheme="URI" content="../concept/event-input-information.html" /><meta name="DC.relation" scheme="URI" content="t_EMComposeOuput.html" /><meta name="DC.relation" scheme="URI" content="refresh-event-rule.html" /><meta name="DC.relation" scheme="URI" content="simulate-event-processing.html" /><meta name="DC.relation" scheme="URI" content="t_EMCreateFilter.html" /><meta name="DC.creator" content="ServiceNow" /><meta name="DC.date.created" content="2023-08-03" /><meta name="DC.date.modified" content="2024-02-01" /><meta name="DC.format" content="XHTML" /><meta name="DC.identifier" content="create-or-edit-event-rule" /><link rel="stylesheet" type="text/css" href="../../../CSS/commonltr.css" /><title>Create or edit an event rule</title></head><body id="create-or-edit-event-rule"> <div class="breadcrumb"><a class="link" href="../../../product/it-operations-management/reference/r_ITOMApplications.html" title="Get better visibility into your infrastructure and services, prevent service outages, and expand your organization's operational agility with ServiceNow IT Operations Management.">IT Operations Management</a> > <a class="link" href="../../../product/it-operations-management/reference/itom-health-landing-page.html" title="The ServiceNow ITOM Health product includes the ServiceNow Event Management and ServiceNow Metric Intelligence applications, which help you track and maintain the health of services in your organization.">ITOM Health</a> > <a class="link" href="../../../product/event-management/concept/c_EM.html" title="The ServiceNow Event Management application helps you to identify health issues across the datacenter on a single management console. It provides alert aggregation and root cause analysis (RCA) for discovered services, application services, and automated alert groups. Event Management is available as a separate subscription from the rest of the ServiceNow platform.">Event Management</a> > <a class="link" href="../../../product/event-management/concept/using-event-management.html" title="Event Management administrators administer events, manage and monitor alerts, aggregate alerts, and work review and monitor services' status with the Operator Workspace service monitor.">Configuring Event Management</a> > <a class="link" href="../../../product/event-management/concept/processing-events.html" title="Event processing is the process of taking events or streams of events, analyzing them and taking automatic action. The process includes viewing events, event binding, event rules and event field mapping.">Processing Events</a> > </div> <h1 class="title topictitle1" id="ariaid-title1">Create or edit an event rule</h1> <div class="body taskbody"><p class="shortdesc">You can create event rules to generate alerts for tracking and remediation. Use team-based integrations in event rules to make sure that connector ownership and execution of rules give precedence to general rules. Teams can maintain consistency and hierarchy while offering flexibility and customization options.</p> <div class="section prereq p">Role required: evt_mgmt_admin </div> <div class="section context">View the list of available event rules on the <span class="ph uicontrol">Event Rules</span> page to determine whether you want to create or edit an event rule.<div class="p">You can create rules that: <ul class="ul" id="create-or-edit-event-rule__ul_ztz_kqq_2x"><li class="li">Transform information in events to populate specified alert field values and compose alert fields from various values.</li><li class="li">Configure threshold rules that create or close alerts only when the incoming matching events exceed the specified threshold.</li><li class="li">Bind alerts to CIs using CI identifiers.</li></ul> </div> <div class="p">Options to create the rule are:<ul class="ul" id="create-or-edit-event-rule__ul_xmj_k5p_f5"><li class="li">Create an event rule and assign event fields for alert generation.</li><li class="li">Create a rule from an existing event or group of events that don’t have a rule. In this case, the event fields are copied to the Event Match Fields section of the rule.</li><li class="li">Edit an existing event rule.</li><li class="li">For Team-based integrations, select an assignment group.</li><li class="li"><p class="p">Run multiple sequential rules defined for the same event by selecting the <span class="ph uicontrol">Apply additional rules</span> check box. The event rules run in ascending order as defined in the <span class="ph uicontrol">Order</span> field. Event rules applied to assignment groups only run after the global rules have run.</p> </li></ul> </div> <p class="p">You can refresh an existing event rule with new event data. For more information see, <a class="xref" href="refresh-event-rule.html" title="Manually update event rules to reflect current event information because once an event rule is created, the Event Additional info and Event Raw info fields are not automatically updated.">Refresh event rules</a>.</p> <div class="note"><span class="notetitle">Note:</span> <ul class="ul" id="create-or-edit-event-rule__ul_q4f_lsl_tlb"><li class="li">Event rules that aren’t configured to perform any action are skipped. Therefore, if the rule isn’t configured as ignore, threshold, or binding, it’s important to specify either the match or the composed fields. </li><li class="li">Make sure that you don’t change the <span class="ph uicontrol">Classification</span> field value in event [em_event] tables, either manually, by script, or by event rule.</li></ul> </div> </div> <ol class="ol steps"><li class="li step stepexpand"> <span class="ph cmd">Navigate to <span class="ph menucascade"><span class="ph uicontrol">All</span> > <span class="ph uicontrol">Event Management</span> > <span class="ph uicontrol">Rules</span> > <span class="ph uicontrol">Event Rules</span></span> and take one of the following actions.</span> <table border="1" frame="hsides" rules="rows" cellpadding="4" cellspacing="0" summary="" class="simpletable choicetable choicetableborder" id="create-or-edit-event-rule__choicetable_u5d_w1m_zt"><colgroup><col style="width:50%" /><col style="width:50%" /><table><thead><tr class="sthead chhead"><th class="stentry choptionhd" style="vertical-align:bottom;text-align:left;" id="d615421e151-option">Option</th><th class="stentry chdeschd" style="vertical-align:bottom;text-align:left;" id="d615421e151-desc">Description</th></tr></thead><tbody><tr class="strow chrow"><th style="vertical-align:top;" headers="d615421e151-option" id="d615421e155" class="stentry choption">Create an event rule from an existing event </th><td style="vertical-align:top;" headers="d615421e151-desc d615421e155" class="stentry chdesc"> <ol class="ol" type="a" id="create-or-edit-event-rule__ol_cv3_h2v_ty"><li class="li">Select the link for unassociated events or grouped events that aren’t mapped to the rules. <div class="fig fignone" id="create-or-edit-event-rule__fig_dv3_h2v_ty"> <img class="image" id="create-or-edit-event-rule__image_ev3_h2v_ty" src="../image/EventManagementEventRuleSimple.png" alt="Example wording of the link: "There are 2 recommended rules, created out of 7 unassociated events of the most recent 50000 events."" /> </div> </li><li class="li">Select the event that you want to use for creating the rule. <p class="p">The event fields are copied to the Event Field Rules section of the rule.</p> </li></ol> </td></tr><tr class="strow chrow"><th style="vertical-align:top;" headers="d615421e151-option" id="d615421e183" class="stentry choption">Edit an existing event rule</th><td style="vertical-align:top;" headers="d615421e151-desc d615421e183" class="stentry chdesc">In the event rule list, select the required event rule to be modified. The event rule opens in the event rule designer where you can modify the values of the fields. <div class="p">Select <span class="ph uicontrol">Save and Upgrade</span> <img class="image" id="create-or-edit-event-rule__image_h1l_qfc_wy" src="../image/event-rule-save-and-upgrade.png" alt="Event Management save" /> to modify the rule when the following banner message appears and you want to convert the event rule. <pre class="pre codeblock"><code>Rule cannot be viewed in the event rule designer. To modify the rule click 'Save and Upgrade'.</code></pre> </div> </td></tr><tr class="strow chrow"><th style="vertical-align:top;" headers="d615421e151-option" id="d615421e207" class="stentry choption">Create an event rule</th><td style="vertical-align:top;" headers="d615421e151-desc d615421e207" class="stentry chdesc"> Select <span class="ph uicontrol">New</span>.</td></tr></tbody></table><ul><li class="li step stepexpand"> <span class="ph cmd">Ensure that <span class="ph uicontrol">Active</span> <img class="image" id="create-or-edit-event-rule__image_i5x_wtq_kfb" src="../image/active-toggle.png" alt="Active toggle" /> is selected.</span> <div class="itemgroup info">When the rule is deactivated, Event Management finds and applies another event rule. An alert is still created for the event unless <span class="keyword parmname">Ignore</span> is selected in another applicable rule or when configuring the filter for this event rule.</div> </li><li class="li step stepexpand"> <span class="ph cmd">Enter a unique and meaningful name and fill in the form.</span> <div class="itemgroup info"> <div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="create-or-edit-event-rule__table_zdm_zwc_sy" class="table" frame="border" border="1" rules="all"><caption><span class="tablecap"><span class="table--title-label">Table 1. </span>Event Rule Info form</span></caption><colgroup><col /><col /></colgroup><thead class="thead" style="text-align:left;"><tr class="row"><th class="entry cellrowborder" style="vertical-align:top;" id="d615421e262">Field</th><th class="entry cellrowborder" style="vertical-align:top;" id="d615421e265">Description</th></tr></thead><tbody class="tbody"><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e262 ">Source</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e265 "><span class="ph">Category to which this matching rule applies. The mapping rule only applies to events with the same event class value. If this value is empty, apply the rule to all events.</span></td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e262 ">Order</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e265 "><span class="ph">Order in which an event rule is evaluated when multiple rules are defined for the same type of event. Event rules are evaluated in ascending order.</span></td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e262 ">Description</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e265 ">Type additional information that describes the event rule.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e262 ">Apply additional matching rules</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e265 ">Select to apply additional event matching rules according to the Order field. The last rule with binding settings sets the CI binding. When selected, the Thresholds tab is inactive.</td></tr><tr class="row"><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e262 ">Assignment group</td><td class="entry cellrowborder" style="vertical-align:top;" headers="d615421e265 ">For team-based integrations, select an assignment group. <p class="p">If no assignment group is defined in the event rule, then this event rule is considered as a global rule.</p> <p class="p">When the rules are running – first the global rules run and then the rules that belong to the assignment group that the event’s source instance belongs to.</p> </td></tr></tbody></table> </div> </div> </li><li class="li step stepexpand"><strong>Optional: </strong> <span class="ph cmd">Define the event rule using these Event Rule Designer features.</span> <table border="1" frame="hsides" rules="rows" cellpadding="4" cellspacing="0" summary="" class="simpletable choicetable choicetableborder" id="create-or-edit-event-rule__choicetable_n2q_nks_sy"><colgroup><col style="width:50%" /><col style="width:50%" /><table><thead><tr class="sthead chhead"><th class="stentry choptionhd" style="vertical-align:bottom;text-align:left;" id="d615421e333-option">Option</th><th class="stentry chdeschd" style="vertical-align:bottom;text-align:left;" id="d615421e333-desc">Description</th></tr></thead><tbody><tr class="strow chrow"><th style="vertical-align:top;" headers="d615421e333-option" id="d615421e337" class="stentry choption">Event Filter</th><td style="vertical-align:top;" headers="d615421e333-desc d615421e337" class="stentry chdesc">Define a filter to restrict to which events the event rule must apply. See <a class="xref" href="t_EMCreateFilter.html" title="Define a filter to restrict to which events the event rule must apply. Configure the filter by providing a set of conditions that each event must match to be either excluded or included from applying to the event rule.">Filter the events that an event rule applies to</a>.</td></tr><tr class="strow chrow"><th style="vertical-align:top;" headers="d615421e333-option" id="d615421e353" class="stentry choption">Transform and compose alert output</th><td style="vertical-align:top;" headers="d615421e333-desc d615421e353" class="stentry chdesc">Configure the customization of alert content. See <a class="xref" href="t_EMComposeOuput.html" title="You can configure an event rule to customize alert content. You can customize the order of the fields and select which fields display. The fields in the left-hand work area of the Transform and Compose Alert Output section of an event rule are the fields that appear in the generated alert.">Configure an event rule to customize alert content</a>.</td></tr><tr class="strow chrow"><th style="vertical-align:top;" headers="d615421e333-option" id="d615421e372" class="stentry choption">Threshold</th><td style="vertical-align:top;" headers="d615421e333-desc d615421e372" class="stentry chdesc">Create or close alerts according to the specified threshold. See <a class="xref" href="t_EMISetThresholdEvent.html" title="The event threshold is the rate upon which Event Management generates an alert. Receiving multiple events for a device over a short interval may warrant creating an alert, as the condition may be serious. However, receiving events over a longer interval may indicate a less serious situation which would not warrant creating an alert.">Set a threshold to suppress alert generation</a>.</td></tr><tr class="strow chrow"><th style="vertical-align:top;" headers="d615421e333-option" id="d615421e391" class="stentry choption">Binding</th><td style="vertical-align:top;" headers="d615421e333-desc d615421e391" class="stentry chdesc">Configure event rules to automatically bind alerts to CI information from the CMDB. See <a class="xref" href="../reference/r_EMHowAlertsBindCI.html" title="When alerts are associated with CIs, the task of remediation is simplified. During alert generation, Event Management uses event rules and other mechanisms to automatically bind alerts to a CI information from the CMDB. For tracking purposes and remediation, the alert shows information about the CI that caused the event.">Alert binding to CIs with event rules</a>.</td></tr></tbody></table><ul><li class="li step stepexpand"> <span class="ph cmd">Select <span class="ph uicontrol">Save</span>, <span class="ph uicontrol">Submit</span>, or <span class="ph uicontrol">Update</span>.</span> </li><li><div class="related-links"> <div class="familylinks"> <div class="parentlink"><strong>Parent Topic:</strong> <a class="link" href="../../../product/event-management/concept/create-event-rules.html" title="Use event rules to generate alerts for tracking and remediation. Event rules are stored in the Event Rule [em_match_rule] table. Configure and customize event rules to manage events and alert generation.">Event rules</a></div> </div> <div class="linklist relinfo relconcepts"><strong>Related concepts</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../concept/event-input-information.html" title="The Event Input pane that is included in the steps to create an event rule provides a reference to the information that you can use when configuring an event rule.">Use event input information</a></li></ul></div> <div class="linklist relinfo reltasks"><strong>Related tasks</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="t_EMComposeOuput.html" title="You can configure an event rule to customize alert content. You can customize the order of the fields and select which fields display. The fields in the left-hand work area of the Transform and Compose Alert Output section of an event rule are the fields that appear in the generated alert.">Configure an event rule to customize alert content</a></li><li class="linklist"><a class="link" href="refresh-event-rule.html" title="Manually update event rules to reflect current event information because once an event rule is created, the Event Additional info and Event Raw info fields are not automatically updated.">Refresh event rules</a></li><li class="linklist"><a class="link" href="simulate-event-processing.html" title="You can simulate event processing logic on events and display the resulting alert to better understand which rules are executed on a given event and how the event fields change after the rule is executed.">Simulate event processing</a></li><li class="linklist"><a class="link" href="t_EMCreateFilter.html" title="Define a filter to restrict to which events the event rule must apply. Configure the filter by providing a set of conditions that each event must match to be either excluded or included from applying to the event rule.">Filter the events that an event rule applies to</a></li></ul></div> <div class="linklist relinfo"><strong>Related topics</strong><br /> <ul class="linklist"><li class="linklist"><a class="link" href="../administer/field-administration/concept/c_PatternMatching.html" target="_blank" rel="noopener noreferrer">Pattern matching</a></li></ul></div> </div> </li></ul></colgroup></table></li></ul></colgroup></table></li></ol></div></body></html></div>