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

對失敗的 Canary 進行故障診斷

如果 Canary 失敗，請檢查以下內容進行故障診斷。

一般性問題的故障診斷

Canary 在 Lambda 環境更新後失敗

CloudWatch Synthetics Canary 會在您的帳戶中實作為 Lambda 函數。這些 Lambda 函數受制於定期 Lambda 執行期更新，其中包含安全性更新、錯誤修正和其他改進。Lambda 致力於提供與現有函數回溯相容的執行期更新。但是與軟體修補一樣，在極少數情況下，執行階段更新可能會對現有函數產生負面影響。如果您認為 Canary 受到 Lambda 執行期更新的影響，您可以使用 Lambda 執行期管理手動模式 （在支援的區域中） 暫時轉返 Lambda 執行期版本。這可讓您的 Canary 函數正常運作，並將中斷降至最低，在返回最新的執行時間版本之前，提供時間修正不相容的問題。

如果您的 Canary 在 Lambda 執行時間更新後失敗，最佳解決方案是升級至最新的 Synthetics 執行時間之一。如需最新執行時間的詳細資訊，請參閱 Synthetics 執行時間版本。

作為替代解決方案，在可使用 Lambda 執行期管理控制項的區域中，您可以使用手動模式進行執行期管理控制項，將 Canary 還原至較舊的 Lambda 受管執行期。您可以使用 AWS CLI 或使用 Lambda 主控台，使用下列各節中的步驟來設定手動模式。

先決條件

步驟 1：取得 Lambda 函數 ARN

執行下列命令，從回應擷取 EngineArn 欄位。EngineArn 這是與 Canary 相關聯的 Lambda 函數 ARN。您將在下列步驟中使用此 ARN。

aws synthetics get-canary --name my-canary | jq '.Canary.EngineArn'

的範例輸出EngingArn：

"arn:aws:lambda:us-west-2:123456789012:function:cwsyn-my-canary-dc5015c2-db17-4cb5-afb1-EXAMPLE991:8"

步驟 2：取得最後一個良好的 Lambda 執行時間版本 ARN

為了協助了解您的 Canary 是否受到 Lambda 執行期更新的影響，請檢查日誌中 Lambda 執行期版本 ARN 變更的日期和時間是否出現在您看到 Canary 影響的日期和時間。如果不相符，可能不是導致您問題的 Lambda 執行時間更新。

如果您的 Canary 受到 Lambda 執行時間更新的影響，您必須識別您先前使用的工作 Lambda 執行時間版本的 ARN。請遵循識別執行時間版本變更中的指示，尋找先前執行時間的 ARN。記錄執行時間版本 ARN，並繼續步驟 3。 用於設定執行時間管理組態。

如果您的 Canary 尚未受到 Lambda 環境更新的影響，則可以找到您目前使用的 Lambda 執行時間版本的 ARN。執行下列命令，從回應擷取 RuntimeVersionArn Lambda 函數的 。

aws lambda get-function-configuration \
--function-name "arn:aws:lambda:us-west-2:123456789012:function:cwsyn-my-canary-dc5015c2-db17-4cb5-afb1-EXAMPLE991:8" | jq '.RuntimeVersionConfig.RuntimeVersionArn'

的範例輸出RuntimeVersionArn：

"arn:aws:lambda:us-west-2::runtime:EXAMPLE647b82f490a45d7ddd96b557b916a30128d9dcab5f4972911ec0f"

步驟 3：更新 Lambda 執行時間管理組態

您可以使用 AWS CLI 或 Lambda 主控台來更新執行時間管理組態。

使用 設定 Lambda 執行期管理組態手動模式 AWS CLI

輸入下列命令，將 Lambda 函數的執行時間管理變更為手動模式。請務必使用您在步驟 1 中找到的值，將 function-name 和限定詞分別取代為 Lambda 函數 ARN 和 Lambda 函數版本編號。也請將 runtime-version-arn 取代為您在步驟 2 中找到的版本 ARN。

aws lambda put-runtime-management-config \
    --function-name "arn:aws:lambda:us-west-2:123456789012:function:cwsyn-my-canary-dc5015c2-db17-4cb5-afb1-EXAMPLE991" \
    --qualifier 8 \
    --update-runtime-on "Manual" \
    --runtime-version-arn "arn:aws:lambda:us-west-2::runtime:a993d90ea43647b82f490a45d7ddd96b557b916a30128d9dcab5f4972911ec0f"

我的 Canary 被 封鎖 AWS WAF

若要允許 Canary 流量通過 AWS WAF，請建立 AWS WAF 字串比對條件，以允許您指定的自訂字串。如需詳細資訊，請參閱 AWS WAF 文件中的使用字串比對條件。

我們強烈建議您使用自己的自訂使用者代理程式字串，而不是使用預設值。這可更好地控制 AWS WAF 篩選並改善安全性。

若要設定自訂使用者代理程式字串，請執行下列動作：

等待元素出現

分析日誌和螢幕擷取畫面後，如果您看到指令碼正在等待元素出現在螢幕上並逾時，請檢查相關的螢幕擷取畫面，看看元素是否出現在頁面上。確認您的 xpath，以確保它正確無誤。

對於 Puppetteer 相關問題，請檢查 Puppeteer 的 GitHub 頁面或網際網路論壇。

節點不可見或不是 page.click() 的 HTMLElement

如果節點不可見或不是 page.click() 的 HTMLElement，首先驗證您正在使用的 xpath，以按一下元素。另外，如果元素位於屏幕底部，請調整檢視區。CloudWatch Synthetics 預設使用的檢視區是 1920 * 1080。您可以在啟動瀏覽器或使用 Puppeteer 函數 page.setViewport 時，設定不同的檢視區。

無法上傳成品到 S3，例外狀況：無法擷取 S3 儲存貯體位置：拒絕存取

如果您的 Canary 因 Simple Storage Service (Amazon S3) 錯誤而失效，則 CloudWatch Synthetics 會因為許可問題而無法上傳為 Canary 建立的螢幕擷取畫面、日誌或報告。請檢查以下內容：

如果 Canary 執行視覺監控，請參閱 使用視覺監控時更新成品位置和加密 以了解詳細資訊。

錯誤：通訊協定錯位 (Runtime.callFunctionOn)：目標關閉。

如果頁面或瀏覽器關閉後存在某些網路請求，就會出現此錯誤。您可能忘記等待非同步操作。執行您的指令碼後，CloudWatch Synthetics 會關閉瀏覽器。瀏覽器關閉後執行任何非同步操作可能會導致 target closed error。

Canary 失敗。錯誤：沒有資料點 - Canary 顯示逾時錯誤

這意味著您的 Canary 執行超過逾時時間。在 CloudWatch Synthetics 發佈成功百分比 CloudWatch 指標或更新成品 (例如 HAR 檔案、日誌和螢幕擷取畫面) 之前，Canary 執行已停止。如果您的逾時太低，您可以增加它。

預設情況下，Canary 逾時值等於其頻率。您可以手動將逾時值調整為小於或等於 Canary 頻率。如果您的 Canary 頻率很低，則必須增加頻率以增加逾時。當您使用 CloudWatch Synthetics 主控台建立或更新 Canary 時，您可於 Schedule (排程) 之下調整頻率和逾時值。

請確定您的逾時值不短於 15 秒，以允許 Lambda 冷啟動和啟動 canary 儀器所需的時間。

發生此錯誤時，無法在 CloudWatch Synthetics 主控台中檢視 Canary 成品。您可以使用 CloudWatch Logs 來查看 Canary 的日誌。

嘗試存取內部端點

如果您希望 Canary 存取內部網路上的端點，我們建議您將 CloudWatch Synthetics 設定為使用 VPC。如需詳細資訊，請參閱在 VPC 上執行 Canary。

Canary 執行時間版本升級和降級問題

如果您最近將 Canary 從執行時間版本 syn-1.0 升級至最新版本，它可能是跨來源請求共享 (CORS) 問題。如需詳細資訊，請參閱跨來源請求共享 (CORS) 問題。

如果您最近將 Canary 降級到較舊的執行時間版本，請檢查以確定您正在使用的 CloudWatch Synthetics 函數在您降級到較舊的執行時間版本中可用。例如，executeHttpStep 函數可用於執行時間版本 syn-nodejs-2.2 和更新版本。若要檢查函數的可用性，請參閱 撰寫 Canary 指令碼。

跨來源請求共享 (CORS) 問題

在 UI Canary 中，如果某些網絡請求失敗並顯示 403 或 net::ERR_FAILED，請檢查 Canary 是否已啟用作用中追蹤，並使用 Puppeteer 函數 page.setExtraHTTPHeaders 以新增標頭。如果是這樣，失敗的網路請求可能是跨來源請求共享 (CORS) 限制所造成。您可以藉由停用作用中追蹤或移除額外的 HTTP 標頭來確認是否會發生這種情況。

為什麼會出現這種情況？

使用作用中追蹤時，會將額外的標頭新增至所有傳出要求，以追蹤呼叫。透過新增追蹤標頭或使用 Puppeteer 的 page.setExtraHTTPHeaders 會導致 XMLHttpRequest (XHR) 請求的 CORS 檢查。

如果您不想停用作用中追蹤或移除額外的標題，則可以更新 Web 應用程式以允許跨來源存取，或者您可以在您的指令碼中啟動 Chrome 瀏覽器時使用 disable-web-security 旗標。

您可以覆寫 CloudWatch Synthetics 使用的啟動參數，並使用 CloudWatch Synthetics 啟動函數傳遞其他 disable-web-security 旗標參數。如需詳細資訊，請參閱使用 Puppeteer 的 Node.js Canary 指令碼可用的程式庫函數。

Canary 競爭條件問題

為了在使用 CloudWatch Synthetics 時獲得最佳體驗，請確保為 Canary 編寫的程式碼是等冪的。否則，在極少數情況下，當 Canary 跨不同執行與相同資源互動時，Canary 執行可能會遇到競爭條件。

對 VPC 上的 Canary 進行故障診斷

如果您在建立或更新 VPC 上的 Canary 後發生問題，下列其中一個章節可能可以協助您對問題進行故障診斷。

處於錯誤狀態的新 Canary 或 Canary 無法更新

如果您建立要在 VPC 上執行的 Canary，而且它立即進入錯誤狀態，或您無法更新要在 VPC 上執行的 Canary，Canary 的角色可能不具備適當的許可。若要在 VPC 上執行，Canary 必須具有 ec2:CreateNetworkInterface、ec2:DescribeNetworkInterfaces 和 ec2:DeleteNetworkInterface 許可。這些許可都包含在 AWSLambdaVPCAccessExecutionRole 受管政策中。如需詳細資訊，請參閱執行角色和使用者許可。

如果此問題是在您建立 Canary 時發生，您必須刪除 Canary，然後建立新的 Canary。如果您使用 CloudWatch 主控台建立新的 Canary，請在 Access Permissions (存取許可)，選取 Create a new role (建立新角色)。系統會建立包含執行 Canary 所需之所有許可的新角色。

如果此問題是在您更新 Canary 時發生，您可以再次更新 Canary，並提供具備必要許可的新角色。

「No test result returned」(未傳回測試結果) 錯誤

如果 Canary 顯示「no test result returned」(未傳回測試結果) 錯誤，則原因可能是下列其中一個問題：

為協助您對這些問題進行故障診斷，請參閱 Canary 的日誌。

對自動重試 Canary 進行故障診斷

若要了解 Canary 失敗的原因或分析特定失敗的嘗試，請遵循這些故障診斷步驟。