# Liberty

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

> OpenTelemetry Java agent instrumentation

This instrumentation enables HTTP server spans and metrics for IBM WebSphere Liberty application server.

- **Name**: `liberty-20.0`
- **Scope**: `io.opentelemetry.liberty-20.0`
- **Library**: https://openliberty.io/

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.http.known-methods` | list | CONNECT,DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,TRACE | Configures the instrumentation to recognize an alternative set of HTTP request methods. All other methods will be treated as `_OTHER`. |
| `otel.instrumentation.http.server.capture-request-headers` | list |  | List of HTTP request headers to capture in HTTP server telemetry. |
| `otel.instrumentation.http.server.capture-response-headers` | list |  | List of HTTP response headers to capture in HTTP server telemetry. |
| `otel.instrumentation.http.server.emit-experimental-telemetry` | boolean | false | Enable the capture of experimental HTTP server telemetry. Adds the `http.request.body.size` and `http.response.body.size` attributes to spans, and records `http.server.request.body.size` and `http.server.response.body.size` metrics. |
| `otel.instrumentation.servlet.experimental-span-attributes` | boolean | false | Enables capturing the experimental `servlet.timeout` span attribute. |
| `otel.instrumentation.servlet.experimental.capture-request-parameters` | list |  | List of request parameter names to capture as span attributes. |

## Data

- **JSON**: [/data/javaagent/instrumentations/liberty-20.0/liberty-20.0-b1c6efc3ed46.json](/data/javaagent/instrumentations/liberty-20.0/liberty-20.0-b1c6efc3ed46.json)
- **Explore**: [/java-agent/instrumentation/liberty-20.0](/java-agent/instrumentation/liberty-20.0)