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:
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.
To see a log's details, select the log you want for the instance you are interested in.
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.
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
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:
Type | Example | Purpose | Log Level |
---|---|---|---|
Instance Start | Starting Instance 'Sample Instance' | Indicates when an instance begins to run. | info |
Instance End | Ending Instance 'Sample Instance' | Indicates that an instance ran successfully to completion. | info |
Step Started | Fetch file from Dropbox | Displays 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
andinfo
lines are presented with green dots.warn
lines are presented with yellow dots.error
lines are presented with red dots.