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/undertow-1.4.md.

Undertow

OpenTelemetry Java agent instrumentation

This instrumentation enables HTTP server spans and HTTP server metrics for Undertow.

  • Name: undertow-1.4
  • Scope: io.opentelemetry.undertow-1.4
  • Target versions: io.undertow:undertow-core:[1.4.0.Final,)
  • Library: https://undertow.io/

Telemetry

When default

Metrics

MetricInstrumentTypeUnitDescription
http.server.request.durationhistogramHISTOGRAMsDuration of HTTP server requests.
MetricAttributes
http.server.request.durationhttp.request.method (STRING), http.response.status_code (LONG), network.protocol.version (STRING), url.scheme (STRING)

Spans

Span kindAttributes
SERVERclient.address (STRING), error.type (STRING), http.request.method (STRING), http.request.method_original (STRING), http.response.status_code (LONG), network.peer.address (STRING), network.peer.port (LONG), network.protocol.version (STRING), server.address (STRING), server.port (LONG), url.path (STRING), url.query (STRING), url.scheme (STRING), user_agent.original (STRING)

When otel.semconv.exception.signal.preview=logs

Metrics

MetricInstrumentTypeUnitDescription
http.server.request.durationhistogramHISTOGRAMsDuration of HTTP server requests.
MetricAttributes
http.server.request.durationhttp.request.method (STRING), http.response.status_code (LONG), network.protocol.version (STRING), url.scheme (STRING)

Spans

Span kindAttributes
SERVERclient.address (STRING), error.type (STRING), http.request.method (STRING), http.request.method_original (STRING), http.response.status_code (LONG), network.peer.address (STRING), network.peer.port (LONG), network.protocol.version (STRING), server.address (STRING), server.port (LONG), url.path (STRING), url.query (STRING), url.scheme (STRING), user_agent.original (STRING)

Configuration

OptionTypeDefaultDescription
otel.instrumentation.http.known-methodslistCONNECT,DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,TRACEConfigures 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-headerslistList of HTTP request headers to capture in HTTP server telemetry.
otel.instrumentation.http.server.capture-response-headerslistList of HTTP response headers to capture in HTTP server telemetry.
otel.instrumentation.http.server.emit-experimental-telemetrybooleanfalseEnable 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.

Data

  • JSON (latest): /data/javaagent/instrumentations/undertow-1.4/latest.json
  • JSON (pinned): /data/javaagent/instrumentations/undertow-1.4/undertow-1.4-916926528d72.json
  • Explore: /java-agent/instrumentation/undertow-1.4