# Logback

<!-- llms-txt-link: /llms.txt -->

> OpenTelemetry Java agent instrumentation

This instrumentation bridges Logback log events to OpenTelemetry logs.

- **Name**: `logback-appender-1.0`
- **Scope**: `io.opentelemetry.logback-appender-1.0`
- **Target versions**: `ch.qos.logback:logback-classic:[0.9.16,)`
- **Library**: https://logback.qos.ch/

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.logback-appender.experimental-log-attributes` | boolean | false | Enables the capture of experimental log attributes, including thread name and thread ID. |
| `otel.instrumentation.logback-appender.experimental.capture-arguments` | boolean | false | Enables the capture of log message arguments as separate attributes. |
| `otel.instrumentation.logback-appender.experimental.capture-code-attributes` | boolean | false | Enables the capture of code location attributes, including file path, class name, method name, and line number. |
| `otel.instrumentation.logback-appender.experimental.capture-key-value-pair-attributes` | boolean | false | Enables the capture of attributes from Logback key-value pairs. |
| `otel.instrumentation.logback-appender.experimental.capture-logger-context-attributes` | boolean | false | Enables the capture of attributes from the Logback logger context. |
| `otel.instrumentation.logback-appender.experimental.capture-logstash-marker-attributes` | boolean | false | Enables the capture of attributes from Logstash markers. |
| `otel.instrumentation.logback-appender.experimental.capture-logstash-structured-arguments` | boolean | false | Enables the capture of attributes from Logstash structured arguments. |
| `otel.instrumentation.logback-appender.experimental.capture-marker-attribute` | boolean | false | Enables the capture of the Logback marker attribute. |
| `otel.instrumentation.logback-appender.experimental.capture-mdc-attributes` | list |  | Controls which MDC attributes to capture. Use "*" to capture all MDC attributes or provide a comma-separated list of specific keys. |
| `otel.instrumentation.logback-appender.experimental.capture-template` | boolean | false | Enables the capture of the log message template before parameter substitution. |

## Data

- **JSON**: [/data/javaagent/instrumentations/logback-appender-1.0/logback-appender-1.0-feec7cf9edbe.json](/data/javaagent/instrumentations/logback-appender-1.0/logback-appender-1.0-feec7cf9edbe.json)
- **Explore**: [/java-agent/instrumentation/logback-appender-1.0](/java-agent/instrumentation/logback-appender-1.0)