analytics-log-level

--analytics-log-level is a global parameter. You can use it to specify the amount of detail Liquibase provides in user-facing logs for Anonymous Analytics. It is available in Liquibase 4.30.0 and later. The default value is INFO.

Note: --analytics-log-level does not control what analytic data Liquibase collects. To enable or disable analytics, use --analytics-enabled.

Uses

--analytics-log-level controls the detail level of analytics logs displayed to the user.

To see a log of analytics data collected when you run a command, set both --log-level and --analytics-log-level to FINE. There is a JSON object at the end of the output containing the analytics for the command.

You can set --analytics-log-level to the following values:

  • SEVERE (least verbose): Show serious failures that may prevent program execution.
  • WARNING: Show potential problems for program execution.
  • INFO: Show informational messages.
  • FINE (most verbose; formerly DEBUG): Show tracing information of program execution and minor failures.
  • OFF: Hide all log messages.

For more information about log levels, see the --log-level page.

Syntax

You can set this parameter in the following ways:

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

JVM system property (JAVA_OPTS Environment Variable)

JAVA_OPTS=-Dliquibase.analytics.logLevel=<string>
Liquibase Environment Variables
LIQUIBASE_ANALYTICS_LOG_LEVEL=<string>

For more information, see Working with Command Parameters.

Related links