Core Plugins and tasks PurgeLogs

Core Plugins and tasks PurgeLogs

Certified

Purge execution and trigger logs.

Deletes logs in bulk by namespace/flow/execution filters and optional level/date ranges. Requires namespace authorization when targeting other namespaces.

For performance, use this instead of per-execution deletions; consider keeping ERROR logs by filtering logLevels.

yaml
type: io.kestra.plugin.core.log.PurgeLogs

Purge all logs that has been created more than one month ago.

yaml
    id: purge
    namespace: system

    tasks:
      - id: purge_logs
        type: io.kestra.plugin.core.log.PurgeLogs
        endDate: "{{ now() | dateAdd(-1, 'MONTHS') }}"

Purge all logs that has been created more than one month ago, but keep error logs.

yaml
    id: purge
    namespace: system

    tasks:
      - id: purge
        type: io.kestra.plugin.core.log.PurgeLogs
        endDate: "{{ now() | dateAdd(-1, 'MONTHS') }}"
        logLevels:
          - TRACE
          - DEBUG
          - INFO
          - WARN
Properties

The maximum date to be purged

All logs before this date will be purged.

The Execution ID of the logs to be purged

The flow ID of the logs to be purged

You need to provide the namespace property if you want to purge flow logs.

SubTypestring
Possible Values
ERRORWARNINFODEBUGTRACE

The levels of the logs to be purged

If not set, log for all levels will be purged.

Namespace of logs that need to be purged

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

Reference (ref) of the pluginDefaults to apply to this task.

The minimum date to be purged

All logs after this date will be purged.

Default0

The count of deleted logs