log-channels

The log-channels parameter controls which "channels" are logged when running Liquibase commands.

Uses

The channel is shown in each log entry in the second set of brackets. For example, in [2022-05-20 12:52:34] FINE [liquibase.database] Connection has been created the channel is liquibase.database.

Channels are hierarchical, so the above message will be shown if log-channels is set to liquibase or liquibase.database

The default value is liquibase. Multiple channels can be specified by comma-separating them. For example, --log-channels=liquibase,com.microsoft. To enable all logging, regardless of the channel, use --log-channels=all

The level the specified channels are logged at is controlled by the log-level setting, even if that level is OFF.

Syntax

You can set this parameter in the following ways:

Option Syntax
Liquibase properties file (defaults file) 
liquibase.logChannels: <string>
Global flow file argument (example) 
stages:
  Default:
    actions:
      - type: liquibase
        command: update
        globalArgs: { log-channels: "<string>" }
Global CLI parameter 
liquibase
 --log-channels=<string> update
 --changelog-file=example-changelog.xml

JVM system property (JAVA_OPTS Environment Variable)

 
JAVA_OPTS=-Dliquibase.logChannels=<string>
Liquibase Environment Variables 
LIQUIBASE_LOG_CHANNELS=<string>

For more information, see Working with Command Parameters.

Related links