Rebrand 2023 Learn more 

  • Monitor/
    Logging

    Logging

    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.

    Viewing Logs for Integrations

    To see logs for all your instances:

    1. Go to Composer > Monitor. 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.

      monitor

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

      monitor

    3. 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.

      monitor

    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

    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
    • Log Severity
      • fatal
      • Error
      • warn
      • info
      • debug
      • trace
      • metric
    • Timestamps, for example, start date/time and end date/time.
    • Instance

    monitor

    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 run.info
    Instance EndEnding Instance 'Sample Instance'Indicates that an instance ran successfully to completion.info
    Step StartedFetch file from DropboxDisplays the name of the step that was invoked.info
    Step Failed{{ERROR MESSAGE}}Indicates that a step of an instance failed to run, and displays the related error message.error

    Log Levels

    Log levels include:

    • debug
    • info
    • warn
    • error

    Logs are presented with a colored dot to indicate their severity.

    • debug and info lines are presented with green dots.
    • warn lines are presented with yellow dots.
    • error lines are presented with red dots.

    monitor log dots

    Was this helpful?