Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify that STDOUT exporter format is unspecified #3935

Closed
wants to merge 4 commits into from
Closed

Clarify that STDOUT exporter format is unspecified #3935

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b22f796
STDOUT exporter format is unspecified
MrAlias Mar 12, 2024
386d122
Merge branch 'main' into unspecified-out-fmt
MrAlias Mar 13, 2024
ccb5fce
Relax logs requirement to recommendation
MrAlias Mar 13, 2024
60ea13a
Add perf reason to doc recommendation
MrAlias Mar 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,21 @@ release.

### Traces

- Clarify STDOUT exporter format is unspecified.
([#3935](https://github.com/open-telemetry/opentelemetry-specification/pull/3935))
- Recommend documentation of the STDOUT exporter format.
([#3935](https://github.com/open-telemetry/opentelemetry-specification/pull/3935))

### Metrics

- Remove implementation specific specification from metric API.
([#3890](https://github.com/open-telemetry/opentelemetry-specification/pull/3890))
- Formalize the interaction between cardinality limit and overflow attribute.
([#3912](https://github.com/open-telemetry/opentelemetry-specification/pull/3912))
- Clarify STDOUT exporter format is unspecified.
([#3935](https://github.com/open-telemetry/opentelemetry-specification/pull/3935))
- Recommend documentation of the STDOUT exporter format.
([#3935](https://github.com/open-telemetry/opentelemetry-specification/pull/3935))

### Logs

Expand All @@ -28,6 +37,10 @@ release.
([#3852](https://github.com/open-telemetry/opentelemetry-specification/pull/3852))
- Add support for empty values.
([#3853](https://github.com/open-telemetry/opentelemetry-specification/pull/3853))
- Clarify STDOUT exporter format is unspecified.
([#3935](https://github.com/open-telemetry/opentelemetry-specification/pull/3935))
- Require documentation of the STDOUT exporter format.
([#3935](https://github.com/open-telemetry/opentelemetry-specification/pull/3935))

### Resource

Expand Down
5 changes: 5 additions & 0 deletions specification/logs/sdk_exporters/stdout.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ linkTitle: Stdout
Exporter](../sdk.md#logrecordexporter) which outputs the logs to
stdout/console.

The output format of the exporter is unspecified. The exporter MUST be
documented that its output is not a standardized format across OpenTelemetry
nor is it a stable format. The documentation SHOULD suggest the OTLP exporter
for users that want a stable and standarized output format.

[OpenTelemetry SDK](../../overview.md#sdk) authors MAY choose the best idiomatic
name for their language. For example, ConsoleExporter, StdoutExporter,
StreamExporter, etc.
Expand Down
5 changes: 5 additions & 0 deletions specification/metrics/sdk_exporters/stdout.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ linkTitle: Stdout
Exporter](../sdk.md#push-metric-exporter) which outputs the metrics to
stdout/console.

The output format of the exporter is unspecified. The exporter SHOULD be
documented that its output is not a standardized format across OpenTelemetry
nor is it a stable format. The documentation SHOULD suggest the OTLP exporter
for users that want a stable and standarized output format.

[OpenTelemetry SDK](../../overview.md#sdk) authors MAY choose the best idiomatic
name for their language. For example, ConsoleExporter, StdoutExporter,
StreamExporter, etc.
Expand Down
5 changes: 5 additions & 0 deletions specification/trace/sdk_exporters/stdout.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@ linkTitle: Stdout
Exporter](../sdk.md#span-exporter) which outputs the spans to
stdout/console.

The output format of the exporter is unspecified. The exporter SHOULD be
cijothomas marked this conversation as resolved.
Show resolved Hide resolved
documented that its output is not a standardized format across OpenTelemetry
nor is it a stable format. The documentation SHOULD suggest the OTLP exporter
for users that want a stable and standarized output format.
MrAlias marked this conversation as resolved.
Show resolved Hide resolved

[OpenTelemetry SDK](../../overview.md#sdk) authors MAY choose the best idiomatic
name for their language. For example, ConsoleExporter, StdoutExporter,
StreamExporter, LoggingExporter etc.
Expand Down
Loading