Skip to Content

Changes for page Retention Policy

Last modified by Danniar Firdausy on 2024/09/18 15:56
From version 2.2
edited by Erik Bakker
on 2022/06/10 11:24
Change comment: Update document after refactoring.
To version 4.1
edited by Erik Bakker
on 2022/08/30 12:25
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -intermediate-key-concepts-emagiz-event-streaming-retention-policy
1 +Retention Policy
Default language
... ... @@ -1,0 +1,1 @@
1 +en
Content
... ... @@ -1,13 +1,8 @@
1 1  {{container}}{{container layoutStyle="columns"}}(((
2 -= Retention Policy =
3 -
4 4  In this microlearning, we will dive a little bit deeper into the concept of the retention policy concerning Event Streaming. Retention policy determines when a message needs to be cleaned up and, if so, what will happen to the message.
5 5  
6 6  Should you have any questions, please get in touch with [[academy@emagiz.com>>mailto:academy@emagiz.com]].
7 7  
8 -* Last update: August 4th, 2021
9 -* Required reading time: 4 minutes
10 -
11 11  == 1. Prerequisites ==
12 12  
13 13  * Intermediate knowledge of the eMagiz platform
... ... @@ -17,34 +17,31 @@
17 17  This microlearning centers on the retention policy for Event Streaming.
18 18  
19 19  * The key aspects are:
20 - * Retention Hours
21 - * Retention Bytes
22 - * Cleanup Policy
23 - * These three items determine the retention policy
15 + ** Retention Hours
16 + ** Retention Bytes
17 + ** Cleanup Policy
18 + ** These three items determine the retention policy
24 24  
25 -
26 -
27 27  == 3. Event Streaming ==
28 28  
29 29  In this microlearning, we will dive a little bit deeper into the concept of the retention policy concerning Event Streaming. Retention policy determines when a message needs to be cleaned up and, if so, what will happen to the message.
30 30  
31 31  * The key aspects are:
32 - * Retention Hours
33 - * Retention Bytes
34 - * Cleanup Policy
35 - * These three items determine the retention policy
25 + ** Retention Hours
26 + ** Retention Bytes
27 + ** Cleanup Policy
28 + ** These three items determine the retention policy
36 36  
37 -As we learned in the introductory [microlearning](crashcourse-eventstreaming-event-streaming-introduction.md), the topic holds a log with a sequence of messages. Based on several criteria, the broker decides when to remove messages from the back of the log to ensure that the topic stays within specific parameters. These parameters are the retention hours and the retention bytes. If you want to learn more about them specifically, please check out this [microlearning](crashcourse-eventstreaming-topic-and-topic-properties.md).
30 +As we learned in the introductory [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Event Streaming.crashcourse-eventstreaming-event-streaming-introduction.WebHome||target="blank"]], the topic holds a log with a sequence of messages. Based on several criteria, the broker decides when to remove messages from the back of the log to ensure that the topic stays within specific parameters. These parameters are the retention hours and the retention bytes. If you want to learn more about them specifically, please check out this [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Event Streaming.crashcourse-eventstreaming-topic-and-topic-properties.WebHome||target="blank"]].
38 38  
39 39  These parameters combined with the cleanup policy determine what happens with a message after it is expired. There are two options available:
40 -delete
41 -compact
33 +* delete
34 +* compact
35 +
42 42  The delete option is the default that eMagiz uses and advises. This option will, as the name suggests, delete all messages that are expired. There is an alternative approach called compact. This functionality will enable log compaction on the topic.
43 43  
44 44  The three aspects combine to make up the retention policy. Defining the correct values for both the retention hours and the retention bytes is a science as a form of art. As you only have limited storage capacity available, the challenge becomes how much retention you reserve per topic. The more you assign, the less free storage capacity remains for other topics. As a consequence, you need to strive to optimize your retention policy per topic continually.
45 45  
46 -
47 -
48 48  == 4. Assignment ==
49 49  
50 50  Check out if you have a project in which the Event Streaming pattern is used. If so, check out the retention policy for several topics.
... ... @@ -52,13 +52,11 @@
52 52  == 5. Key takeaways ==
53 53  
54 54  * The key aspects are:
55 - * Retention Hours
56 - * Retention Bytes
57 - * Cleanup Policy
58 - * These three items determine the retention policy
47 + ** Retention Hours
48 + ** Retention Bytes
49 + ** Cleanup Policy
50 + ** These three items determine the retention policy
59 59  
60 -
61 -
62 62  == 6. Suggested Additional Readings ==
63 63  
64 64  If you are interested in this topic, please read the help text eMagiz provides you.