system automation-trigger
Use this command to configure the triggers in the Automation feature.
To use this command, your administrator account’s access control profile must have either w or rw permission to the mntgrp area. For details, see Permissions.
Syntax
config system automation-trigger
edit <trigger_name>
set comments <string>
set trigger-type {event-based | schedule}
set event-type {HA | event-log | fds-updated | high-cpu | licensed-expired | local-cert-expire | low-memory | reboot}
set trigger-frequency {daily | hourly | monthly | weekly}
set trigger-hour <integer>
set trigger-minute <integer>
set use-rolling-window {enable | disable}
set rolling-window <integer>
set occurrence-number <integer>
set logid <int>
config fields
edit <index>
set name <string>
set value <string>
next
end
next
end
| Variable | Description | Default |
|
<trigger_name> |
Enter a name for the trigger. | No default. |
|
comments <string> |
Enter a description for the trigger. |
No default. |
|
trigger-type {event-based | schedule} |
Select whether the trigger is initiated by a specific system event or according to a defined time schedule. | event-based |
|
event-type {HA | event-log | fds-updated | high-cpu | licensed-expired | local-cert-expire | low-memory | reboot} |
Select the type of the event for the trigger. FortiWeb will take action when the specified event occurs.
|
No default. |
|
trigger-frequency {daily | hourly | monthly | weekly} |
Select the recurrence interval for a schedule-based trigger. |
daily |
|
trigger-hour <integer> |
Specify the hour of the day (0–23) for the trigger to execute. |
1 |
|
trigger-minute <integer> |
Specify the minute of the hour (0–59) for the trigger to execute. |
0 |
|
The following parameters configure the Rolling Window that enables frequency-based control for specific automation triggers. Instead of an action firing every time a single event is detected, the trigger only activates if a specific number of occurrences are recorded within a defined time interval. This mechanism is essential for mitigating "alert flooding" in scenarios such as sustained attacks or high-frequency log generations. The following trigger types are supported:
|
||
|
use-rolling-window {enable | disable} |
Enables or disables the frequency-based threshold mechanism for the selected trigger. When disabled, the automation fires immediately every time the trigger condition is met. |
disable |
|
rolling-window <integer> |
Specifies the time interval, in seconds, during which FortiWeb monitors and counts trigger events. If the timer expires before the occurrence threshold is reached, the system resets the count and timer to zero. The valid range is 1 to 3,600 seconds. |
300 |
|
occurrence-number <integer> |
Sets the specific number of times a trigger condition must be met within the Rolling Window Time (use-rolling-window) before the action is initiated. Once this threshold is reached, the action triggers, and both the counter and timer reset. The valid range is 1 to 3,600 seconds. |
300 |
|
If the |
||
|
logid |
Enter the id of the event log. |
No default. |
|
<index> |
Enter the index of the filter to filter out specific event logs. |
No default. |
|
name <string> |
The name of the log field to be used to filter out certain logs. |
No default. |
|
value <string> |
The value of the log field to be used to filter out certain logs. |
No default. |