From 59bfe9564d5fbb9d08c99c3ed36daf282f0a9075 Mon Sep 17 00:00:00 2001 From: Alex Boten Date: Thu, 26 Oct 2023 09:31:08 -0700 Subject: [PATCH] add definition for standard output trace exporter This is mostly a copy of the definition already present for the metrics exporter. It doesn't specify a format for the output itself. Signed-off-by: Alex Boten --- CHANGELOG.md | 2 ++ specification/trace/sdk_exporters/stdout.md | 22 +++++++++++++++++++++ 2 files changed, 24 insertions(+) create mode 100644 specification/trace/sdk_exporters/stdout.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 517e63ac1f1..9d385950e69 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,8 @@ release. - Add a new AddLink() operation to Span (experimental). ([#3678](https://github.com/open-telemetry/opentelemetry-specification/pull/3678)) +- Add definition for standard output trace exporter. + ([#3740](https://github.com/open-telemetry/opentelemetry-specification/pull/3740)) ### Metrics diff --git a/specification/trace/sdk_exporters/stdout.md b/specification/trace/sdk_exporters/stdout.md new file mode 100644 index 00000000000..1ca25682590 --- /dev/null +++ b/specification/trace/sdk_exporters/stdout.md @@ -0,0 +1,22 @@ + + +# OpenTelemetry Span Exporter - Standard output + +**Status**: [Stable](../../document-status.md) + +"Standard output" Span Exporter is a [Span +Exporter](../sdk.md#span-exporter) which outputs the metrics to +stdout/console. + +[OpenTelemetry SDK](../../overview.md#sdk) authors MAY choose the best idiomatic +name for their language. For example, ConsoleExporter, StdoutExporter, +StreamExporter, etc. + +If a language provides a mechanism to automatically configure a +[Span processor](../sdk.md#span-processor) to pair with the associated +exporter (e.g., using the [`OTEL_TRACES_EXPORTER` environment +variable](../../configuration/sdk-environment-variables.md#exporter-selection)), by +default the exporter MUST be paired with a [batching +processor](../sdk.md#batching-processor).