在 X-Ray 控制台中配置采样规则

• API 网关 Entrypoint – API 网关 支持采样和主动跟踪。要在 API 阶段启用主动跟踪，请参阅针对 AWS X-Ray 的 Amazon API Gateway 活动跟踪支持。

• AWS AppSync – AWS AppSync 支持采样和主动跟踪。要对 AWS AppSync 请求启用主动跟踪，请参阅 使用 AWS X-Ray 进行跟踪。

• 分析计算平台上的 X-Ray 开发工具包 – 在使用诸如 Amazon EC2、Amazon ECS 或 AWS Elastic Beanstalk 等计算平台时，如果使用最新版本的 X-Ray 开发工具包分析应用，则支持采样。

采样规则选项

• 规则名称（字符串） – 一个唯一的规则名称。

• 优先级（1 和 9999 之间的整数） – 采样规则的优先级。服务按优先级的上升顺序评估规则，并与匹配的第一条规则进行抽样决策。

• Reservoir (容器)（非负整数）– 在应用固定比率之前，每秒与仪器匹配的固定请求数。该容器不由服务直接使用，但适用于所有使用该规则的服务。

• 速率（0 到 100 之间的数字） – 容器耗尽后，与仪器相匹配的请求百分比。速率可以是整数或浮点数。

• Service name (服务名称)（字符串）– 分析过的服务在服务地图中呈现的名称。

  • X-Ray 开发工具包 – 您在记录器上配置的服务名称。

  • Amazon API Gateway – api-name/stage。

• Service type (服务类型)（字符串）– 在服务地图中呈现的服务类型。对于 X-Ray 开发工具包，请通过应用合适的插件来设置服务类型：

  • AWS::ElasticBeanstalk::Environment – AWS Elastic Beanstalk 环境（插件）。

  • AWS::EC2::Instance – Amazon EC2 实例（插件）。

  • AWS::ECS::Container – Amazon ECS 容器（插件）。

  • AWS::APIGateway::Stage – Amazon API Gateway 阶段。

  • AWS::AppSync::GraphQLAPI – AWS AppSync API 请求。

• 主机（字符串） – HTTP 主机标头中的主机名。

• HTTP method (HTTP 方法)字符串 – HTTP 请求的方法。

• URL path (URL 路径)字符串 – 请求的 URL 路径。

  • X-Ray 开发工具包 – HTTP 请求 URL 的路径部分。

  • Amazon API Gateway – 不支持。

• Resource ARN (资源 ARN)（字符串）– 运行服务的 AWS 资源的 ARN。

  • X-Ray 开发工具包 – 不支持。该开发工具包只能将规则与设置为 * 的 Resource ARN (资源 ARN) 结合使用。

  • Amazon API Gateway – 阶段 ARN。

• （可选）Attributes (属性)（键和值）– 在做出采样决定时已知的片段属性。

  • X-Ray 开发工具包 – 不支持。该开发工具包将忽略指定属性的规则。

  • Amazon API Gateway – 来自原始 HTTP 请求的标头。

• Java – 采样规则

• Go – 采样规则

• Node.js – 采样规则

• Python – 采样规则

• Ruby – 采样规则

• .NET – 采样规则

采样统计数据

• Total matched rule (匹配的总规则数) – 与此规则匹配的请求数。此数字不包含可能与此规则匹配但先与优先级更高的规则匹配的请求。

• Total sampled (总采样数) – 已记录的请求数。

• Sampled with fixed rate (以固定比率采样) – 通过应用规则的固定比率采样的请求数。

• Sampled with reservoir limit (在容器限制下采样) – 使用由 X-Ray 分配的配额采样的请求数。

• Borrowed from reservoir (已从容器借用) – 通过从容器借用来采样的请求数。当某个服务首次将请求与规则匹配时，X-Ray 尚未向它分配配额。但是，如果容器至少为 1，该服务会每秒借用一个跟踪，直到 X-Ray 分配一个配额。