啟用交易搜尋 - Amazon CloudWatch
在主控台中啟用交易搜尋使用 API 啟用交易搜尋

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

啟用交易搜尋

您可以透過 交易搜尋 主控台或使用 API 來啟用 。交易搜尋是針對整個帳戶設定，並使用 Amazon CloudWatch 定價，透過 X-Ray 將所有範圍擷取切換為符合成本效益的收集模式。根據預設，您也將免費索引 1% 的擷取範圍作為分析的追蹤摘要，這通常就足夠了，因為您已經透過交易搜尋對所有擷取的範圍擁有完整的end-to-end追蹤可見性。

在主控台中啟用交易搜尋

下列程序說明如何在 主控台中啟用交易搜尋。

在 CloudWatch 主控台中啟用交易搜尋

  1. 透過 https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

  2. 從導覽窗格的 Application Signals 下，選擇交易搜尋。

  3. 選擇啟用交易搜尋。

  4. 選取要擷取為結構化日誌的方塊，然後輸入要編製索引的跨度百分比。您可以免費為 1% 的範圍編製索引，並在稍後根據您的需求變更百分比。

使用 API 啟用交易搜尋

下列程序說明如何使用 API 啟用交易搜尋。

步驟 1. 建立政策以授予 CloudWatch Logs 中擷取範圍的存取權

使用 AWS CLI 或 SDK 啟用交易搜尋時，您必須使用資源型政策搭配 來設定許可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"
                }
            }
        }
    ]
}
範例 命令

下列範例顯示如何使用 格式化 AWS CLI 命令PutResourcePolicy。

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。

範例 命令

下列範例顯示如何使用 格式化 AWS CLI 命令UpdateTraceSegmentDestination。

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

步驟 3。設定要編製索引的跨度數量

使用 設定所需的取樣百分比 UpdateIndexingRule

範例 命令

下列範例顯示如何使用 格式化 AWS CLI 命令UpdateIndexingRule。

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

啟用交易搜尋後，可能需要 10 分鐘才能讓範圍可供搜尋和分析。

步驟 4. 確認範圍可用於搜尋和分析

若要驗證可用於搜尋和分析的跨度，請使用 GetTraceSegmentDestination。

命令範例

下列範例顯示如何使用 格式化 AWS CLI 命令GetTraceSegmentDestination。

aws xray get-trace-segment-destination
回應範例

下列範例顯示交易搜尋處於作用中狀態時，您可以預期的回應。

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