Java HTTP Server
OpenTelemetry Java agent instrumentation
This instrumentation enables HTTP server spans and HTTP server metrics for the Java HTTP server.
- Name:
java-http-server - Scope:
io.opentelemetry.java-http-server - Target versions:
Java 8+ - Library: https://docs.oracle.com/en/java/javase/21/docs/api/jdk.httpserver/module-summary.html
Telemetry
- Metrics:
http.server.request.duration - Span attributes:
client.address,error.type,http.request.method,http.response.status_code,http.route,network.peer.address,network.peer.port,network.protocol.version,server.address,server.port,url.path,url.query,url.scheme,user_agent.original
Configuration
| Option | Type | Default | Description |
|---|---|---|---|
otel.instrumentation.common.peer-service-mapping | map | Used to specify a mapping from host names or IP addresses to peer services. | |
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. |