From 6e9fcd245150ca97a2ffbcc1ac22eaf7f85c0c50 Mon Sep 17 00:00:00 2001 From: SungJin1212 Date: Sun, 24 Aug 2025 20:47:29 +0900 Subject: [PATCH 1/2] docs: update otlp for delta temporality and metadata labels Signed-off-by: SungJin1212 --- docs/guides/open-telemetry-collector.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/guides/open-telemetry-collector.md b/docs/guides/open-telemetry-collector.md index 40d2aa83bf2..52341fad791 100644 --- a/docs/guides/open-telemetry-collector.md +++ b/docs/guides/open-telemetry-collector.md @@ -65,6 +65,19 @@ service: ``` ## Configure OTLP +You can configure OTLP-related flags in a yaml file. + +``` +limits: + promote_resource_attributes: +... +distributor: + otlp: + convert_all_attributes: + disable_target_info: + allow_delta_temporality: + enable_type_and_unit_labels: +``` ### target_info metric @@ -117,6 +130,17 @@ distributor: disable_target_info: false ``` +### Delta temporality + +The OpenTelemetry supports two temporalities, [Delta and Cumulative](https://opentelemetry.io/docs/specs/otel/metrics/data-model/#temporality). +By default, only the cumulative metrics can be ingested. +To enable the ingestion of OTLP metrics with delta temporality, set the `distributor.otlp.allow-delta-temporality` flag to `true`. + +### Enable `__type__` and `__unit__` label + +The `__type__` and `__unit__` labels are added to OTLP metrics if `distributor.otlp.enable-type-and-unit-labels` is set to `true`. +This flag is disabled by default. + ### Configure promote resource attributes per tenants The `promote_resource_attributes` is a [runtime config](./overrides-exporter.md) so you can configure it per tenant. From 39a838f500f601bf517c70169f9880270161a9bc Mon Sep 17 00:00:00 2001 From: SungJin1212 Date: Mon, 25 Aug 2025 16:15:03 +0900 Subject: [PATCH 2/2] change titles and some typos Signed-off-by: SungJin1212 --- docs/guides/open-telemetry-collector.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/guides/open-telemetry-collector.md b/docs/guides/open-telemetry-collector.md index 52341fad791..cd0e9bd7ad2 100644 --- a/docs/guides/open-telemetry-collector.md +++ b/docs/guides/open-telemetry-collector.md @@ -1,8 +1,8 @@ --- -title: "OpenTelemetry Collector" -linkTitle: "OpenTelemetry Collector" +title: "Use OpenTelemetry Collector to send metrics to Cortex" +linkTitle: "Use OpenTelemetry Collector to send metrics to Cortex" weight: 10 -slug: opentelemetry-collector +slug: use-opentelemetry-collector-to-send-metrics-to-cortex --- This guide explains how to configure open-telemetry collector and OTLP(OpenTelemetry Protocol) configurations in the @@ -64,8 +64,8 @@ service: exporters: [otlphttp] ``` -## Configure OTLP -You can configure OTLP-related flags in a yaml file. +## Cortex configurations for ingesting OTLP metrics +You can configure OTLP-related flags in the config file. ``` limits: @@ -79,7 +79,7 @@ distributor: enable_type_and_unit_labels: ``` -### target_info metric +### Ingest `target_info` metric By default, the [target_info](https://github.com/prometheus/OpenMetrics/blob/main/specification/OpenMetrics.md#supporting-target-metadata-in-both-push-based-and-pull-based-systems) @@ -130,10 +130,10 @@ distributor: disable_target_info: false ``` -### Delta temporality +### Ingest delta temporality OTLP metrics -The OpenTelemetry supports two temporalities, [Delta and Cumulative](https://opentelemetry.io/docs/specs/otel/metrics/data-model/#temporality). -By default, only the cumulative metrics can be ingested. +OpenTelemetry supports two temporalities, [Delta and Cumulative](https://opentelemetry.io/docs/specs/otel/metrics/data-model/#temporality). +By default, only the cumulative metrics can be ingested via OTLP endpoint in Cortex. To enable the ingestion of OTLP metrics with delta temporality, set the `distributor.otlp.allow-delta-temporality` flag to `true`. ### Enable `__type__` and `__unit__` label