Docs/support escalations 11817 #9907
Conversation
| @@ -13,103 +13,103 @@ weight: 150 | |||
| To send OTel data to Grafana Cloud, refer to [Send data using OpenTelemetry Protocol (OTLP)](https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/). | |||
| {{% /admonition %}} | |||
|
|
|||
| When using the [OpenTelemetry Collector](https://opentelemetry.io/docs/collector/), you can write metrics into Mimir via two options: `prometheusremotewrite` and `otlphttp`. | |||
| When using the [OpenTelemetry Collector](https://opentelemetry.io/docs/collector/), you can write metrics into Mimir using two options: `otlphttp` (preferred) and `prometheusremotewrite`. | |||
There was a problem hiding this comment.
I think we should say here we recommend the usage of otlphttp.
The reason why we recommend this is because the exporter is maintained by the community and always up to date with the spec. It's the official way of sending OTLP traffic and we want to recommend the more native path.
Prometheus Remote Write is an exporter in the https://github.com/open-telemetry/opentelemetry-collector-contrib repository donated by the community that is in beta stage https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/prometheusremotewriteexporter
We strongly recommend otlphttp. We can leave the example at the bottom of prometheusremotewrite as an experimental section.
There was a problem hiding this comment.
I'll rework the doc a bit to more strongly favor otlphttp over prometheus remote write.
|
cc @aknuds1 in case you'd like to review this one 🙏 |
|
@jesusvazquez I've updated the doc to strongly recommend OTLP and to mark Prometheus remote write as experimental. LMK what you think! |
|
Thank you so much for you input, @jesusvazquez ! |
|
|
||
| Mimir supports native OTLP over HTTP. To configure the collector to use the OTLP interface, you use the [`otlphttp`](https://github.com/open-telemetry/opentelemetry-collector/tree/main/exporter/otlphttpexporter) exporter: | ||
| {{< admonition type="note" >}} | ||
| Support for the Prometheus remote write protocol is an experimental feature in Mimir. |
There was a problem hiding this comment.
Why do you think Prometheus remote write support is experimental in Mimir?
There was a problem hiding this comment.
I marked Prometheus remote write support as experimental based on @jesusvazquez 's suggestion above:
We strongly recommend otlphttp. We can leave the example at the bottom of prometheusremotewrite as an experimental section.
Let me know if this is not the case. Thanks!
Co-authored-by: Arve Knudsen <[email protected]>
What this PR does
This PR updates https://grafana.com/docs/mimir/next/configure/configure-otel-collector/ to explicitly recommend using the OTLP exporter, when possible, for sending OTLP data to Mimir.
Which issue(s) this PR fixes or relates to
Fixes https://github.com/grafana/support-escalations/issues/11817
Checklist
CHANGELOG.mdupdated - the order of entries should be[CHANGE],[FEATURE],[ENHANCEMENT],[BUGFIX].about-versioning.mdupdated with experimental features.