Skip to main content
Version: 8.5

Data retention

How the data is stored and archived​

Operate imports data from Zeebe and stores it in Elasticsearch indices with a defined prefix (default: operate). Specifically, this includes the following:

  • Deployed processes, including the diagrams
  • The state of process instances, including variables and flow nodes, activated within instance execution, incidents, etc.

It additionally stores some Operate-specific data:

  • Operations performed by the user
  • List of users
  • Technical data, like the state of Zeebe import, etc.

The data representing process instance state becomes immutable after the process instance is finished. Currently, the data may be archived, meaning it is moved to a dated index, e.g. operate_variables_2020-01-01, where date represents the date on which the given process instance was finished. The same is valid for user operations; after they are finished, the related data is moved to dated indices.

note

All Operate data present in Elasticsearch (from both main and dated indices) are visible from the UI.

Archive period​

The default time between a process instance finishing and being moved to a dated index is one hour. This can be modified by setting the waitPeriodBeforeArchiving configuration parameter.

Data cleanup​

In case of intensive Zeebe usage, the amount of data can grow significantly overtime. Therefore, you should consider the data cleanup strategy.

Dated indices may be safely removed from Elasticsearch. "Safely" means only finished process instances are deleted together with all related data, and the rest of the data stays consistent. You can use Elasticsearch Curator or other tools/scripts to delete old data.

Users updating from Elasticsearch 7 to Elasticsearch 8 will encounter issues with the Elasticsearch Curator. To resolve this, Operate allows configuring an Index Lifecycle Management (ILM) Policy using the archiver configuration options:

Snippet from application.yml​

camunda.operate:
  archiver:
    ilmEnabled: true
    ilmMinAgeForDeleteArchivedIndices: 30d

ilmMinAgeForDeleteArchivedIndices defines the duration for which archived data will be stored before deletion. The values use Elasticsearch TimeUnit format.

This ILM Policy works on Elasticsearch 7 as well, and can function as a replacement of the Elasticsearch Curator.

note

Only indices containing dates in their suffix may be deleted.

OpenSearch​

OpenSearch does not support above Index Lifecycle Management (ILM) Policy, but rather uses Index State Management (ISM). This can be enabled on Operate by configuring the same archiver configuration options as shown above. Please refer to the AWS documentation for any additional OpenSearch specific configuration guidance.

As of the 8.4 release, Operate is now compatible with Amazon OpenSearch 2.5.x. Note that using Amazon OpenSearch requires setting up a new Camunda installation. A migration from previous versions or Elasticsearch environments is currently not supported.