Current Series Release Notes¶
24.0.0-59¶
New Features¶
Ceilometer is now able to poll the /metrics endpoint in Aodh to get evaluation results metrics.
The
image_meta
metadata structure for compute meters was formerly only available via the notification meters. When using Nova 2025.2 Flamingo or later,image_meta
is now also supplied by the compute pollsters. This is now possible due to the addition of the relevant metadata to the libvirt guest XML.
The built-in
meters.yaml
has been updated to publish theimage_meta
metadata attribute for compute notification meter samples by default.
A
map
event trait plugin has been added. This allows notification meter attributes to be created by mapping one set of values from an attribute to another set of values defined in the meter definition. Additional options are also available for controlling how to handle edge cases, such as unknown values and case sensitivity.
Added a new
memory.available
compute pollster metric, for tracking the amount of memory available within the instance, as seen by the instance. This can be combined withmemory.usage
in Gnocchi aggregate queries to get memory usage for an instance as a percentage.
The
memory
meter now has measures published by a compute pollster, in addition to the existing notification meter.
Added the following meters to the central agent to capture these metrics for each storage pool by API.
volume.provider.pool.capacity.total
volume.provider.pool.capacity.free
volume.provider.pool.capacity.provisioned
volume.provider.pool.capacity.virtual_free
volume.provider.pool.capacity.allocated
The
vcpus
meter now has measures published by a compute pollster, in addition to the existing notification meter.
Enhanced the Prometheus exporter to support TLS for exposing metrics securely.
When using Nova 2025.2 and later, the flavor ID for an instance is now available from the libvirt domain metadata. Ceilometer now takes advantage of this and populates the flavor ID from metadata instead of querying Nova, when the value is available. If not available from metadata, Ceilometer will fallback to querying Nova API for the flavor ID.
When using Nova 2025.2 and later, the extra specs for the flavor and instance is running is now available from the libvirt domain metadata. Ceilometer now adds the flavor’s extra specs to compute sample metadata when found.
Added the
[compute]/fetch_extra_metadata
configuration option, which allows configuration of whether or not Ceilometer fetches additional compute instance metadata attributes that require Nova API queries. This mainly affects theuser_metadata
attributes populated with metering-related values such as the server group an instance is part of. Whenfetch_extra_metadata
is set toFalse
, Ceilometer Compute Agent will not query Nova API for anything unless absolutely necessary.
The deprecated
[service_types] cinderv2
option has been removed. Use the[service_types] cinder
option instead.
Introduce
threads_to_process_pollsters
to enable operators to define the number of pollsters that can be executed in parallel inside a polling task.
Upgrade Notes¶
meters.yaml
has been updated to addimage_meta
to compute meter samples by default.
In order for the new image metadata attributes to start being populated from libvirt metadata in pollster samples, Nova must be upgraded to 2025.2 Flamingo or later (older versions are still backwards compatible, but the new attributes will not be available via pollster samples). Existing instances will need to be shelved-and-unshelved or cold migrated for the metadata to be populated.
After Nova has been upgraded to 2025.2 or later, new instances will start providing additional flavor metadata for Ceilometer to use. Instances already running at the time of the upgrade are not updated as part of the process; to update those instances they will need to be cold restarted, cold migrated or shelved-and-unshelved (until this happens, Nova API queries will continue to be performed for those instances).
The
instance
resource type has been updated to make thehost
resource attribute optional. This allows the hypervisor a compute instance is running on to be withheld from Gnocchi’s resource metadata, which may be required for security reasons e.g. for public clouds.
The
ip.floating
andnetwork.services.vpn
pollsters now publish samples for all found floating IPs and VPNs, even if they are known to have an unknown state, when they would previously be dropped. The volume of samples for such floating IPs and VPNs will be set to-1
. This improves visibility of floating IPs and VPNs with unknown states, allowing them to be monitored via samples and the Gnocchi metrics, making it easier to discover such resources for troubleshooting. It also moves some of the “business logic” for downstream rating/billing services such as CloudKitty out of Ceilometer itself.
The
network.services.vpn
now publishes samples for VPNs with statusERROR
, when they would previously be dropped. The sample volume for VPNs inERROR
state is7
.
Support for Intel Node Manager was removed.
Support for Python 3.9 has been removed. Now Python 3.10 is the minimum version supported.
Deprecation Notes¶
The
[DEFAULT] http_timeout
option has been deprecated because it is unused.
Support for pollster builder has been deprecated, because ceilometer no longer provides any built-in pollster builder now.
The newly added
[compute]/fetch_extra_metadata
option is set toTrue
by default, but to reduce the amount of load Ceilometer places on Nova this will be changed toFalse
by default in a future release.
Bug Fixes¶
Fixed bug #2113768 where the Libvirt inspector did not catch exceptions thrown when calling interfaceStats function on a domain.
[bug 2113903] Fix volume provider pool capacity metrics for ceph backend.
24.0.0¶
Deprecation Notes¶
The
[polling] tenant_name_discovery
option has been deprecated in favor of the new[polling] identity_name_discovery
option.