HTTP 配置选项

对于 HTTP 请求的事务，代理可以选择捕获请求正文，例如 POST 变量。如果请求有正文并且此设置被禁用，则正文将显示为 [已编辑]。此选项不区分大小写。

可能的选项为 off、errors、transactions 和 all

此设置可以在代理启动后更改。

配置要捕获的内容类型。

此选项支持通配符 *，它匹配零个或多个字符。示例：/foo/*/bar/*/baz*、*foo*。匹配不区分大小写。

此设置可以在代理启动后更改。

如果设置为 true，则代理将捕获请求和响应标头，包括 cookie。

有效选项：continue、restart、restart_external。

由 Elastic APM .NET 代理跟踪的请求的 traceparent 标头可能已由第三方组件添加。

随着 w3c 跟踪上下文被采用，这种情况变得越来越普遍。在这种情况下，您可能会得到跟踪的一部分位于 Elastic APM 之外的跟踪。

为了正确处理这种情况，代理提供了具有以下值和行为的跟踪延续策略

这用于限制对某些 URL 的请求进行检测。

此属性应设置为包含一个或多个路径的逗号分隔字符串。

例如，为了忽略 URL /foo 和 /bar，请将配置值设置为 "/foo,/bar"。

当检测到传入的 HTTP 请求时，其请求路径将针对此列表中的每个元素进行测试。例如，将 /home/index 添加到此列表将匹配并从以下 URL 中删除检测

https://www.mycoolsite.com/home/index
https://127.0.0.1/home/index
http://whatever.com/home/index?value1=123

换句话说，匹配始终基于请求路径发生，主机和查询字符串将被忽略。

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

使用此选项，您可以使用通配符表达式对包含动态部分的事务名称进行分组。例如，模式 GET /user/*/cart 将合并事务，例如 GET /users/42/cart 和 GET /users/73/cart，成为单个事务名称 GET /users/*/cart，从而减少事务名称的基数。

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

要启用分布式跟踪，代理会将跟踪上下文标头添加到使用 HttpClient 类型发出的传出 HTTP 请求中。这些标头（traceparent 和 tracestate）在 W3C 跟踪上下文规范中定义。

当此设置是 true 时，代理还会添加标头 elasticapm-traceparent，以向后兼容旧版本的 Elastic APM 代理。在 1.3.0 之前的版本只读取 elasticapm-traceparent 标头。

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

当 APM 代理发出的请求应在服务器请求时使用当前登录用户的凭据进行身份验证时，将此属性设置为 true。

当在代理上使用 Windows 身份验证时，这非常有用，该代理将 APM 代理请求路由到 APM 服务器。

控制哪些行李值会自动附加到给定的事件（事务、跨度、错误）。行李值来自 W3C 行李规范中定义的 baggage 标头。您可以通过 Activity API 以编程方式写入和读取行李值。有关更多详细信息，请参阅我们关于如何与 OpenTelemetry 集成的文档。

该代理使用 W3C 跟踪上下文规范和标准进行分布式跟踪。W3C 跟踪上下文规范中的 traceparent 标头定义了一个采样标志，该标志从调用方服务传播到被调用方服务，并决定是否在被调用方服务中对跟踪进行采样。该代理的默认行为是遵循采样标志值并据此进行操作。

在某些情况下，您可能希望更改代理关于采样标志的默认行为。通过将 TraceContextIgnoreSampled 配置值设置为 true，当 W3C 跟踪上下文 traceparent 标头的采样标志的值为 false 且 不存在代理特定的 tracestate 标头值时，代理将忽略该采样标志。在忽略采样标志的情况下，代理会根据采样率做出采样决策。当调用方服务始终将采样标志值设置为 false 时，这可能很有用，这将导致代理永远不会对任何事务进行采样。