• Reference
  • Version · 5.2.2
  • Reference guide

analytics-log-level

Last updated: August 12, 2026

--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)

Unix:

JAVA_OPTS=-Dliquibase.analytics.logLevel=<string>

Windows:

JAVA_OPTS=-D"liquibase.analytics.logLevel"=<string>

Liquibase environment variables

LIQUIBASE_ANALYTICS_LOG_LEVEL=<level>

Previousanalytics-enabledNextauto-reorg