MicroProfile Telemetry
2.0
1.1
1.0

This feature provides support for the Eclipse MicroProfile Telemetry specification for enterprise Java.

For information about migrating from MicroProfile Open Tracing to MicroProfile Open Telemetry, see Differences between MicroProfile Telemetry 1.0 and MicroProfile OpenTracing 3.0.

For information about configuring MicroProfile Telemetry, see Enable observability with MicroProfile Telemetry.

Enabling this feature

To enable the MicroProfile Telemetry 2.0 feature, add the following element declaration into your server.xml file, inside the featureManager element:

<feature>mpTelemetry-2.0</feature>

Examples

Collect logs from a specified source

To enable the MicroProfile Telemetry feature to collect logs from different sources in the Open Liberty runtime environment, configure the source attribute for the mpTelemetry element with a comma-separated list of comma-separated log sources.

<mpTelemetry source="message, trace, ffdc"/>

  • The mpTelemetry configuration element is optional. If you do not specify ity or the source attribute, the default configuration source is message.

  • If the source attribute is empty (source=“”), no sources are collected, and nothing is routed to the configured OpenTelemetry logs exporter.

  • The attributes and values are case insensitive.

Feature configuration elements

Third-party API packages provided by this feature

  • io.opentelemetry.api

  • io.opentelemetry.api.baggage

  • io.opentelemetry.api.baggage.propagation

  • io.opentelemetry.api.common

  • io.opentelemetry.api.logs

  • io.opentelemetry.api.metrics

  • io.opentelemetry.api.trace

  • io.opentelemetry.context

  • io.opentelemetry.context.propagation

  • io.opentelemetry.exporter.logging

  • io.opentelemetry.exporter.otlp

  • io.opentelemetry.exporter.otlp.logs

  • io.opentelemetry.extension.incubator.metrics

  • io.opentelemetry.instrumentation.annotations

  • io.opentelemetry.sdk.autoconfigure.spi

  • io.opentelemetry.sdk.autoconfigure.spi.logs

  • io.opentelemetry.sdk.autoconfigure.spi.metrics

  • io.opentelemetry.sdk.autoconfigure.spi.traces

  • io.opentelemetry.sdk.common

  • io.opentelemetry.sdk.logs.data

  • io.opentelemetry.sdk.logs.export

  • io.opentelemetry.sdk.metrics

  • io.opentelemetry.sdk.metrics.data

  • io.opentelemetry.sdk.metrics.export

  • io.opentelemetry.sdk.resources

  • io.opentelemetry.sdk.trace

  • io.opentelemetry.sdk.trace.data

  • io.opentelemetry.sdk.trace.export

  • io.opentelemetry.sdk.trace.samplers

  • io.opentelemetry.semconv

Features that this feature enables

Supported Java versions

  • JavaSE-11.0

  • JavaSE-17.0

  • JavaSE-21.0

  • JavaSE-22.0

Developing a feature that depends on this feature

If you are developing a feature that depends on this feature, include the following item in the Subsystem-Content header in your feature manifest file.

io.openliberty.mpTelemetry-2.0; type="osgi.subsystem.feature"