Skip to main content
FortiZiq
Staff
Staff
December 15, 2025

Technical Tip: Using FortiAnalyzer event handler and FortiGate automation stitch to trigger a failover

  • December 15, 2025
  • 0 replies
  • 438 views
Description

This article describes how to use FortiAnalyzer Event Handler with FortiGate automation stitch to trigger FortiGate cluster failover.

Scope FortiAnalyzer, FortiGate.
Solution

Note:

In this example, the Event Handler will be configured to be triggered when the FortiGate CPU value exceeds 5% for testing purposes; this can be changed accordingly.

 

In FortiAnalyzer, create a new handler for high CPU (ensure the automation stitch option is enabled). Event Handler can be created by going under Incidents & Events -> Event Handlers -> Event Handlers, and select 'Create New'.

 

An example of the handler is shown below:

 

handler.png

 

An example of the rule is shown below:

 

2. rule.png

 

On the FortiGate side, configure the automation stitch by navigating to Security Fabric -> Automation. Choose the trigger as FortiAnalyzer Event Handler and choose the previously created handler as shown below:

 

3. trigger.png

 

Configure the Action for failover as shown below:

 

4. action.png

 

Configure the automation stitch as shown below:

 

5. stitch.png

 

If the CPU in the FortiGate reaches 5% or more, the Event Handler in FortiAnalyzer will trigger, which will then trigger the failover automation stitch in the FortiGate.

 

This can also be configured alternatively, using FortiAnalyzer Playbooks. Refer to Technical Tip: FortiGate HA failover using FortiAnalyzer automation.

 

Make sure that the FortiAnalyzer's certificate is authorized in FortiGate. It is necessary for the OFTP communication between the FortiGate and FortiAnalyzer for the stitch to be triggered on the firewall.

Thought Leadership Security Summit. Outpace New Threats with AI - enhanced defense. Tuesday, Septmeber 15, 8:30 AM - 2:30 PM PT. The Golf Club at Newcastle, WA.
Fortinet Flag the Hack. Wednesday, August 26, 9:00 AM - 5:00 PM ET, COSM, Atlanta, GA.