Troubleshooting Automations

There are several issues that can cause automations to fail. When these issues occur, you may see effects such as some files successfully being transferred while others fail or some operations may fail completely.

Accessing Automation Logs

The Files.com platform saves detailed logging information for every automation workflow operation. We track the Status, Creation and Completion timestamps, Operation type, Path, Destination and also error details in case of any failure.

You can check the Automations Run Logs by visiting the Run Logs for the automation.

Use a process of elimination to determine the exact cause of the failure. Typical failures reasons are listed below:

Race Conditions

If you have multiple automations that act on the same source files, it's not possible to predict which automation will act first. You should avoid creating multiple automations that use the same sources. As an example, rather than creating one automation which copies files from a folder and a second automation that deletes the files from that folder, make a single automation that moves the files from the folder.

Throttling

If your automation workflow is configured to exchange files with a remote server based on some triggers, the remote server can have their own limits on incoming or outgoing connection volumes or even bandwidth. These limits are applied by the external systems and not by the Files.com platform. For example, if the automation is to copy files from an Microsoft Azure mount to Files.com, you may run into a throttling limit set by Azure. Azure would send back a throttling error which will be shown as a Failed Automation. In this case, please check the remote server's throttling or activity or connection limits.

Same Size Files with Copy Automation

By default, the Copy File automation skips copying files if an identical-sized file already exists in the destination. This is done to prevent wasteful data transfer and overages. You can modify this default behavior in your automation by selecting the appropriate option under Overwrite the existing files with new ones in the destination selection screen while creating a new automation or modifying an existing automation. We recommend keeping this option disabled to avoid accidental wasted data transfer usage.

Folders With Large Number of Files

If your automations workflow is configured on folders with a large number of files, the automation will be at risk of being disabled. Please refer to Folder Limitations for more information.

Consider using automatic file organization by file extension, creation date, modification date, or regular expression to move files from large folders into subfolders, creating smaller, more manageable collections.

Source Not Found

If your automation workflow is configured to do some action based on a source folder or a file and if that source folder or file is not found, automation will result as failure and logged. In this case, check the Automation workflow and make sure the triggers and actions are configured properly.

Destination Exists

If your automation workflow is configured to move or copy the files and the file or folder already exists on the target when automation runs, automation may fail and logged as failure. This happens typically when multiple workflows are configured to target the same folder paths. In this case, check your folders paths in all automation workflows.

Using Wildcards

If you are using wildcards in the folder paths, make sure that the matching patterns are properly applied. For example, if you want to copy all files and folders under the folder Partners/Invoices/ to some remote folder and if the Folder path set as Partners/Invoices/ in workflow, then the automation will copy any files under sub folders of Invoices folder but it won't copy files which are directly under the Invoices folder. In this case, check the wildcard patterns and use * or ** accordingly. If the Folder path is on a remote server, then the Folderpath does not support wildcards, and attempting to include "All subfolders" (with the ** pattern) or "Top-level subfolders" (with the * pattern) will result in an error "No folder paths matched."

Open Files

When using a Remote Server Mount with an Automation, open files and 3rd party locks can cause partial or corrupt files.

As a best practice, open files (those that are in the process of being updated or modified) should never be included as the source or destination of an Automation.

Zero Byte Size Files

If your workflow is configured to be triggered based on the file creation and modification and the corresponding file size is zero bytes, automation may fail particularly when you are exchanging files with 3rd party services (example, Azure storage) and error may not be logged in Files.com platform. In this case, check with the remote server's configuration on zero byte size files.

Timeout Errors or Network Issues

Automation workflow triggers or actions may fail due to various network related issues. If Files.com platform detects any timeout or network related issues, corresponding information will be logged as failure in the logs. But, if the automation is not running as expected and there are no errors in Files.com logs, it is possible that there might be a network issues connecting to remote servers. This can usually happens when multiple network layers are involved in workflow. In this case, please make sure that the remote server sync or mount connections are active in Files.com.

Get Instant Access to Files.com

The button below will take you to our Free Trial signup page. Click on the white "Start My Free Trial" button, then fill out the short form on the next page. Your account will be activated instantly. You can dive in and start yourself or let us help. The choice is yours.