HTTP 配置选项

编辑

capture_body_content_types ( [1.5.0] 在 1.5.0 版本中添加。 性能)

编辑

配置要记录的 content type。

默认值以通配符结尾,以便也捕获诸如 text/plain; charset=utf-8 之类的 content type。

此选项支持通配符 *,它匹配零个或多个字符。示例:/foo/*/bar/*/baz**foo*。默认情况下,匹配不区分大小写。在元素前面加上 (?-i) 使匹配区分大小写。

dynamic config

默认值 类型 动态

application/x-www-form-urlencoded*, text/*, application/json*, application/xml*

列表

true

Java 系统属性 属性文件 环境变量

elastic.apm.capture_body_content_types

capture_body_content_types

ELASTIC_APM_CAPTURE_BODY_CONTENT_TYPES

transaction_ignore_urls

编辑

用于限制对某些 URL 的请求不被检测。

此属性应设置为包含一个或多个字符串的数组。检测到传入的 HTTP 请求时,将针对此列表中的每个元素测试其 URL。

此选项支持通配符 *,它匹配零个或多个字符。示例:/foo/*/bar/*/baz**foo*。默认情况下,匹配不区分大小写。在元素前面加上 (?-i) 使匹配区分大小写。

dynamic config

默认值 类型 动态

/VAADIN/*, /heartbeat*, /favicon.ico, *.js, *.css, *.jpg, *.jpeg, *.png, *.gif, *.webp, *.svg, *.woff, *.woff2

列表

true

Java 系统属性 属性文件 环境变量

elastic.apm.transaction_ignore_urls

transaction_ignore_urls

ELASTIC_APM_TRANSACTION_IGNORE_URLS

transaction_ignore_user_agents ( [1.22.0] 在 1.22.0 版本中添加。 )

编辑

用于限制来自某些 User-Agent 的请求不被检测。

检测到传入的 HTTP 请求时,将针对此列表中的每个元素测试请求头中的 User-Agent。示例:curl/**pingdom*

此选项支持通配符 *,它匹配零个或多个字符。示例:/foo/*/bar/*/baz**foo*。默认情况下,匹配不区分大小写。在元素前面加上 (?-i) 使匹配区分大小写。

dynamic config

默认值 类型 动态

<无>

列表

true

Java 系统属性 属性文件 环境变量

elastic.apm.transaction_ignore_user_agents

transaction_ignore_user_agents

ELASTIC_APM_TRANSACTION_IGNORE_USER_AGENTS

use_path_as_transaction_name ( [1.0.0] 在 1.0.0 版本中添加。从 1.22.0 版本开始,可以在运行时更改此值 )

编辑

如果设置为 true,则不支持或部分支持的框架的事务名称将采用 $method $path 的形式,而不是仅采用 $method unknown route

如果您的 URL 包含路径参数,例如 /user/$userId,则启用此标志时应非常小心,因为它可能导致事务组数量激增。查看 transaction_name_groups 选项,了解如何通过将 URL 分组在一起来减轻此问题。

dynamic config

默认值 类型 动态

false

布尔值

true

Java 系统属性 属性文件 环境变量

elastic.apm.use_path_as_transaction_name

use_path_as_transaction_name

ELASTIC_APM_USE_PATH_AS_TRANSACTION_NAME

url_groups (已弃用)

编辑

已弃用,建议使用 transaction_name_groups

仅当 use_path_as_transaction_name 处于活动状态时,才会考虑此选项。

使用此选项,您可以使用通配符表达式(例如 /user/*)将多个 URL 路径组合在一起。

此选项支持通配符 *,它匹配零个或多个字符。示例:/foo/*/bar/*/baz**foo*。默认情况下,匹配不区分大小写。在元素前面加上 (?-i) 使匹配区分大小写。

dynamic config

默认值 类型 动态

<无>

列表

true

Java 系统属性 属性文件 环境变量

elastic.apm.url_groups

url_groups

ELASTIC_APM_URL_GROUPS

capture_http_client_request_body_size ( [1.52.0] 在 1.52.0 版本中添加。 实验性)

编辑

此功能目前处于实验阶段,这意味着它默认情况下处于禁用状态,并且不保证在将来的版本中向后兼容。

配置应捕获的前 n 个字节的 http 客户端请求正文。请注意,只有对于与 transaction_name_groups 配置匹配的 content type,才会捕获请求正文。最大允许值为 1024,值为 0 将禁用正文捕获。

目前仅支持 Apache Http Client v4 和 v5、HttpUrlConnection、Spring Webflux WebClient 和基于这些的其他框架(例如 Spring RestTemplate)。

正文将存储在跨度文档的 labels.http_request_body_content 字段中。

dynamic config

默认值 类型 动态

0

整数

true

Java 系统属性 属性文件 环境变量

elastic.apm.capture_http_client_request_body_size

capture_http_client_request_body_size

ELASTIC_APM_CAPTURE_HTTP_CLIENT_REQUEST_BODY_SIZE