Update docs/comments

Author: ArunPiduguDD

src/transforms/tag_cardinality_limit/config.rs

@@ -143,8 +143,9 @@ pub struct PerMetricConfig {
     /// - `mode: limit_override` + `value_limit: N` — track with a per-tag cap.
     /// - `mode: excluded` — opt this tag out of tracking entirely.
     ///
-    ///  All other settings (tracking algorithm, `limit_exceeded_action`, etc.)
-    /// are inherited from the enclosing per-metric configuration.
+    /// All other settings (tracking algorithm, `limit_exceeded_action`, etc.)
+    /// are inherited from the enclosing per-metric configuration, except
+    /// `cache_size_per_key`, which can be overridden per tag in probabilistic mode.
     /// Tags not listed here use the per-metric configuration.
     #[configurable(
         derived,
@@ -379,7 +380,7 @@ impl Config {
         }
 
         // Per-metric per_tag_limits: cache_size_per_key only applies when the per-metric
-        // mode is probabilistic (not exact, and not excluded).
+        // mode is probabilistic.
         for per_metric in self.per_metric_limits.values() {
             if !matches!(per_metric.config.mode, OverrideMode::Probabilistic(_)) {
                 for (tag_key, tag_cfg) in &per_metric.per_tag_limits {

src/transforms/tag_cardinality_limit/mod.rs

@@ -96,10 +96,10 @@ impl TagCardinalityLimit {
     /// Resolve the configuration that applies to a specific (metric, tag) pair.
     ///
     /// Per-tag entries support two modes:
-    /// - `mode: limit_override` — uses the per-tag `value_limit`; all other settings
-    ///   (`mode`, `cache_size_per_key`, `limit_exceeded_action`, `internal_metrics`)
-    ///   are inherited from the enclosing per-metric (or, for global overrides, the
-    ///   global) config.
+    /// - `mode: limit_override` — uses the per-tag `value_limit` and an optional per-tag
+    ///   `cache_size_per_key`; all other settings (`mode`, `limit_exceeded_action`,
+    ///   `internal_metrics`) are inherited from the enclosing per-metric (or, for global
+    ///   overrides, the global) config.
     /// - `mode: excluded` — opts the tag out entirely; all values pass through.
     ///
     /// Per-metric exclusion is blanket: `mode: excluded` on a per-metric entry opts out
@@ -132,8 +132,9 @@ impl TagCardinalityLimit {
         let metric_value_limit = per_metric.config.value_limit;
         let internal_metrics = per_metric.config.internal_metrics;
 
-        // Per-tag entry: LimitOverride uses an explicit value_limit; Excluded opts
-        // the tag out. All other settings are always inherited from per-metric.
+        // Per-tag entry: LimitOverride uses an explicit value_limit (and optional
+        // cache_size_per_key override); Excluded opts the tag out. All other settings
+        // are always inherited from per-metric.
         if let Some(per_tag) = per_metric.per_tag_limits.get(tag_key) {
             match per_tag.mode {
                 PerTagMode::Excluded => return TagSettings::Excluded,

website/cue/reference/components/transforms/generated/tag_cardinality_limit.cue

@@ -154,7 +154,8 @@ generated: components: transforms: tag_cardinality_limit: configuration: {
 						- `mode: excluded` — opt this tag out of tracking entirely.
 
 						All other settings (tracking algorithm, `limit_exceeded_action`, etc.)
-						are inherited from the enclosing per-metric configuration.
+						are inherited from the enclosing per-metric configuration, except
+						`cache_size_per_key`, which can be overridden per tag in probabilistic mode.
 						Tags not listed here use the per-metric configuration.
 						"""
 					required: false