Trigger History
Introduction
Feature(s)
Trigger History provides detailed information on how Automations is triggered.
Application Scenario(s)
If an automation fails to run, troubleshoot the cause of the failure through Trigger History to optimize the relevant settings or manually trigger the automation.
Where to Access Trigger History
Here are the two ways to access Trigger History:
1. When accessing Trigger History for one automation: go to Edit > Extension > Automations > Trigger History.
2. When accessing Trigger History for all automations: go to App Management > Automations > Trigger History.
Filtering Trigger History
Filter data in Trigger History according to:
- Time: refers to the interval of trigger time, accurate to seconds.
- User: refers to all users/anonymous users/specific members.
- Run Result: includes successful/failed trigger.
- Type: refers to automatic/manual trigger.
Set one or more filtering conditions and click Filter. If no filtering conditions are set, all trigger history will be automatically displayed.
Trigger History Content
Time
Time refers to the time when an automation is triggered.
User
User is the nickname of the member that triggers automations. If an external member triggers automations through public links, no user will be displayed.
Type
There are two types: Auto Trigger and Manual Trigger. Here are the differences between them:
- Auto Trigger: In the case of data change, automations will be automatically triggered.
- Manual Trigger: In the case of failed trigger, manually trigger automations. For details, see the section "Retry".
Trigger
The content displayed in Trigger includes: the type of trigger action, the title of the triggered form, and the corresponding record title.
Members who are granted permissions to access a form can click its record title to view the details of one record.
Run Result
In different cases, the content displayed in Run Result is different.
1. When an automation is successfully triggered, it includes:
- the type of trigger action
- the title of the target form
- the number of items which are successfully run
2. When an automation fails to be triggered:
- If you cannot retry: It includes the trigger action, the title of the target form, the cause for failure.
- If you can retry: It includes the trigger action, the title of the target form, the cause for failure, and a button for retrying.
- If you have retried: It includes the trigger action, the title of the target form, the cause for failure, and Executed.
When an automation fails to be triggered, modify the relevant settings according to the cause for the failure and manually retry.
Retry
1. When an automation fail to be triggered, the Retry button will appear beside the data. You can manually retry the automation with the button.
Unable to manually retry when:
- You fail to find the target form.
- You configure multiple trigger actions for the automation.
- There are more than updated 200 records to be filtered.
- There are more than deleted 100 records to be filtered.
- The trigger action currently set in the automation is not the same as the trigger action already run.
Note:
The trigger conditions are not validate when being retried. Automations that fail to be triggered can also be retried even if the updated data does not meet the trigger conditions.
2. When you want to manually retry, click Retry beside the data, and then click OK in the pop-up window.
Note:
If an automation fails to run, members can still modify its settings or form data. And the automation will run according to the latest settings.
3. After you retry, a trigger history will be created. The content includes:
- Time: the time of the retry
- User: the nickname of the member who manually retries
- Type: manual trigger
- Trigger: the type of the current trigger action, the title of the current trigger form, and the record title
- Run Result: the retrying result. If the retry fails, the Retry button will appear again.
For successful retry, Retry is changed to Executed.
Note:
Retry will only be displayed for seven days.
Notification for Failed Automation
Where to Set
To select a notification method for failed automations, go to Messages > Settings > System Logs > Failed Automation.
Method
Here are the two notification methods: System Messages and Email. The differences between them are as follows:
Method | Where to Check Notification | Selected by Default | Recipient |
System Messages | Go to Messages > System Logs. | Yes | Only the business owner and super admins allowed. And they are selected by default. |
Go to your email box. | No | Allowed to select other recipients. The business owner is selected by default. |
Setting Recipient
If you set Email as the notification method, set other recipients according your needs. Click Set Recipients and choose recipients, or add a new recipient by clicking Add Recipient. Then click OK to complete the settings.
Note:
If you set Email as the notification method, no more than five recipients can be set other than the business owner.
Note(s)
Because the Data Recycle feature is unavailable in the free plan, you cannot retry failed automations if you select Delete Record as the trigger.