Skip to content

Commit d82d764

Browse files
authored
utf8: update doc for deprecated bool (#2702)
Signed-off-by: Owen Williams <[email protected]>
1 parent 09389f1 commit d82d764

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

docs/guides/utf8.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,11 @@ scrape_configs:
5353
metric_name_validation_scheme: legacy
5454
```
5555
56-
Scrape config settings override the global setting.
56+
Scrape config settings override the global setting. If a scrape config
57+
validation is set but the escaping scheme is not set, the escaping scheme will
58+
be inferred from the validation scheme. This allows users to set only
59+
metric_name_validation_scheme in scrape configs without also having to specify a
60+
metric_name_escaping_scheme.
5761
5862
### Scrape Content Negotiation for UTF-8 escaping
5963
@@ -96,7 +100,12 @@ configuration as follows:
96100

97101
otlp:
98102
# Ingest OTLP data keeping UTF-8 characters in metric/label names.
99-
translation_strategy: NoUTF8EscapingWithSuffixes
103+
translation_strategy: NoTranslation
104+
105+
Note that when not appending type and unit suffixes, if there are two metrics
106+
with the same name but differing type or unit, those metrics will collide in
107+
Prometheus. Once Prometheus has native support for type and unit metadata this
108+
issue will go away.
100109

101110

102111
See [OpenTelemetry guide](/docs/guides/opentelemetry) for more details.

0 commit comments

Comments
 (0)