Data Expiration¶
Data Expiration (TTL, time-to-live) displays the duration until the expiration of the Insights data displayed on dashboards.
To know when the data will be expired, click 
in the upper-right corner of the current page. To view the value in minutes, hover the cursor over the current value.
When Cognigy products are used daily, the data expiration values will remain unchanged, as the countdown starts from the last data update.
Data Expiration Table¶
In the table below, you can view the data included in TTL.
| Data | Description | Dashboards/Explorers |
|---|---|---|
| Analytics | This indicates the duration between the creation of all Analytics data and its removal from the database. | Overview: - Number of Inputs - Top Intents - Understood Messages - Understood / Misunderstood Messages Engagement: - Avg. Session Length - Max. Session Length NLU Performance: - Avg Intent Score - Average Execution Time - Intents by Score Range - Max Intent Score - Understood Messages - Understood / Misunderstood Messages - Top Intents - Top Intent Scores |
| Conversations | This indicates the duration between the creation of chat history analytics and its removal from the database. | Transcript Explorer, Message Explorer |
| Sessions | This indicates the duration between the creation of Insights session analytics and its removal from the database. | Overview: - Active Contacts - Positive Ratings - Sessions - Session by Channel - Total Sessions - Top Goals - Top Slots - Unique Contacts - Users by Locale Engagement: - Contacts - Goals Reached - Handovers by time of the day - Live Agent Escalations - Positive Ratings - Positive Ratings over Time - Top Goals NLU Performance: - Top Slots |
| Step Events | This indicates the duration between the creation of Step data and its removal from the database. | Step Explorer |
| LiveAgentEscalation | This indicates the duration between the creation of Live Agent data and its removal from the database. | Live Agent |
| VoiceGatewayEvents | This indicates the duration between the creation of Voice Gateway data and its removal from the database. | - |
Activate Data Expiration¶
Cognigy keeps data indefinitely by default. To change this behavior, an expiration date must be set up.
To activate the Data Expiration feature, set limits via the management-ui service if you have an on-premise Cognigy.AI installation. Otherwise, contact technical support and specify the desired limits in your request.
If you have already set limits in the management-ui service, the Data Expiration indicator will automatically appear in the Insights interface.
The Data Expiration feature applies only to new data obtained by Cognigy after activating Data Expiration in management-ui. Data obtained before setting the expiration value remains.
For example:
In management-ui, you set the 1-minute expiration value at 13:00 for Sessions.
Sessions created after 13:00 will automatically terminate after 1 minute due to the 1-minute expiration date set in management-ui.
Sessions created before 13:00 will remain unchanged.
Change Data Expiration¶
You can change the duration of data expiration via the Management UI service if you have an on-premise Cognigy.AI installation. Otherwise, contact technical support.
When you adjust the data expiration value, it will only apply to new data obtained by Cognigy. The expiration value for previously obtained data will remain unchanged.
Customize Data Expiration for Multiple Organizations¶
In Cognigy, when managing multiple organizations,
you can customize Data Expiration settings for each organization independently through the Management UI.
The default Data Expiration is set in the environment variable in the values.yaml file.
Importantly,
specifying Data Expiration for a specific organization in the Management UI overrides the environment setting for that organization.
This setup ensures tailored Data Expiration configurations per organization, balancing global defaults with organization-specific needs.