# 摄取跨度以获得完全可见性
摄取跨度

 所有交易跨度的记录可以帮助全面了解应用程序问题。借助该记录，您能够调试客户支持票证或对罕见的 p99 API 延迟峰值进行故障排除，在面向客户的应用程序和任务关键型应用程序中，这对于确定问题的根本原因至关重要。通过配置头部采样率，然后调整较低的跨度索引率，您可以创建经济高效的策略，从而在 CloudWatch 中开始捕获 100% 的跟踪跨度。

## 设置头部采样


 头部采样是一种跟踪技术，它基于设定的速率或条件，在跟踪开始时捕获请求。

 当头部采样率设置为 100% 时，它不会跳过任何跟踪，而会捕获每条跟踪的开头，从而保证对所有传入请求的完全可见性，并且不会丢失任何交易数据。

 如果您使用的是 X-Ray 或适用于 OpenTelemetry SDK 的 Amazon Distro 或 OpenTelemetry SDK，则可以配置头部采样。

**如果您使用的是 X-Ray 或适用于 OpenTelemetry SDK 的 Amazon Distro**  
 在控制台中导航到采样规则，并将固定采样率设置为 100%。此举可以确保捕获所有跟踪跨度并将其摄取到 CloudWatch 日志中。有关更多信息，请参阅 [Configuring sampling rules](https://docs.amazonaws.cn/xray/latest/devguide/xray-console-sampling.html#xray-console-config)。

**如果您使用 OpenTelemetry SDK**  
 要记录 100% 的跨度并获得完全可见性，请将采样配置设置为 [https://opentelemetry.io/docs/languages/java/sdk/#sampler](https://opentelemetry.io/docs/languages/java/sdk/#sampler)。有关更多信息，请参阅 OpenTelemetry 网站上的 [Language APIs & SDKs]()。

### 通过头部采样解锁功能


 启用 Transaction Search 后，通过头部采样从应用程序收集的所有跨度都将作为结构化日志摄取到 CloudWatch 中。此方案具有以下功能：
+  能够在可视化编辑器中搜索跨度属性并分析跨度事件。
+  能够对最多有 10000 个跨度的跟踪进行可视化。
+  能够将业务事件嵌入到跨度中进行分析，以及使用跨度链接定义跟踪之间的连接以进行端到端查看，从而对 OpenTelemetry 提供全面支持。
+  为发送到 CloudWatch 的所有跨度启用 CloudWatch Application Signals 时，即可访问应用程序控制面板、指标和拓扑。

**注意**  
 由于跨度在名为 `aws/spans` 的日志组中处于可用状态，因此您可以将 CloudWatch Logs 功能与交易跨度结合使用。有关更多信息，请参阅 [The span log group](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search-ingesting-span-log-groups.html)。

## 使用跟踪摘要设置跨度索引


 跟踪摘要可以帮助您调试交易，并且对异步处理大有帮助。您只需要将一小部分跨度索引为跟踪摘要。

 您可以在控制台或使用 API 启用 Transaction Search 时，配置跨度索引。要启用 Transaction Search，请参阅[开始使用 Transaction Search](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search-getting-started.html)。

### 通过跟踪摘要解锁功能


 X-Ray 跟踪摘要的主要功能包括：
+  [跟踪摘要搜索](https://docs.amazonaws.cn/xray/latest/devguide/xray-console-traces.html?icmpid=docs_xray_help_panel_traces#xray-console-traces-view) – 搜索和查找跟踪摘要中的跟踪。
+  [跟踪摘要分析](https://docs.amazonaws.cn/xray/latest/devguide/xray-console-analytics.html) – 解释跟踪数据。
+  [跟踪洞察](https://docs.amazonaws.cn/xray/latest/devguide/xray-console-insights.html) – 分析跟踪数据以识别应用程序问题。