启用事务搜索 - Amazon CloudWatch
在控制台中启用 Transaction Search使用 API 启用 Transaction Search

启用事务搜索

您可以通过控制台或使用 API 启用 Transaction Search。针对整个账户进行了事务搜索配置，并通过 X-Ray 将所有跨度摄取切换为使用 Amazon CloudWatch 定价的经济高效的收集模式。默认情况下，您还将免费为 1% 的已摄取跨度建立索引，作为分析用的跟踪摘要，鉴于您已经可以通过事务搜索全面查看所有已摄取跨度的端到端跟踪，这通常已经足够。

在控制台中启用 Transaction Search

以下过程介绍如何在控制台中启用 Transaction Search。

在 CloudWatch 控制台中启用 Transaction Search

  1. 通过 https://console.aws.amazon.com/cloudwatch/ 打开 CloudWatch 控制台。

  2. 在导航窗格的 Application Signals 下，选择交易搜索。

  3. 选择启用 Transaction Search。

  4. 选中将跨度作为结构化日志摄取的框，然后输入要编制索引的跨度百分比。您可以免费将跨度编制 1% 的索引，稍后再根据要求更改百分比。

使用 API 启用 Transaction Search

以下过程介绍如何使用 API 启用 Transaction Search。

第 1 步：创建授予访问在 CloudWatch Logs 中摄取跨度的策略

使用 AWS CLI 或 SDK 启用 Transaction Search 时，必须使用基于资源的策略（具有 PutResourcePolicy）配置权限。

策略示例

以下示例策略允许 X-Ray 向 CloudWatch Logs 发送跟踪 

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "TransactionSearchXRayAccess",
            "Effect": "Allow",
            "Principal": {
                "Service": "xray.amazonaws.com"
            },
            "Action": "logs:PutLogEvents",
            "Resource": [
                "arn:partition:logs:region:account-id:log-group:aws/spans:*",
                "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*"
            ],
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:partition:xray:region:account-id:*"
                },
                "StringEquals": {
                    "aws:SourceAccount": "account-id"
                }
            }
        }
    ]
}
示例命令

以下示例说明如何使用 PutResourcePolicy 格式化处理 AWS CLI 命令。

aws logs put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:partition:logs:region:account-id:log-group:aws/spans:*", "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:partition:logs:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}'

第 2 步：配置跟踪分段的目的地

配置具有 UpdateTraceSegmentDestination 的跨度的摄取。

示例命令

以下示例说明如何使用 UpdateTraceSegmentDestination 格式化处理 AWS CLI 命令。

aws xray update-trace-segment-destination --destination CloudWatchLogs

第 3 步：配置要索引的跨度数量

使用 UpdateIndexingRule 配置所需的采样百分比

示例命令

以下示例说明如何使用 UpdateIndexingRule 格式化处理 AWS CLI 命令。

aws xray update-indexing-rule --name "Default" --rule '{"Probabilistic": {"DesiredSamplingPercentage": number}}'
注意

启用 Transaction Search 后，可能需要十分钟才能使用跨度进行搜索和分析。

第 4 步：验证跨度是否可供搜索和分析

要验证跨度是否可供搜索和分析，请使用 GetTraceSegmentDestination。

示例命令

以下示例说明如何使用 GetTraceSegmentDestination 格式化处理 AWS CLI 命令。

aws xray get-trace-segment-destination
响应示例

以下示例显示了当 Transaction Search 处于活动状态时的预期响应。

{
    "Destination": "CloudWatchLogs",
    "Status": "ACTIVE"
}