HTTP 插桩配置

捕获 HTTP 请求头和响应头

你可以配置代理,将预定义的 HTTP 头作为 Span 属性进行采集, 符合语义规范。 使用以下属性来定义要采集的 HTTP 头:

System property: otel.instrumentation.http.client.capture-request-headersEnvironment variable: OTEL_INSTRUMENTATION_HTTP_CLIENT_CAPTURE_REQUEST_HEADERS

Description: 以逗号分隔的 HTTP 头名称列表。 HTTP 客户端插桩将采集所有配置的头名称的 HTTP 请求头值。

System property: otel.instrumentation.http.client.capture-response-headersEnvironment variable: OTEL_INSTRUMENTATION_HTTP_CLIENT_CAPTURE_RESPONSE_HEADERS

Description: 以逗号分隔的 HTTP 头名称列表。 HTTP 客户端插桩将采集所有配置的头名称的 HTTP 响应头值。

System property: otel.instrumentation.http.server.capture-request-headersEnvironment variable: OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_REQUEST_HEADERS

Description: 以逗号分隔的 HTTP 头名称列表。 HTTP 服务器插桩将采集所有配置的头名称的 HTTP 请求头值。

System property: otel.instrumentation.http.server.capture-response-headersEnvironment variable: OTEL_INSTRUMENTATION_HTTP_SERVER_CAPTURE_RESPONSE_HEADERS

Description: 以逗号分隔的 HTTP 头名称列表。 HTTP 服务器插桩将采集所有配置的头名称的 HTTP 响应头值。

这些配置选项受所有 HTTP 客户端和服务器插桩支持。

注意:表中列出的属性、环境变量名称仍处于实验阶段,可能会发生变化。

采集 Servlet 请求参数

你可以配置代理,使其为 Servlet API 处理的请求采集预定义的 HTTP 请求参数,并将这些参数作为 Span 属性。 使用以下属性来定义要采集的 Servlet 请求参数:

System property: otel.instrumentation.servlet.experimental.capture-request-parametersEnvironment variable: OTEL_INSTRUMENTATION_SERVLET_EXPERIMENTAL_CAPTURE_REQUEST_PARAMETERS

Description: 以逗号分隔的请求参数名称列表。

注意:表中列出的属性、环境变量名称仍处于实验阶段,可能会发生变化。

配置已知 HTTP 方法

配置插桩以识别一组替代的 HTTP 请求方法。 所有其他方法将被视为 _OTHER

System property: otel.instrumentation.http.known-methodsEnvironment variable: OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS

Default: CONNECT,DELETE,GET,HEAD,OPTIONS,PATCH,POST,PUT,TRACE
Description: 以逗号分隔的已知 HTTP 方法列表。

-->

启用实验性 HTTP 遥测功能

你可以配置代理,采集额外的实验性 HTTP 遥测数据。

System property: otel.instrumentation.http.client.emit-experimental-telemetryEnvironment variable: OTEL_INSTRUMENTATION_HTTP_CLIENT_EMIT_EXPERIMENTAL_TELEMETRY

Default: false
Description: 启用实验性 HTTP 客户端遥测功能。

System property: otel.instrumentation.http.server.emit-experimental-telemetryEnvironment variable: OTEL_INSTRUMENTATION_HTTP_SERVER_EMIT_EXPERIMENTAL_TELEMETRY

Default: false
Description: 启用实验性 HTTP 服务器遥测功能。

对于客户端和服务器 Span,添加以下属性:

  • http.request.body.sizehttp.response.body.size:分别表示请求和响应体的大小。

对于客户端指标,创建以下指标:

对于服务器指标,创建以下指标: