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 the image_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 with memory.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 the user_metadata attributes populated with metering-related values such as the server group an instance is part of. When fetch_extra_metadata is set to False, 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 add image_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 the host 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 and network.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 status ERROR, when they would previously be dropped. The sample volume for VPNs in ERROR state is 7.

  • 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 to True by default, but to reduce the amount of load Ceilometer places on Nova this will be changed to False 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.