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/tomcat-7.0.md.

Apache Tomcat

OpenTelemetry Java agent instrumentation

This instrumentation enables HTTP server spans and HTTP server metrics for Apache Tomcat.

  • Name: tomcat-7.0
  • Scope: io.opentelemetry.tomcat-7.0
  • Target versions: org.apache.tomcat.embed:tomcat-embed-core:[7.0.4, 10)
  • Library: https://tomcat.apache.org/

Telemetry

  • Metrics: http.server.request.duration
  • Span attributes: client.address, error.type, http.request.method, http.request.method_original, 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

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.
otel.instrumentation.servlet.experimental-span-attributesbooleanfalseEnables capturing the experimental servlet.timeout span attribute.
otel.instrumentation.servlet.experimental.capture-request-parameterslistList of request parameter names to capture as span attributes.

Data

  • JSON: /data/javaagent/instrumentations/tomcat-7.0/tomcat-7.0-bba336117efb.json
  • Explore: /java-agent/instrumentation/tomcat-7.0