Log entry deletion
Grafana Loki supports the deletion of log entries from a specified stream. Log entries that fall within a specified time window and match an optional line filter are those that will be deleted.
Log entry deletion is supported only when the BoltDB Shipper is configured for the index store.
The compactor component exposes REST endpoints that process delete requests. Hitting the endpoint specifies the streams and the time window. The deletion of the log entries takes place after a configurable cancellation time period expires.
Log entry deletion relies on configuration of the custom logs retention workflow as defined for the compactor. The compactor looks at unprocessed requests which are past their cancellation period to decide whether a chunk is to be deleted or not.
Enable log entry deletion by setting
retention_enabled to true in the compactor’s configuration and setting and
filter-and-delete in the runtime config.
Because it is a runtime configuration,
deletion_mode can be set per-tenant, if desired.
filter-only, log lines matching the query in the delete request are filtered out when querying Loki. They are not removed from storage.
filter-and-delete, log lines matching the query in the delete request are filtered out when querying Loki, and they are also removed from storage.
A delete request may be canceled within a configurable cancellation period. Set the
delete_request_cancel_period in the compactor’s YAML configuration or on the command line when invoking Loki. Its default value is 24h.
As long as the
compactor.retention_enabled setting is
true, the API endpoints will be available. Afterwards, access to the deletion API can be enabled per tenant via the
deletion_mode tenant override.
Related Loki resources
Getting started with logging and Grafana Loki (Part 3 of 4)
Join this webinar to learn why correlating metrics and logs is critical across the development lifecycle, and how Loki helps reduce logging costs and operations overhead.
Logging with Loki: Essential configuration settings
This webinar focuses on Grafana Loki configuration including agents Promtail and Docker; the Loki server; and Loki storage for popular backends.