Skip to content

Commit 9303e40

Browse files
committed
slight improvements
1 parent b6cf784 commit 9303e40

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

docs/metrics.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)