Skip to main content
Version: 10 - TBD

Logs

Engine collects information provided by various resources and activities about their state changes, operations and more. This information is displayed in the "Logs" tab of the respective resource and collectively under Workspace Logs.

In Engine, the following provide logs:

  • Executions
  • Git configs
  • Sync configs
  • Users
  • Webhooks
  • Workspaces

Logs are dynamically updated, so you can follow along even during an execution.

Log Levels​

Logs are colour coded so you can easily distinguish between their severity. Here are the different levels and their respective colours:

  • Info - no colour
  • Warning - yellow
  • Error - red

Here you can see all 3 types of log levels.

The Logs Tab​

Once you navigate to the logs tab, the information is displayed in a table form.

The "Subject" column is always filled out (e.g.: creating execution) and is searchable. The "Data" column contains additional information if applicable (like input values for creating an execution). Besides displaying information, logs also include links to related resources and activities in the "References" column as seen in the picture below:

The logs tab of a webhook. Clicking on the lightning symbol opens the execution that called the webhook.

User Logs​

Besides logs generated automatically by the system, you can log additional information with the flow_api method this.log(). For this refer to execution methods and look for log.

note

The subject of logs generated by this.log() is 'user log'. In older versions of Engine, user logs appear on the 'Output' tab not on the 'Logs' tab.

Workspace Logs​

If you want to see all logs that were created within your workspace, you can find them under Workspace Logs. For this click on the gear icon and choose "Workspace Logs".

You can access workspace logs through this menu

Logs are displayed similarly to logs on individual resources/activities, with the addition of the column "Record", which is searchable by name or id.

You can filter for logs of a specific type or log level.

The workspace logs

You can filter for specific types

You can filter for specific log levels

Finding Deprecation Notes​

Engine changes with time as new features are introduced and other features get improved or even removed. Since removing features can break existing processes, it doesn't happen overnight. When a feature is set for removal, first a deprecation note is added.

Let's say there is a flow API method that will be removed in the future. Every time this method is called by an execution, the execution will log that this feature is deprecated. A simple way to look for deprecation notes within your whole workspace, is to head over to the workspace logs and search for 'deprecat' in the subject field.

Here's how you can get an overview of deprecation notes in the workspace logs

warning

Deprecation notes are only created if a deprecated flow API method is called. If parts of your scripts contain deprecated features but those parts are not usually executed (for example they cover edge cases that only happen infrequently, or are scheduled only yearly) they might not create deprecation notes.

Similarly, if you delete logs for security reasons, you won't find deprecation notes.

In these cases you can only find deprecated features by analyzing your scripts e.g. by exporting them and using the search function on an IDE to look for deprecated methods.