2023.1 Series Release Notes

5.2.0

Other Notes

  • This release reverts the fix for Bug #1983863: Fixed logging in eventlet native threads. This fix caused gate problems during cross-project testing and needed to be removed from 2023.1 Antelope release.

5.0.1

Bug Fixes

5.0.0

Bug Fixes

  • Initialise the global_request_id context variable with a default value if the key is not passed in the context.

4.8.0

Upgrade Notes

  • Default value of the [DEFAULT] logging_user_identity_format option has been updated and now includes system scope information by default.

  • Default value of the [DEFAULT] logging_context_format_string option has been updated and now Global Request IDs are logged by default.

4.7.0

Upgrade Notes

  • The logging_user_identity_format option’s default value is updated to replace the obsolete tenant argument with project.

4.2.0

Bug Fixes

  • Using systemd journal handler, logs ending up in kern.log because SYSLOG_FACILITY is missing. This fix uses the same facility configuration option ‘syslog-log-facility’ as from syslog handler to provide the missing value. (Bug #1871840)

4.0.0

Upgrade Notes

  • Python 2.7 is no longer supported. The minimum supported version of Python is now Python 3.6.

3.42.0

New Features

  • The following new config options will allow rotating log files, especially useful on Windows: * log_rotate_interval * log_rotate_interval_type * max_logfile_count * max_logfile_size_mb * log_rotation_type

3.41.0

New Features

  • Added Windows EventLog functionality to oslo.log. Set use_eventlog to true in the service’s configuration file to use it.

3.35.0

Bug Fixes

  • The JSONFormatter formatter now converts unserialisable objects with repr() to prevent JSON serialization errors on logging. The fix requires oslo.serialisation 2.21.1 or newer. (Bug #1593641)

3.34.0

New Features

  • The JSON based formatters (namely JSONFormatter and FluentFormatter) now output an extra section called ‘context’ that contains the context-related keys and values, e.g. user, project and domain.

3.33.0

New Features

  • The use_json configuration option was added. It enables JSON formatting in the logs when set to True. The option is also available through the command line via the --use-json flag.

3.27.0

New Features

  • If the log format string includes %(error_summary)s, it will be replaced with a summary of the current error when there is one and with “-” when there is no error. If the log format string does not include %(error_summary)s the error summary will be appended to the end of the line automatically, only if there is an error.

3.24.0

New Features

  • Systemd native journal support is added. You can enable this in services with the use_journal flag.

3.21.0

New Features

  • A new oslo_log.log.is_debug_enabled helper function is added that allows to determine whether debug mode is enabled for logging.

3.17.0

Upgrade Notes

  • Configuration option use_stderr’s default value is False now, this will avoid same logs on service log and specific log file by option –log-file.

3.12.0

New Features

  • The log_config_append configuration option is now mutable and the logging settings it controls are reconfigured when the configuration file is re-read. This can be used to, for example, change logger or handler levels.

3.8.0

Upgrade Notes

  • The deprecated ‘verbose’ option has been removed.

Bug Fixes

  • When removing the “verbose” option, the default logging level was set to “WARNING” by mistake. Fixed it back to “INFO”.

3.2.0

Upgrade Notes

  • The deprecated use_syslog_rfc_format configuration option has been removed.

3.1.0

Upgrade Notes

  • The deprecated log_format configuration option has been removed.

Other Notes

  • Switch to reno for managing release notes.