PluginsCoreExecution

PurgeExecutions​Purge​Executions

Purge executions, logs, metrics, and storage files.

This task can be used to purge flow executions data for all flows, for a specific namespace, or for a specific flow.

yaml
type: "io.kestra.plugin.core.execution.PurgeExecutions"

Purge all flow execution data for flows that ended more than one month ago.

yaml
id: "purgeexecutions"
type: "io.kestra.plugin.core.execution.PurgeExecutions"
endDate: "{{ now() | dateAdd(-1, 'MONTHS') }}"
states: 
 - KILLED
 - FAILED
 - WARNING
 - SUCCESS
Properties

The date before which data should be purged.

All data of flows executed before this date will be purged.

The flow ID to be purged

You need to provide the namespace properties if you want to purge a flow.

Namespace whose flows need to be purged, or namespace of the flow that needs to be purged

If flowId isn't provided, this is a namespace prefix, else the namespace of the flow.

Default true

Flag specifying whether to purge executions

Default true

Flag specifying whether to purge execution logs

This will only purge logs from executions, not from triggers, and it will do it execution by execution. The io.kestra.plugin.core.log.PurgeLogs task is a better fit to purge, as it will purge logs in bulk and will also purge logs not tied to an execution like trigger logs.

Default true

Flag specifying whether to purge execution's metrics.

Default true

Flag specifying whether to purge execution's files from the Kestra's internal storage

The date after which data should be purged

All data of flows executed after this date will be purged.

SubType string
Possible Values
CREATEDRUNNINGPAUSEDRESTARTEDKILLINGSUCCESSWARNINGFAILEDKILLEDCANCELLEDQUEUEDRETRYINGRETRIEDSKIPPEDBREAKPOINT

The state of the executions to be purged

If not set, executions for any states will be purged.

Default 0

The count of deleted executions

Default 0

The count of deleted logs

Default 0

The count of deleted metrics

Default 0

The count of deleted storage files