HTTP 配置选项
编辑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)
使匹配区分大小写。
默认值 | 类型 | 动态 |
---|---|---|
|
列表 |
true |
Java 系统属性 | 属性文件 | 环境变量 |
---|---|---|
|
|
|
transaction_ignore_urls
编辑用于限制对某些 URL 的请求不被检测。
此属性应设置为包含一个或多个字符串的数组。检测到传入的 HTTP 请求时,将针对此列表中的每个元素测试其 URL。
此选项支持通配符 *
,它匹配零个或多个字符。示例:/foo/*/bar/*/baz*
,*foo*
。默认情况下,匹配不区分大小写。在元素前面加上 (?-i)
使匹配区分大小写。
默认值 | 类型 | 动态 |
---|---|---|
|
列表 |
true |
Java 系统属性 | 属性文件 | 环境变量 |
---|---|---|
|
|
|
transaction_ignore_user_agents
( [1.22.0] 在 1.22.0 版本中添加。 )
编辑用于限制来自某些 User-Agent 的请求不被检测。
检测到传入的 HTTP 请求时,将针对此列表中的每个元素测试请求头中的 User-Agent。示例:curl/*
,*pingdom*
此选项支持通配符 *
,它匹配零个或多个字符。示例:/foo/*/bar/*/baz*
,*foo*
。默认情况下,匹配不区分大小写。在元素前面加上 (?-i)
使匹配区分大小写。
默认值 | 类型 | 动态 |
---|---|---|
|
列表 |
true |
Java 系统属性 | 属性文件 | 环境变量 |
---|---|---|
|
|
|
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 分组在一起来减轻此问题。
默认值 | 类型 | 动态 |
---|---|---|
|
布尔值 |
true |
Java 系统属性 | 属性文件 | 环境变量 |
---|---|---|
|
|
|
url_groups
(已弃用)
编辑已弃用,建议使用 transaction_name_groups
。
仅当 use_path_as_transaction_name
处于活动状态时,才会考虑此选项。
使用此选项,您可以使用通配符表达式(例如 /user/*
)将多个 URL 路径组合在一起。
此选项支持通配符 *
,它匹配零个或多个字符。示例:/foo/*/bar/*/baz*
,*foo*
。默认情况下,匹配不区分大小写。在元素前面加上 (?-i)
使匹配区分大小写。
默认值 | 类型 | 动态 |
---|---|---|
|
列表 |
true |
Java 系统属性 | 属性文件 | 环境变量 |
---|---|---|
|
|
|
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
字段中。
默认值 | 类型 | 动态 |
---|---|---|
|
整数 |
true |
Java 系统属性 | 属性文件 | 环境变量 |
---|---|---|
|
|
|