jgilaber
9132e604b6
As agreed in the PTG [1], deprecate the prometheus datasource in favor of aetos, to be removed in a future release. The change marks the prometheus datasource as deprecate, changes the default value of the watcher_datasources config option (replacing prometheus by aetos), updates both aetos and prometheus datasources documentation and adds a migration guide detailing how to migrate a Watcher using prometheus to use aetos. [1] https://etherpad.opendev.org/p/watcher-2026.1-ptg#L207 Assisted-By: claude-code (clade-sonnet-4.5) Change-Id: Id93a5e6a02dab40390eff744b474acd08ca85fa5 Signed-off-by: jgilaber <jgilaber@redhat.com>
39 lines
1.6 KiB
YAML
39 lines
1.6 KiB
YAML
---
|
|
deprecations:
|
|
- |
|
|
The Prometheus datasource (``prometheus``) is now deprecated in favor of
|
|
the Aetos datasource (``aetos``). The Aetos datasource provides the same
|
|
Prometheus-based metrics collection functionality with the following
|
|
additional benefits:
|
|
|
|
* Multi-tenancy support through Keystone authentication
|
|
* Role-Based Access Control (RBAC) for metric access
|
|
* Better integration with OpenStack security patterns
|
|
* All Prometheus query functionality (PromQL) is preserved
|
|
|
|
The Prometheus datasource will be removed in a later release.
|
|
|
|
Deployers using the Prometheus datasource should migrate to Aetos.
|
|
See the migration guide at:
|
|
https://docs.openstack.org/watcher/latest/admin/datasources/migrate-prometheus-to-aetos.html
|
|
|
|
upgrade:
|
|
- |
|
|
If you are currently using the Prometheus datasource
|
|
(``datasources = prometheus`` in ``[watcher_datasources]``), you should
|
|
plan to migrate to the Aetos datasource.
|
|
|
|
The migration requires:
|
|
|
|
* Deploying the Aetos reverse-proxy service
|
|
* Updating Watcher configuration to use ``datasources = aetos``
|
|
* Configuring Aetos endpoint in Keystone catalog
|
|
* Updating the ``[aetos_client]`` configuration section
|
|
|
|
For detailed migration steps, see the migration guide.
|
|
|
|
The default value for the 'watcher_datasources' option has changed from
|
|
"['gnocchi', 'monasca', 'grafana', 'prometheus']" to
|
|
"['gnocchi', 'monasca', 'grafana', 'aetos']". See
|
|
https://docs.openstack.org/watcher/latest/configuration/watcher.html#watcher-datasources for more details
|