Skip to content

Commit a0832b8

Browse files
committed
format
1 parent 8b06220 commit a0832b8

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

docs/metrics.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -485,9 +485,9 @@ practice is important:
485485

486486
* **Delta Temporality**: The SDK "forgets" the state after each
487487
collection/export cycle. This means in each new interval, the SDK can track
488-
up to the cardinality limit of distinct attribute combinations.
489-
Over time, your metrics backend might see far more than the configured limit
490-
of distinct combinations from a single process.
488+
up to the cardinality limit of distinct attribute combinations. Over time,
489+
your metrics backend might see far more than the configured limit of
490+
distinct combinations from a single process.
491491

492492
* **Cumulative Temporality**: Since the SDK maintains state across export
493493
intervals, once the cardinality limit is reached, new attribute combinations
@@ -568,9 +568,9 @@ depends on your temporality choice and application characteristics.
568568

569569
Setting the limit incorrectly can have consequences:
570570

571-
* **Limit too high**: Due to the SDK's [memory preallocation](#memory-preallocation)
572-
strategy, excess memory will be allocated upfront and remain unused, leading to
573-
resource waste.
571+
* **Limit too high**: Due to the SDK's [memory
572+
preallocation](#memory-preallocation) strategy, excess memory will be
573+
allocated upfront and remain unused, leading to resource waste.
574574
* **Limit too low**: Measurements will be folded into the overflow bucket
575575
(`{"otel.metric.overflow": true}`), losing granular attribute information and
576576
making attribute-based queries unreliable.
@@ -590,13 +590,13 @@ Consider these guidelines when determining the appropriate limit:
590590
* Delta temporality resets aggregations after each export cycle, enabling more
591591
flexible cardinality management based on actual usage patterns rather than
592592
theoretical maximums.
593-
* When all possible attribute combinations are known (eg: Fruit example from above), use the same calculation
594-
approach as cumulative temporality.
593+
* When all possible attribute combinations are known (eg: Fruit example from
594+
above), use the same calculation approach as cumulative temporality.
595595
* For dynamic scenarios where not all combinations appear in every export cycle,
596596
base the limit on expected total measurements within a single interval.
597597
* **Example 1:** With a 60-second export interval and 1,000 measurements per
598-
interval, set the cardinality limit to 1,000. Delta temporality allows the
599-
SDK to reset after each export, accommodating different attribute combinations
598+
interval, set the cardinality limit to 1,000. Delta temporality allows the SDK
599+
to reset after each export, accommodating different attribute combinations
600600
across intervals without accumulating state.
601601
* **Example 2:** For web applications with known Request Per Second (RPS) rates,
602602
calculate the maximum measurements per interval: `RPS × Export Interval`. With
@@ -612,11 +612,11 @@ Consider these guidelines when determining the appropriate limit:
612612
allowing a lower limit. However, balance this against increased serialization
613613
and network overhead from more frequent exports.
614614

615-
TODO: Add the memory cost incurred by each data points, so users
616-
can know the memory impact of setting a higher limits.
615+
TODO: Add the memory cost incurred by each data points, so users can know the
616+
memory impact of setting a higher limits.
617617

618-
TODO: Add example of how query can be affected when overflow occurs,
619-
use [Aspire](https://github.com/dotnet/aspire/pull/7784) tool.
618+
TODO: Add example of how query can be affected when overflow occurs, use
619+
[Aspire](https://github.com/dotnet/aspire/pull/7784) tool.
620620

621621
### Memory Preallocation
622622

0 commit comments

Comments
 (0)