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

啟用 JavaScript 錯誤堆疊追蹤的明瞭

當您的 Web 應用程式 JavaScript 原始程式碼已簡化時，錯誤堆疊追蹤可能難以讀取。您可以將來源映射上傳到 Amazon S3，以啟用堆疊追蹤的不簡化。CloudWatch RUM 將擷取來源映射，以將簡化原始碼中的行號和欄號映射回原始未簡化原始碼。這將提高錯誤堆疊追蹤的可讀性，並有助於識別原始原始原始程式碼中錯誤的位置。

要求與語法

來源映射對於跨不同版本偵錯和追蹤 Web 應用程式的問題至關重要。請確定每個 Web 應用程式版本都有唯一的來源映射。每個版本都應有自己的唯一 releaseId。releaseId 必須是長度介於 1 到 200 個字元之間的字串，而且只能包含字母、數字、底線、連字號、冒號、斜線和句點。若要將 releaseId作為中繼資料新增至 RUM 事件，請設定 CloudWatch RUM Web 用戶端。

根據 Source Map V3 規格所定義的結構，來源映射應該是純 JSON 檔案。必要欄位為：version、file、names、 sources和 mappings。

請確定每個來源映射的大小不超過 50 MB 的限制。此外，RUM 服務只會擷取每個堆疊追蹤最多 50 MB 的來源映射。如有需要，請將原始程式碼分割成多個較小的區塊。如需詳細資訊，請參閱使用 WebpackJS 進行程式碼分割。

設定 Amazon S3 儲存貯體資源政策以允許 RUM 服務存取

請確定您的 Amazon S3 儲存貯體與 RUM appMonitor 位於相同的區域。設定 Amazon S3 儲存貯體以允許 RUM 服務存取，以擷取來源映射檔案。包含 aws:SourceArn和 aws:SourceAccount全域條件內容索引鍵，以限制服務對 資源的許可。這是防止混淆代理人問題最有效的方式。

下列範例示範如何在 Amazon S3 中使用 aws:SourceArn和 aws:SourceAccount全域條件內容金鑰，以防止混淆代理人問題。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RUM Service S3 Read Permissions",
            "Effect": "Allow",
            "Principal": {
                "Service": "rum.amazonaws.com"
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::BUCKET_NAME",
                "arn:aws:s3:::BUCKET_NAME/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "ACCOUNT_ID",
                    "aws:SourceArn": "arn:aws:rum:REGION:ACCOUNT_ID:appmonitor/APP_MONITOR_NAME"
                }
            }
        }
    ]
}

如果您使用 AWS KMS 金鑰來加密資料，請確定金鑰的資源政策設定類似，以包含 aws:SourceArn和 aws:SourceAccount全域條件內容金鑰，讓 RUM 服務能夠使用金鑰來擷取來源映射檔案。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RUM Service KMS Read Permissions",
            "Effect": "Allow",
            "Principal": {
                "Service": "rum.amazonaws.com"
            },
            "Action": "kms:Decrypt",
            "Resource": "arn:aws:kms:REGION:ACCOUNT_ID:key/KEY_ID",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "ACCOUNT_ID",
                    "aws:SourceArn": "arn:aws:rum:REGION:ACCOUNT_ID/APP_MONITOR_NAME"
                }
            }
        }
    ]
}

上傳來源映射

設定您的 JavaScript 套件，以在縮小期間產生來源映射。當您建置應用程式時，套件會建立目錄 （例如 dist)，其中包含已簡化的 JavaScript 檔案及其對應的來源映射。如需範例，請參閱下列內容。

./dist
    |-index.d5a07c87.js
    |-index.d5a07c87.js.map

將來源映射檔案上傳至 Amazon S3 儲存貯體。檔案應位於名稱releaseId為 的資料夾中。例如，如果我的儲存貯體名稱是 my-application-source-maps，而 releaseId是 2.0.0，則來源映射檔案位於下列位置：

my-application-source-maps
    |-2.0.0
        |-index.d5a07c87.js.map

若要自動上傳來源映射，您可以建立下列 bash 指令碼，並在建置程序中執行它。

#!/bin/bash
# Ensure the script is called with required arguments
if [ "$#" -ne 2 ]; then
 echo "Usage: $0 S3_BUCKET_NAME RELEASE_ID"
 exit 1
fi

# Read arguments
S3_BUCKET="$1"
RELEASE_ID="$2"

# Set the path to your build directory
BUILD_DIR="./dist"


# Upload all .map files recursively
 if aws s3 cp "$BUILD_DIR" "s3://$S3_BUCKET/$RELEASE_ID/" --recursive --exclude "*" --include "*.map"; then
    echo "Successfully uploaded all source map files"
else
    echo "Failed to upload source map files"
fi

在 CloudWatch RUM Web 用戶端中設定 releaseId

CloudWatch RUM 使用設定的 releaseId 來判斷資料夾，以擷取來源映射檔案。將與來源映射檔案資料夾releaseId相同的 命名。如果您使用上述或類似的 bash 指令碼，則指令碼中releaseId設定的 應與 CloudWatch RUM Web 用戶端中設定的 相同。您必須使用 1.21.0 版或更新版本的 CloudWatch RUM Web 用戶端。

import { AwsRum, AwsRumConfig } from "aws-rum-web";

try {
    const config: AwsRumConfig = {
        sessionSampleRate: 1,
        endpoint: "https://dataplane.rum.us-west-2.amazonaws.com",
        telemetries: ["performance", "errors", "http"],
        allowCookies: true,
        releaseId: "RELEASE_ID", //Add this
    };

    const APPLICATION_ID: string = "APP_MONITOR_ID";
    const APPLICATION_VERSION: string = "1.0.0";
    const APPLICATION_REGION: string = "us-west-2";

    new AwsRum(APPLICATION_ID, APPLICATION_VERSION, APPLICATION_REGION, config);
} catch (error: any) {
    // Ignore errors thrown during CloudWatch RUM web client initialization
}

啟用 CloudWatch RUM 應用程式監控來取消最小化 JavaScript 堆疊追蹤

若要取消最小化 JavaScript 堆疊追蹤，請將應用程式監視器的 SourceMap 狀態設定為 ENABLED。將 Amazon S3 URI 提供給包含應用程式監視器所有來源映射的儲存貯體或資料夾。

將來源映射直接存放在主儲存貯體 （而非子資料夾中） 時，Amazon S3 URI 應格式化為 Amazon S3://BUCKET_NAME。在此情況下，來源映射檔案應位於下列位置。

BUCKET_NAME
    |- RELEASE_ID
        |-index.d5a07c87.js.map

當子目錄是根目錄時，Amazon S3 URI 應該格式化為 Amazon S3://BUCKET_NAME/DIRECTORY。在此情況下，來源映射檔案應位於下列位置。

BUCKET_NAME
    |- DIRECTORY
        |-RELEASE_ID
            |-index.d5a07c87.js.map

在 RUM 主控台中檢視未縮小的堆疊追蹤

將來源映射上傳至 Amazon S3、在 RUM 應用程式監視器上啟用來源映射，並使用在 CloudWatch RUM Web 用戶端中releaseId設定的 來部署 Web 應用程式後，請選取 RUM 主控台中的事件。此標籤會顯示原始 RUM 事件資料。依 JS 錯誤事件類型篩選，並檢視最新的 JS 錯誤事件。對於啟用此功能後擷取的事件，您會在新event_details.unminifiedStack欄位中看到未縮小的堆疊追蹤。

在 CloudWatch Logs 中檢視未縮小的堆疊追蹤

開啟資料儲存，在 CloudWatch Logs 中啟用 RUM 事件儲存。 啟用後，您可以搜尋新的 event_details.unminifiedStack 欄位。這可讓您使用 CloudWatch Logs 查詢分析趨勢並關聯多個工作階段的問題。

對來源映射進行故障診斷

CloudWatch RUM 提供立即可用的指標，以疑難排解您的來源映射設定。這些指標會名稱為 AWS/RUM 的命名空間中發佈。下列指標會以 application_name 維度發佈。此維度的值是應用程式監控的名稱。這些指標也會以 aws:releaseId維度發佈。此維度的值是與 JavaScript 錯誤事件releaseId相關聯的 。

CloudWatch RUM 可能會因各種原因而無法取消縮小堆疊追蹤中的一行，包括但不限於：