Setting retention time in Unravel server

To adjust the retention time (time horizon), you need to set/change three (3) properties in /usr/local/unravel/etc/unravel.properties.

  • com.unraveldata.retention.max.days: number of days to keep the heaviest data (such as error logs and drill-down details) in the SQL Database.

  • com.unraveldata.history.maxSize.weeks: number of weeks retained for search results in Elastic Search.

When changing these settings, be aware that long retention requires significant disk space. As a rule of thumb, each map-reduce or Spark job requires about 1 MB of disk space; you can store approximately 1000 jobs per 1 GB of disk.

  1. Open /usr/local/unravel/etc/unravel.properties file.

    # vi /usr/local/unravel/etc/unravel.properties
  2. Search for and set the following properties. If not found, add them.


    com.unraveldata.retention.max.days is the most significant factor in controlling disk space usage in the database used by Unravel.

  3. After changing any of the properties, restart Unravel for the change to take effect.

    # sudo /etc/init.d/unravel_all.sh restart