Skip to main content
Version: 1.2

Creating a policy

Route: /policies

See also: Overview · Conditions · Modifiers and tools

Create a policy​

  1. Open Management → Policies.
  2. Click Create policy.
  3. Complete the drawer tabs: General, Conditions, Modifiers.
  4. Click Create.

Policy drawer — General

General tab​

FieldDescription
NamePolicy name (required)
DescriptionPurpose and expected outcome (required)
PriorityEvaluation order — lower number = higher priority; starts at 0 (required)
Statusactive / inactive. Active policies outside their time window show Pending in the table
TriggerWhen the policy runs — event-based or scheduled (see below)
All Day / Time RangeWhether the policy is eligible all day or only between start/end times
Enter the time rangeStart and end times (disabled when All Day is selected)

When Status is active but the current time is outside the configured range, the form shows Policy still disabled due to time range.

Trigger​

Policy drawer — Trigger options

TriggerWhen it runs
On alert creation and any change typeWhenever a new alert arrives or an existing alert changes
Every x minutesOn a fixed minute interval (Every (minutes) — minimum 1)
Daily at fixed timeOnce per day at Time (24-hour HH:mm)
Weekly at fixed timeOn the selected weekday and Time
Monthly at a fixed timeOn Day of the month (Day 1–31 or Last Day of Month) and Time

Scheduled triggers still respect the Conditions tab: only alerts matching your filters are modified on each run. With empty conditions, all alerts qualify (subject to the active time window).

Help text shown in the form:

  • Daily: "Policy will run daily at this time (24-hour format)"
  • Weekly: "Policy will run weekly on this day and time"
  • Monthly: reuses the notification monthly hint ("Notification will be sent monthly on this day and time")

Computed status in the table​

UI statusMeaning
ActivePolicy active and within time window (or All Day)
PendingActive but outside configured Time Range
InactivePolicy disabled

Table columns​

ColumnDescription
NamePolicy name (click to edit)
DescriptionDescription
StatusActive / Pending / Inactive
PriorityNumeric priority
ModifierCount of modifiers on the policy
Time RangeALL DAY or start–end times
Tool | ToolsAssigned custom tool name, or N/A
Creation dateWhen the policy was created

Double-click a row to open the editor. Use Enter the name to search; switch to Toggle TQL filter mode for advanced queries — see TQL search and filters.

For sorting, Column manager, pagination, and bulk actions, see List tables and bulk actions.

Bulk and row actions​

ActionScopeNotes
RunExactly 1 selected rowOpens Policy Execution Results
Edit1 rowOpens drawer
Duplicate≥ 1 rowCopies with a new name
Enable / Disable≥ 1 rowToggle Status
Delete≥ 1 rowRequires delete permission; confirmation dialog

Row shortcuts (with permission): green Run, blue Edit, red Delete.

Run policy — execution results​

After Run, a dialog shows:

SectionContent
SummaryPolicy Name, Alerts Matched, Alerts Modified
Affected Alerts (showing first 20)Table: ID, Resource, Event, Severity, Status
ErrorsPer-alert error messages, if any

Use Run to validate conditions and modifiers before relying on a policy in production.

Closing the drawer with unsaved edits prompts: "You have unsaved changes. Do you want to discard them?"

Best practices​

  • Set Trigger and Time Range on General before fine-tuning Conditions and Modifiers.
  • Use On alert creation and any change type for real-time enrichment; use scheduled triggers for batch cleanup.
  • Run after every significant change and check Alerts Modified matches expectations.
  • Disable policies (Status → inactive) instead of deleting when you need a temporary pause.