What needs to be changed?
Description
There are two related documentation inconsistencies found in the Java section:
Issue 1: Getting Started uses deprecated logging exporter value
The Getting Started by Example page uses the following environment variable configuration:
OTEL_TRACES_EXPORTER=logging \
OTEL_METRICS_EXPORTER=logging \
OTEL_LOGS_EXPORTER=logging
However, according to the OTel specification, "logging" is a deprecated value left for backwards compatibility and SHOULD NOT be supported by new implementations. The recommended replacement is "console".
Issue 2: otel.metrics.exporter does not list console as a known value
The Java SDK configuration page lists the known values for otel.metrics.exporter as only: otlp, prometheus, none.
The value console is not listed, unlike otel.traces.exporter and otel.logs.exporter which do include console (or logging-otlp). This creates confusion when trying to use a console/logging exporter for metrics in Java.
Expected behavior
- The Getting Started example should either use
console instead of logging, or include a note that logging is deprecated.
- The Java configuration docs should clarify whether
console is a valid value for otel.metrics.exporter, and if so, add it to the known values list.
References
Name + path of the page
docs/languages/java/getting-started/
Additional context
No response
What needs to be changed?
Description
There are two related documentation inconsistencies found in the Java section:
Issue 1: Getting Started uses deprecated
loggingexporter valueThe Getting Started by Example page uses the following environment variable configuration:
However, according to the OTel specification,
"logging"is a deprecated value left for backwards compatibility and SHOULD NOT be supported by new implementations. The recommended replacement is"console".Issue 2:
otel.metrics.exporterdoes not listconsoleas a known valueThe Java SDK configuration page lists the known values for
otel.metrics.exporteras only:otlp,prometheus,none.The value
consoleis not listed, unlikeotel.traces.exporterandotel.logs.exporterwhich do includeconsole(orlogging-otlp). This creates confusion when trying to use a console/logging exporter for metrics in Java.Expected behavior
consoleinstead oflogging, or include a note thatloggingis deprecated.consoleis a valid value forotel.metrics.exporter, and if so, add it to the known values list.References
Name + path of the page
docs/languages/java/getting-started/
Additional context
No response