diff --git a/content/en/docs/concepts/components.md b/content/en/docs/concepts/components.md index ec4cb3f9c705..2feaa1efda67 100644 --- a/content/en/docs/concepts/components.md +++ b/content/en/docs/concepts/components.md @@ -73,7 +73,7 @@ For more information, see ### Exporters -{{% docs/languages/exporters/intro all %}} +{{% docs/languages/exporters/intro %}} ### Automatic Instrumentation diff --git a/content/en/docs/languages/cpp/exporters.md b/content/en/docs/languages/cpp/exporters.md index d7cbb5615bd1..ff31e487e722 100644 --- a/content/en/docs/languages/cpp/exporters.md +++ b/content/en/docs/languages/cpp/exporters.md @@ -1,7 +1,6 @@ --- title: Exporters weight: 50 -cSpell:ignore: chrono millis ostream --- diff --git a/content/en/docs/languages/go/exporters.md b/content/en/docs/languages/go/exporters.md index a771be78a5f7..86d5f1608752 100644 --- a/content/en/docs/languages/go/exporters.md +++ b/content/en/docs/languages/go/exporters.md @@ -173,8 +173,3 @@ func newExporter(ctx context.Context) (metric.Reader, error) { To learn more on how to use the Prometheus exporter, try the [prometheus example](https://github.com/open-telemetry/opentelemetry-go/tree/main/example/prometheus) - -## Available packages - -You can find a full list of available exporters in the -[OpenTelemetry registry](/ecosystem/registry/?language=go&component=exporter). diff --git a/layouts/shortcodes/docs/languages/exporters/intro.md b/layouts/shortcodes/docs/languages/exporters/intro.md index dc95f373045f..0a1055988491 100644 --- a/layouts/shortcodes/docs/languages/exporters/intro.md +++ b/layouts/shortcodes/docs/languages/exporters/intro.md @@ -1,26 +1,47 @@ - +To visualize and analyze telemetry, export it to the +[OpenTelemetry Collector](/docs/collector/), to a backend such as +[Jaeger](https://jaegertracing.io/), [Zipkin](https://zipkin.io/), +[Prometheus](https://prometheus.io/), or a +[vendor-specific](/ecosystem/vendors/) backend. -{{ $lang := .Get 0 -}} {{ $data := index $.Site.Data.instrumentation $lang -}} -{{ $name := cond (isset $.Site.Data.instrumentation $lang) (printf "OpenTelemetry %s" $data.name) "the language specific implementations" -}} +{{ $lang := .Get 0 | default "" -}} -In order to visualize and analyze your telemetry, you will need to export your -data to an [OpenTelemetry Collector](/docs/collector/) or a backend such as -[Jaeger](https://jaegertracing.io/), [Zipkin](https://zipkin.io/), -[Prometheus](https://prometheus.io/) or a [vendor-specific](/ecosystem/vendors/) -one. +{{ $name := "" -}} + +{{ if $lang -}} + +{{ $name = (index $.Site.Data.instrumentation $lang).name -}} -As part of {{ $name }} you will find many exporters being available. Among them, -the OpenTelemetry Protocol (OTLP) exporters provide the best experience for you -as an end-user, since it is a general-purpose telemetry data delivery protocol -designed in the scope of the OpenTelemetry project. +## Available exporters -To learn more about the OTLP protocol, you can read the -[OTLP Specification](/docs/specs/otlp/). +The registry contains a [list of exporters for {{ $name }}][reg]. -{{ if (isset $.Site.Data.instrumentation $lang) -}} +{{ else -}} -Below you will find some introductions on how to set up exporters for OTLP and -other common protocols in your code. +The registry contains the [list of language specific exporters][reg]. + +{{ end -}} + +Among exporters, [OpenTelemetry Protocol (OTLP)][OTLP] exporters are designed +with the OpenTelemetry data model in mind, emitting OTel data without any loss +of information. Furthermore, many tools that operate on telemetry data support +OTLP (such as [Prometheus], [Jaeger], and most [vendors]), providing you with a +high degree of flexibility when you need it. To learn more about OTLP, see [OTLP +Specification][OTLP]. + +[Jaeger]: /blog/2022/jaeger-native-otlp/ +[OTLP]: /docs/specs/otlp/ +[Prometheus]: + https://prometheus.io/docs/prometheus/latest/feature_flags/#otlp-receiver +[signals]: /docs/concepts/signals/ +[vendors]: /ecosystem/vendors/ + +[reg]: /ecosystem/registry/?component=exporter&language={{ $lang }} + +{{ if $name -}} + +This page covers the main OpenTelemetry {{ $name }} exporters and how to set +them up. {{ end -}} @@ -34,11 +55,13 @@ Guide](/docs/languages/{{ $lang }}/automatic/configuration/). -{{ end }} +{{ end -}} {{/* below list needs to grow until all languages are updated to a consistent structure. - */}} {{ if in (slice "python" "js" "java") $lang -}} + */ -}} + +{{ if in (slice "python" "js" "java") $lang -}} ## OTLP