Files
Introduction
FME Flow Automations logs changed in FME Flow 2023.2. Instead of one log for the entire automation, each trigger, action, and external action now has its own log file. This lets you analyze each component individually if an error occurs.
What’s New
An automation can run in two modes: Production mode and Debug mode.
- Production mode creates a separate log file for each trigger and action. These log files contain information from multiple automations.
- Debug mode creates a single log file. The log file lists all triggers and actions in the order they happened. This is the same log file used in FME Flow 2023.1 and earlier.
We do not recommend running automations continuously in Debug mode because the logs are lost when the automation stops. Use Production mode when automations run after development and testing.
Production Mode
When an automation runs in Production mode, a green notification bar appears at the top of the canvas.
When you restart an automation in Production mode after running it in Debug mode, a message says that the Debug log file is removed when the automation starts.
To find the Production mode logs, use the drop-down menu on the Automations canvas, or go to Resources > Logs > automations > current. Each action and trigger has its own .log file.
Debug Mode
To enable Debug mode, click the Debug button to the right of the Start button at the top of the canvas.
When you start Debug mode, a warning dialog appears. The dialog states that Debug mode is not recommended for production environments. It also says that logs are not saved in Resources, but previous Production logs are still accessible. The dialog shows where to find the Debug log, and says the Debug log is cleared if the automation restarts.
When the automation runs in Debug mode, an orange notification appears at the top of the Automations canvas. The notification shows that you are in Debug mode and links to the log file. It stays visible while Debug mode is on.
In Debug mode, open the log files from the drop-down menu on the Automations canvas.
How to Combine Logs for One Automation
Reading many log files to find an error can be slow and difficult. This workspace reads each log file and writes the contents to one file for a single automation. Use the instructions below for FME Flow 2023.2 to 2024.1. For FME Flow 2024.2, use the instructions in the next section.
FME Flow 2023.2 to 2024.1
1. Download the Automation Log Files
To download all the automation log files in FME Flow, go to Resources > Logs > automations > current. Click the check box at the top-left to select all the automations. Click Actions at the top-right, and then click Download. This creates a .zip folder that contains all the automation logs.
2. Edit the Workspace for the Specific Automation and Time Frame
Open CombineAutomationLogs_2024.fmw in FME Workbench. Edit the reader named current and the writer named output.
2a. In the Navigator, click the arrow to expand the CSV2 reader named current. Right-click Source CSV and click Edit Parameter Value.
2b. Go to the location of the .zip folder that contains all the automation log files. Click OK.
2c. Click the arrow to expand the CSV2 writer named output. Right-click Destination CSV and click Edit Parameter Value.
2d. Select an output location for the combined log file.
2e. Save the workspace.
3. Adjust User Parameters
Three user parameters can be set at run time or in the Navigator. They are StartDateTime, EndDateTime, and AutomationID. To set them now, right-click the parameter and click Edit Value.
The most important user parameter is AutomationID. It is an alphanumeric string in the automation URL on FME Flow. Change this parameter for each run to combine the logs of other automations.
StartDateTime and EndDateTime can be customized to see a specific time frame. Otherwise, enter the current date and time for EndDateTime.
4. Run the Workspace and Create the Combined Log File
On the top menu, click Run > Rerun Entire Workspace. The Translation Parameter Values dialog opens.
4a. To select the start or end date, click the down arrow in the box to open a calendar.
4b. Click Run. FME creates a log file in the location you set for the output parameter in step 2c.
FME Flow 2024.2
FME Flow 2024.2 lets you download the combined automation log. To do this, open any automation that runs in Production mode and click Download log in the drop-down menu.
A dialog opens. Select a start date to enable the Download button. Click Download to get the combined log file.