Data Retention
To keep server disks from filling, you can set LogScale to delete old data. Retention can be set in the web based user interface based on compressed file sizes, uncompressed file sizes, and on age of data. Retention deletes events in large chunks or segments. It doesn't delete individual events. The three types of retention enforced are independent — data is deleted when any one of them is marked for deleting.
Compressed Size
The compressed setting is designed to allow the administrator to prevent the file system from growing too large. Configure the compressed settings for each repository so that the sum of all compressed sizes is less than the space available on the disk.
The compressed size calculation deletes data based on the amount of disk space consumed, taking replicas into account, until the amount on disk is below the setting. Replicas are handled by counting the copies in excess of the segment-replication settings as extra.
For example, in a cluster of three LogScale instances, a
segment-replication of three, and a CompressedSize
of
50 GB, the total disk usage on those three machines for this repository
would be 150 GB. This lets the users see 50 GB of compressed data.
If the segment replication setting is then changed to two, the allowed
disk usage drops to 100 GB in total on the three machines. The
retention-job
will then delete the oldest segments,
leaving approximately 33 GB of searchable data at first. When more data
flows in through ingest, the user will get back to having 50 GB of
searchable compressed data in the 100 GB on disk, likely distributed
evenly as 33GB on each LogScale instance in the cluster.
Uncompressed Size
The uncompressed setting is designed to delete data based on a promise to keep at least this much of the input. Original size is measured as the size stored before compression and is thus the size of the internal format, not the data that was ingested. It also includes the size of any additional fields sent along with the raw events.
The uncompressed size retention triggers a delete when it is able to retain at least the amount specified as uncompressed limit. Uncompressed retention does not consider multiple replicas as more than one copy, as it is based on the amount of data that the users see.
Age of Data
Data gets deleted when the latest event in the chunk is older than the configured retention. In order to make sure that a user cannot see events older than the configured limit, LogScale also restricts the time interval when searching to the interval allowed by this retention setting. Retention by age effectively hides any event that is too old, even if the chunk still has other events that are still visible. The disk space is reclaimed once the latest event is sufficiently old.