Skip to main content
Version: 1.2

Modifiers and tools

Route: /policies (Modifiers tab in the policy drawer)

Modifiers are the actions of a policy: changes applied to each alert that passed Conditions. You can also attach an optional custom tool to run script logic on matching alerts.

See also: Overview · Conditions · Tools overview

Policy drawer — Modifiers

Add a modifier​

  1. Open the Modifiers tab.
  2. Click Add modifier.
  3. For each modifier row:
    • Select column — alert field to change (immutable fields such as id, resource, and event are excluded)
    • Enter attribute — only when column is attributes
    • Select operation — set, add, delete, or replace (depends on column type)
    • Value — type-appropriate input (severity picker, text, date, …)
    • Enter value to replace — only when operation is replace
  4. Remove a row with the red trash button.
  5. Save the policy.

You can stack multiple modifiers on one policy; they apply in list order.

Operations by column type​

Column typeAvailable operations
severity, firstSeverity, statusset only
attributesset, delete (no value needed for delete)
Text / enum fieldsset, add, delete, replace
Number fieldsset, delete
Array fields (service, tags, …)set, add, delete
Object fieldsset only

Operation meanings​

OperationEffect
setReplace the field value
addAppend to a list or combine values (where supported)
deleteRemove a value or clear an attribute key
replaceSubstitute a substring/pattern — requires Enter value to replace

Execute custom tool​

At the bottom of the Modifiers tab:

FieldDescription
Execute custom toolDropdown: None or a registered custom tool by name

When a tool is selected, it runs on alerts that match Conditions (in addition to applying modifiers). Tools are defined under Tools → Tools — see Tools overview.

Tools license limit

Active policies with a custom tool assigned count toward your tools license limit. When the limit is reached:

  • Execute custom tool is disabled (Max items reached).
  • You cannot enable an inactive policy that already has a tool assigned.

Example scenarios​

Normalize severity on acknowledge​

  • Conditions: status Equals → ack
  • Modifier: severity set → normal

Add ownership metadata​

  • Conditions: service Contains → billing
  • Modifier: attributes key owner set → billing-team

Strip a temporary tag after processing​

  • Conditions: tags Contains → auto-imported
  • Modifier: tags delete → auto-imported

Enrich via script​

  • Modifiers: attributes set key enriched → true
  • Execute custom tool: lookup-cmdb (example tool name)

Best practices​

  • Prefer modifiers for simple field updates; use custom tools for external lookups or complex logic.
  • Use set on severity/status carefully — test with Run to avoid hiding real incidents.
  • One policy per concern (tagging, severity normalization, enrichment) keeps priorities predictable.
  • Leave Execute custom tool as None unless script execution is required — fewer moving parts and no tools quota impact.
  • Document tool side effects in the policy Description for operators and auditors.