analytics-log-level

Last updated: September 2, 2025

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