2025.1 Series Release Notes

14.0.0-7

New Features

  • A new module, watcher.wsgi, has been added as a place to gather WSGI application objects. This is intended to ease deployment by providing a consistent location for these objects. For example, if using uWSGI then instead of:

    [uwsgi]
 wsgi-file = /bin/watcher-api-wsgi

    You can now use:

    [uwsgi]
module = watcher.wsgi.api:application

    This also simplifies deployment with other WSGI servers that expect module paths such as gunicorn.

Deprecation Notes

  • The watcher-api-wsgi console script is deprecated for removal in a future release. This artifact is generated using a setup-tools extension that is provide by PBR which is also deprecated. due to the changes in python packaging this custom extensions is planned to be removed form all OpenStack projects in a future PBR release in favor of module based wsgi applications entry points.

Bug Fixes

  • When using prometheus datasource and more that one target has the same value for the fqdn_label, the driver used the wrong instance label to query for host metrics. The instance label is no longer used in the queries but the fqdn_label which identifies all the metrics for a specific compute node. see Bug 2103451: https://bugs.launchpad.net/watcher/+bug/2103451 for more info.

14.0.0

Prelude

The Openstack 2025.1 (Watcher 14.0.0) includes several new features, deprecations, and removals. After a period of inactivity, the Watcher project moved to the Distributed leadership model in 2025.1 with several new contributors working to modernize the code base. Activity this cycle was mainly focused on paying down technical debt related to supporting newer testing runtimes. With this release, ubuntu 24.04 is now officially tested and supported.

Ubuntu 24.04 brings a new default Python runtime 3.12 and with it improvements to eventlet and SQLAlchemy 2.0 compatibility where required. 2025.1 is the last release to officially support and test with Ubuntu 22.04.

2025.1 is the second official skip-level upgrade release supporting upgrades from either 2024.1 or 2024.2

Another area of focus in this cycle was the data sources supported by Watcher. The long obsolete Ceilometer API data source has been removed, and the untested Monasca data source has been deprecated and a new Prometheus data source has been added. https://specs.openstack.org/openstack/watcher-specs/specs/2025.1/approved/prometheus-datasource.html

New Features

  • Support for instance metrics has been added to the prometheus data source. The included metrics are instance_cpu_usage, instance_ram_usage, instance_ram_allocated and instance_root_disk_size.

Upgrade Notes

  • Python 3.8 support has been dropped. Last release of watcher supporting python 3.8 is 13.0.0. The minimum version of Python now supported is Python 3.9.

  • Ceilometer datasource has been completely removed. The datasource requires ceilometer API which was already removed from Ceilometer. Use the other datasources such as Gnocchi.

Deprecation Notes

  • Monasca Data Source is deprecated and will be removed in the future, due to inactivity of Monasca project.

Bug Fixes

  • A number of linting issues were addressed with the introduction of pre-commit. The issues include but are not limited to, spelling and grammar fixes across all documentation and code, numerous sphinx documentation build warnings , and incorrect file permission such as files having the execute bit set when not required. While none of these changes should affect the runtime behavior of Watcher, they generally improve the maintainability and quality of the codebase.