Troubleshoot automation errors
AI summary
Identify why an automation failed using the Automation Batch Page, which groups runs by date and displays error messages. Common causes include hitting the 4-hour duration limit, exhausting daily API call limits, or reaching the Threshold limit for object processing. Failed runs are automatically retried at the next scan; if errors persist, contact support with the automation name and batch details.
Find out why an automation failed and run it again. The Automation Batch Page groups every run of an automation by date and shows the full error message of each failed run.
Before you begin
- Your Rencore role includes the Read AutomationAutomationAn automation is a workflow Rencore Governance runs on inventory objects when a trigger fires.Read more permission. Owner, Admin, Contributor and Reader have it. See Rencore roles.
Steps
Find the error
- Click Automation on the Nav Panel.
- Click the automation that is not behaving as expected. The Automation Batch Page opens, where every triggered run of the automation is grouped by date using its
GroupId. - Look for a batchAutomation batchAn automation batch is the group of automation runs that started from the same trigger at the same time.Read more with the status “Error” or “Stopped”.
- Click the Batch date/time to show every automation run for that period, including the one that failed.
- On the run with the error, click the ellipses menu ([…]) and select Show Details.
- Click the error message to see the full error message for that object run.
Rerun a failed automation
- On the Automation Batch Page, click the failed run to open its details.
- Click Rerun Automation. It only appears once a run has finished, with the status “Completed”, “Error” or “Stopped”. While a run is “Running”, you see Stop Automation instead.
What you see
Each run on the Automation Batch Page shows one of these statuses: New (queued, not yet started), Running (in progress), Completed (finished successfully), Error (failed during execution) or Stopped (halted manually or by the system before finishing).
A run stuck at New for more than 24 hours is treated like a failure: Rencore Governance reruns it automatically during the next scan, the same as it does for Error and Stopped runs.
Common causes of automation errors
- The run exceeded the maximum duration. Each automation run is limited to 4 hours. A run still going after that ends in “Error”.
- The daily API call limit was reached. Actions that call Microsoft 365Microsoft 365Microsoft 365 is the Microsoft cloud suite of Teams, SharePoint, OneDrive, Exchange and the Office apps.Read more APIs (for example, disabling a user or updating permissions) can fail once the automation’s daily API call allowance is used up.
- The threshold limitAutomation thresholdAn automation threshold, or threshold limit, caps how many objects an automation processes in one day.Read more was reached. Automations triggered “On Policy ViolationViolationA violation is an inventory object that matches the rule of an active policy, such as a Team with no owner.Read more” or “On Schedule” stop processing new objects for the day once they reach their Threshold limit (20% for new custom automations). Objects started before the limit are still processed, and Rencore Governance emails the recipients of the Thresholds in Automation notification. The objects above the limit do not show up as “Error” on the Batch Page. If you expect an automation to touch a larger share of the inventory, open the automation, go to the Details step and raise or clear its Threshold limit.
When Rencore retries automatically
Rencore Governance also retries some failed runs without any action on your part:
- Runs that end with the status “Error” or “Stopped” are retried at the next scan.
- Runs stuck at the status “New” for more than 24 hours are also rerun at the next scan.
If it does not work
If a run keeps ending in “Error” after several automatic retries, do not keep waiting on the automatic retry. Contact your Customer Success Manager or [email protected] with the automation name and the Batch date/time of the failing run, so support can investigate the underlying cause.
Frequently asked questions
How do I find the full error message of a failed automation run?
Click Automation on the Nav Panel and open the automation. On the Automation Batch Page, click the Batch date/time of the batch with the status Error or Stopped. On the failed run, click the ellipses menu, select Show Details, and click the error message.
Why can I not see the rerun automation button?
Rerun Automation only appears once a run has finished with the status Completed, Error or Stopped. While a run has the status Running, you see Stop Automation instead.
Why did my automation run end in error after running for a long time?
Each automation run is limited to 4 hours. A run that is still going after that ends in Error. Reaching the daily API call limit can also cause actions that call Microsoft 365 APIs to fail.
Why did my automation stop processing objects without showing an error?
The automation probably reached its Threshold limit, which is 20% for new custom automations. Objects above the limit do not show as Error on the Batch Page. To change it, open the automation, go to the Details step and raise or clear the Threshold limit.
Does Rencore Governance retry failed automation runs automatically?
Yes. Runs with the status Error or Stopped are retried at the next scan. Runs stuck at New for more than 24 hours are also rerun at the next scan.
Was this page helpful?
Thanks for the feedback.
Thanks. What was wrong?