# Workato Logging Service

Learn how to use Workato Logging service in 3min

Logging is an essential tool for testing, troubleshooting, and debugging. Workato logging service provides a centralized storage for collecting log entries and an easy way to search through log entries.

Log entry data Example log entry data

Cannot find Workato logging service?

Workato logging service is an added capability. This includes access to the logs page and Logger by Workato. Check with your Workato CSM to ensure that you have this capability enabled for your Workspace.

If your account is managed by Workato teams, your role must also have the Workato Logs Service Privilege.

# Why Use Workato Logging Service

Workato logs is a centralized storage of log entries from your recipes.

Steps that are repeated in a loop are not fully visible from the job reports, as only the last execution of that step is displayed. Logging provides visibility into each iteration of repeated steps. This makes it easier to troubleshoot and debug steps which are nested within a loop.

Some business objects like customer accounts are integrated into multiple workflows. Logging allows you to track every time a recipe interacts with a certain customer (for example, customer account ACME Corp). Parsing through log data to find a single customer is easy with Workato logging service. You can filter logs with a search term or by recipe ID. Find out more about searching through logs entries

Adding log entries is easy with Logger by Workato. Use log levels to make filtering logs easily from the logs table, for example, to find logs with ERROR log level.

# Where to find the Logs Page

Navigate to Tools > Logs.

Workato Logging Service Workato Logging Service

Open it in-product

As each data center is independent, use the following links to open Workato Logging service for your region.

# Query and Find Log Entries

Each log entry will contain metadata about when it was created, and by which recipe and job. You can use the filters to find the logs that are you most interested in. You may also search the log entries by the content of the log data.

Searching logs Searching Logs

Log field Description
Time The time this log entry was created. This will be displayed in the Workspace timezone.
Source Where the log entry originated from.

Note: As log entries can only by created by Logger by Workato currently, this field cannot used as a filter.
Log Level Possible log levels are INFO, WARN, and ERROR.
Data The log message from Logger by Workato.
Recipe ID The recipe ID.
Job ID The job ID.
Step number The step number of the action in the recipe that created this log.
Connector The connector which created the log entry.

Note: As log entries can only by created by Logger by Workato currently this field cannot used as a filter.
Action The actions which created the log entry.

Note: As log entries can only by create by Logger by Workato currently, this field cannot used as a filter.

# Log Entry Details

Click on the log entry to expand the log data. This will display the full log message.

You can perform a finer search within the log message.

Log entry data Log entry data

# Add Log Entry with Logger by Workato


Under App selection, choose Logger by Workato.


Toggle Send to Workato Logs and select the log level. Possible log levels are INFO, WARN, and ERROR.

This will create a log entry for every job, including test jobs.

Logger by Workato Logger by Workato

Log entries may take a few minutes to appear in the Logs Page

The log entry data size may affect how long it takes for the logs entries to be available in the logs page

# Log retention

Each log will be retained for 30 days. Workato will only display the most recent 1,000,000 log entries.