› › › ›

配置基于尾部的采样

配置基于尾部的采样编辑

使用启用基于尾部的采样启用基于尾部的采样。启用后，跟踪事件将映射到采样策略。每个采样策略都必须指定一个采样率，并且可以选择指定其他条件。所有策略条件都必须为真，跟踪事件才能与其匹配。

跟踪事件按指定的顺序与策略匹配。每个策略列表都必须以默认策略结束，该策略仅指定采样率。此默认策略用于捕获与更严格的策略不匹配的剩余跟踪事件。要求使用此默认策略可确保仅有意删除跟踪。如果您启用基于尾部的采样并发送与任何策略都不匹配的事务，则 APM 服务器将拒绝该事务，并显示错误 no matching policy。

请注意，从版本 8.3.1 开始，APM 服务器实现了 3GB 的默认存储限制，但是，由于限制的计算和执行方式，实际磁盘空间可能仍然会略微超过限制。

配置示例编辑

此示例定义了三个基于尾部的采样策略

- sample_rate: 1 
  service.environment: production
  trace.name: "GET /very_important_route"
- sample_rate: .01 
  service.environment: production
  trace.name: "GET /not_important_route"
- sample_rate: .1

	对跟踪名称为 `"GET /very_important_route"` 的 `production` 中的 100% 的跟踪进行采样
	对跟踪名称为 `"GET /not_important_route"` 的 `production` 中的 1% 的跟踪进行采样
	默认策略是对所有剩余跟踪以 10% 的比例进行采样，例如，不同环境（如 `dev`）中的跟踪或具有任何其他名称的跟踪

配置参考编辑

顶级基于尾部的采样设置

启用基于尾部的采样编辑

设置为 true 以启用基于尾部的采样。默认情况下禁用。(布尔值)

APM 服务器二进制文件	`sampling.tail.enabled`
Fleet 管理	`启用基于尾部的采样`

间隔编辑

多个 APM 服务器的同步间隔。应为几十秒或几分钟。默认值：1m（1 分钟）。(持续时间)

APM 服务器二进制文件	`sampling.tail.interval`
Fleet 管理	`间隔`

策略编辑

用于将根事务与采样率匹配的条件。

策略将跟踪事件映射到采样率。每个策略都必须指定一个采样率。跟踪事件按指定的顺序与策略匹配。所有策略条件都必须为真，跟踪事件才能匹配。每个策略列表都应以仅指定采样率的策略结束。此最终策略用于捕获与更严格的策略不匹配的剩余跟踪事件。([]policy)

APM 服务器二进制文件	`sampling.tail.policies`
Fleet 管理	`策略`

存储限制编辑

为匹配尾部采样策略的跟踪事件分配的存储空间量。注意：将此限制设置得高于允许的空间可能会导致 APM 服务器变得不正常。

如果配置的存储限制不足，它将记录“已达到配置的存储限制”。当达到存储限制时，该事件将绕过采样，并且始终会被索引。

默认值：3GB。(文本)

APM 服务器二进制文件	`sampling.tail.storage_limit`
Fleet 管理	`存储限制`

策略设置

采样率编辑

sample_rate

要应用于与此策略匹配的跟踪事件的采样率。每个策略都需要。

采样率必须大于或等于 0 且小于或等于 1。例如，sample_rate 为 0.01 意味着将对与策略匹配的 1% 的跟踪事件进行采样。sample_rate 为 1 意味着将对与策略匹配的 100% 的跟踪事件进行采样。(整数)

跟踪名称编辑

trace.name

要与策略匹配的事件的跟踪名称。当配置的 trace.name 与跟踪的根事务的 transaction.name 匹配时，就会发生匹配。根事务是没有任何 parent.id 的事务。(字符串)

跟踪结果编辑

trace.outcome

要与策略匹配的事件的跟踪结果。当配置的 trace.outcome 与跟踪的 event.outcome 字段匹配时，就会发生匹配。跟踪结果可以是 success、failure 或 unknown。(字符串)

服务名称编辑

service.name

要与策略匹配的事件的服务名称。(字符串)

服务环境编辑

service.environment

要与策略匹配的事件的服务环境。(字符串)

« 配置基于头部的采样日志记录集成 »