This documentation has an index for AI agents at /llms.txt. A Markdown version of this page is available at https://explorer.opentelemetry.io/java-agent/instrumentation/log4j-mdc-1.2.md.

Log4j

OpenTelemetry Java agent instrumentation

This instrumentation adds trace context (trace ID, span ID, and trace flags) to the Log4j MDC, it does not emit any telemetry on its own.

  • Name: log4j-mdc-1.2
  • Scope: io.opentelemetry.log4j-mdc-1.2
  • Target versions: log4j:log4j:[1.2,)
  • Library: https://logging.apache.org/log4j/1.2/

Configuration

OptionTypeDefaultDescription
otel.instrumentation.common.logging.span-id-keystringspan_idSpecifies the key name used to store the span ID in the logging context.
otel.instrumentation.common.logging.trace-flags-keystringtrace_flagsSpecifies the key name used to store the trace flags in the logging context.
otel.instrumentation.common.logging.trace-id-keystringtrace_idSpecifies the key name used to store the trace ID in the logging context.
otel.instrumentation.common.mdc.resource-attributeslistSpecifies which resource attributes to add to the logging context as a comma-separated list of attribute keys.

Data

  • JSON: /data/javaagent/instrumentations/log4j-mdc-1.2/log4j-mdc-1.2-e01d913a710f.json
  • Explore: /java-agent/instrumentation/log4j-mdc-1.2