Skip to main content

Event Retention

About This Feature​

The Event Retention page lets administrators configure data retention policies for Security Events and Admission Events. You can set the maximum number of events stored (by count) and the automatic cleanup period (TTL in days) to balance storage usage against audit requirements.


Settings Page​

Navigate to "Settings → Event Retention" to access the retention configuration, which is divided into two tabs.

Event Retention settings page


Security Events Retention​

In the "Security Events" tab, configure the retention policy for Tetragon kprobe security events:

SettingDescriptionDefaultRange
Max Warning EventsMaximum number of Warning-severity events to retain; oldest events are removed when this limit is exceeded5001 – 5,000
Max Critical EventsMaximum number of Critical-severity events to retain3001 – 2,000
TTL (days)Maximum age of events in days; events older than this are removed regardless of count71 – 90 days

Click "Save" to apply the settings. The page shows a Total capacity summary reflecting the configured maximums.


Admission Events Retention​

Switch to the "Admission Events" tab to configure retention for ValidatingAdmissionPolicy violation events. Unlike Security Events, this is a single event cap (not split by severity, default 500) plus a TTL, and the TTL range is 1 to 365 days (default 30).


How Cleanup Works​

The K8s Sentinel backend triggers automatic cleanup on two independent conditions:

  1. Count exceeded - when the number of events at a given severity exceeds the configured maximum, the oldest events are deleted first
  2. TTL expired - the backend periodically scans the database and removes all events older than the configured TTL

Both conditions operate independently - an event is removed if either applies.

warning

Reducing the maximum event count or shortening the TTL does not immediately delete existing events that exceed the new limits. Cleanup happens on the next scheduled background sweep. For long-term retention, use the Syslog feature to forward events to an external logging system before they expire.