nova/releasenotes/notes/archive-task-logs-fa9dd7c5859b5e30.yaml
melanie witt d093849c3c Correct reno for archiving task_log database records
The release note incorrectly stated that the Telemetry service calls
the /os-instance_usage_audit_log REST API to retrieve instance usage
data. Telemetry rather consumes the notifications that are only generated
when [DEFAULT]instance_usage_audit=True.

Related-Bug: #1877189

Change-Id: Iea358090c42877bedfdcc4a04019f6dc406176c2
2021-07-16 21:57:45 +00:00

26 lines
1.3 KiB
YAML

features:
- |
A ``--task-log`` option has been added to the ``nova-manage db
archive_deleted_rows`` CLI. When ``--task-log`` is specified, ``task_log``
table records will be archived while archiving the database. The
``--task-log`` option works in conjunction with ``--before`` if operators
desire archiving only records that are older than ``<date>``. The
``updated_at`` field is used by ``--task-log --before <date>`` to determine
the age of a ``task_log`` record for archival.
The ``task_log`` database table contains instance usage audit records if
``nova-compute`` has been configured with ``[DEFAULT]instance_usage_audit =
True``. This will be the case if OpenStack Telemetry is being used in the
deployment, as the option causes Nova to generate audit notifications that
Telemetry consumes from the message bus.
Usage data can also be later retrieved by calling the
``/os-instance_usage_audit_log`` REST API [1].
Historically, there has been no way to delete ``task_log`` table records
other than manual database modification. Because of this, ``task_log``
records could pile up over time and operators are forced to perform manual
steps to periodically truncate the ``task_log`` table.
[1] https://docs.openstack.org/api-ref/compute/#server-usage-audit-log-os-instance-usage-audit-log