Skip to main content


Monitor allows you to view groups of logs for all the integrations that you have turned on in Composer. Access to logs is critical for building, deploying, and supporting your integrations.

Log Retention

Logs and step results are retained for 14 days and are purged thereafter.

Viewing Logs for Integrations

To see logs for all your instances:

  1. Go to Composer > Monitor.
  2. Select Logs. You see log messages, their timestamps in your local time, the name of the instance and the name of the integration the instance was created from.


  1. To see a log's details, select the log you want for the instance you are interested in.


  2. Select View in Execution Context to view the execution details. The type of information displayed includes:

    • The trigger that created an event.
    • Release data.
    • Any files that caused errors.


Searching and Filtering Logs

To search for specific messages in your logs, type part of the message into Search logs at the top of the page.

monitor mo For more information on a specific log line, click the log line to view an additional information panel.

Additionally, you can apply filters to your logs. Click the Filter list to the right of the search bar and select any of the following options:

  • Log Type - For example, apply the Connection Only filter if you are searching for authentication issues, such as when a connection fails to receive a token during an automatic refresh.
  • Log Severity - Apply filters to find messages according to their severity level.
    • fatal
    • Error
    • warn
    • info
    • debug
    • trace
    • metric
  • Timestamps - For example, use start date/time and end date/time to create a range to search within.
  • Instance - Apply filters to find messages from specific parts of an integration.


Viewing Connection Logs

Connections that are used for testing in Builder, and those assigned to deployed instances, create logs. If a connection ever throws a connection error (for example, if the credentials in the connection have expired), you will see that in the connection's logs.

To view a connection's logs, click the log icon to the right of the connection.

What Gets Logged?

If a component invokes context.logger.{debug,info,warn,error}() within its code, the log line is saved in Monitor's logging system.

In addition to logs issuing from components, you will see the following types of log lines in your logs:

TypeExamplePurposeLog Level
Instance StartStarting Instance 'Sample Instance'Indicates when an instance begins to
Instance EndEnding Instance 'Sample Instance'Indicates that an instance ran successfully to
Step StartedFetch file from DropboxDisplays the name of the step that was
Step Failed{{ERROR MESSAGE}}Indicates that a step of an instance failed to run, and displays the related error message.error

Log Levels

Monitor has the following log levels. Logs are presented with a colored dot to indicate their severity.

monitor log dots