@@ -579,23 +579,26 @@ Consider these guidelines when determining the appropriate limit:
579579
580580** 1. For Cumulative Temporality:**
581581
582- * Cumulative metrics retain their state across export cycles, so the total
583- cardinality equals the Cartesian product of all attribute combinations.
584- * ** Example:** Using the fruit sales example, if the metric has two attributes
585- (` name ` with 2 possible values and ` color ` with 3 possible values), the total
586- cardinality is ` 2 × 3 = 6 ` . The cardinality limit can hence be set to 6.
582+ * Cumulative metrics keep track of every unique attribute combination that has
583+ ever been seen, so you need to account for the maximum number of combinations
584+ that could exist. Calculate this by multiplying the number of possible values
585+ (i.e cardinality) for each attribute.
586+ * ** Example:** Using the fruit sales example, if you have a ` name ` attribute
587+ that can be either "apple" or "lemon" (2 values) and a ` color ` attribute that
588+ can be "red", "yellow", or "green" (3 values), then you could potentially see
589+ ` 2 × 3 = 6 ` different combinations. Set your cardinality limit to 6.
587590
588591** 2. For Delta Temporality:**
589592
590593* Delta temporality resets aggregations after each export cycle, enabling more
591594 flexible cardinality management based on actual usage patterns rather than
592595 theoretical maximums.
593- * When all possible attribute combinations are known (eg: Fruit example from
596+ * When all possible attribute combinations are known (eg: fruit sales example from
594597 above), use the same calculation approach as cumulative temporality.
595598* For dynamic scenarios where not all combinations appear in every export cycle,
596599 base the limit on expected total measurements within a single interval.
597600* ** Example 1:** If your application generates at most 1,000 distinct attribute
598- combinations per export interval (regardless of the interval duration) , set
601+ combinations per export interval, set
599602 the cardinality limit to 1,000. Delta temporality allows the SDK to reset
600603 after each export, accommodating different attribute combinations across
601604 intervals without accumulating state.
0 commit comments