使用 Amazon CloudWatch 監控 Amazon Lex - Amazon Lex V1

支援終止通知:2025 年 9 月 15 日, AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後,您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2,請改參閱 Amazon Lex V2 指南

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

使用 Amazon CloudWatch 監控 Amazon Lex

若要追蹤 Amazon Lex 機器人的運作狀態,請使用 Amazon CloudWatch。使用 CloudWatch,您可以取得個別 Amazon Lex 操作或 帳戶全域 Amazon Lex 操作的指標。您也可以設定 CloudWatch 警示,以便在一或多個指標超過您定義的閾值時收到通知。例如,您可以監控在特定期間內對機器人提出的請求數量、檢視成功請求的延遲,或在錯誤超過閾值時發出警示。

Amazon Lex 的 CloudWatch 指標

若要取得 Amazon Lex 操作 的指標,您必須指定下列資訊:

  • 指標維度。維度是一組用來識別指標的名稱與數值對。Amazon Lex 有三個維度:

    • BotAlias, BotName, Operation

    • BotAlias, BotName, InputMode, Operation

    • BotName, BotVersion, InputMode, Operation

  • 指標名稱,例如 MissedUtteranceCountRuntimeRequestCount

您可以使用 AWS 管理主控台、 AWS CLI或 CloudWatch API 取得 Amazon Lex 的指標。您可以透過其中一個 Amazon AWS 軟體開發套件 (SDKs) 或 CloudWatch API 工具來使用 CloudWatch API。Amazon Lex 主控台會根據 CloudWatch API 的原始資料顯示圖形。

您必須擁有適當的 CloudWatch 許可,才能使用 CloudWatch 監控 Amazon Lex。如需詳細資訊,請參閱《Amazon CloudWatch 使用者指南》中的 Amazon CloudWatch 的身分驗證和存取控制Amazon CloudWatch

檢視 Amazon Lex 指標

使用 Amazon Lex 主控台或 CloudWatch 主控台檢視 Amazon Lex 指標。

檢視指標 (Amazon Lex 主控台)
  1. 登入 AWS 管理主控台 ,並在 https://console.aws.amazon.com/lex/:// 開啟 Amazon Lex 主控台。

  2. 從機器人清單選擇您要查看指標的機器人。

  3. 選擇 Monitoring (監控)。指標會顯示在圖形中。

若要檢視指標 (CloudWatch 主控台)
  1. 登入 AWS 管理主控台 並開啟位於 https://https://console.aws.amazon.com/cloudwatch/ 的 CloudWatch 主控台。

  2. 選擇指標,選擇所有指標,然後選擇 AWS/Lex

  3. 選擇維度、選擇指標名稱,再選擇 Add to graph (新增至圖形)

  4. 選擇日期範圍的值。所選日期範圍的指標計數會顯示在圖形中。

建立警示

CloudWatch 警示會監看指定期間內的單一指標,並執行一或多個動作:傳送通知至 Amazon Simple Notification Service (Amazon SNS) 主題或 Auto Scaling 政策。動作是根據指標在您指定的數個期間內相對於指定閾值的值。當警示變更狀態時,CloudWatch 也可以傳送 Amazon SNS 訊息給您。

CloudWatch 警示只有在狀態變更且在您指定的期間持續存在時,才會叫用動作。

設定警示
  1. 登入 AWS 管理主控台 ,並在 https://https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

  2. 選擇 Alarms (警示),然後選擇 Create Alarm (建立警示)。

  3. 選擇 AWS/Lex Metrics指標,然後選擇一個指標。

  4. 對於 Time Range (時間範圍),選擇要監控的時間範圍,然後選擇 Next (下一步)

  5. 輸入 Name (名稱)Description (描述)

  6. 對於 Whenever (每當),選擇 >= 並輸入最大值。

  7. 如果您希望 CloudWatch 在達到警示狀態時傳送電子郵件,請在動作區段中,針對每當此警示,選擇狀態為 ALARM。對於 Send notification to (傳送通知至),選擇郵件清單或選擇 New list (新清單) 並建立新的郵件清單。

  8. Alarm Preview (警示預覽) 區段中預覽警示。如果警示符合您的要求,選擇 Create Alarm (建立警示)

Amazon Lex 執行期的 CloudWatch 指標

下表說明 Amazon Lex 執行時間指標。

指標 說明
KendraIndexAccessError

Amazon Lex 無法存取 Amazon Kendra 索引的次數。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

單位:計數

KendraLatency

Amazon Kendra 回應來自 的請求所需的時間量AMAZON.KendraSearchIntent

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

單位:毫秒

KendraSuccess

AMAZON.KendraSearchIntent到 Amazon Kendra 索引的成功請求數量。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

單位:計數

KendraSystemErrors

Amazon Lex 無法查詢 Amazon Kendra 索引的次數。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

單位:計數

KendraThrottledEvents

Amazon Kendra 調節來自 請求的次數AMAZON.KendraSearchIntent

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

單位:計數

MissedUtteranceCount

指定期間內無法辨識的表達用語數量。

使用 Text Speech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

RuntimeConcurrency

指定期間內並行連線的數量。 RuntimeConcurrency 會以 報告StatisticSet

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • 操作、BotName、BotVersion、InputMode

  • 操作、BotName、BotAlias、InputMode

其他操作的有效維度:

  • 操作、BotName、BotVersion

  • 操作、BotName、BotAlias

單位:計數

RuntimeInvalidLambdaResponses

指定期間內的 invalid AWS Lambda (Lambda) 回應數目。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

RuntimeLambdaErrors

指定期間內的 Lambda 執行時間錯誤數目。

使用 Text Speech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

RuntimePollyErrors

指定期間內無效的 Amazon Polly 回應數目。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

RuntimeRequestCount

指定期間內的執行時間請求數量。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

單位:計數

RuntimeSucessfulRequestLatency
重要

此指標是 RuntimeSucessfulRequestLatency,而不是 RuntimeSuccessfulRequestLatency

提出請求與傳回回應期間的成功請求延遲。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotVersion, Operation, InputMode

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotVersion, Operation

  • BotName, BotAlias, Operation

單位:毫秒

RuntimeSystemErrors

指定期間內的系統錯誤數量。系統錯誤的回應碼範圍是 500 到 599。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

單位:計數

RuntimeThrottledEvents

已調節的請求數目。Amazon Lex 會在收到超過您帳戶每秒交易限制的請求時調節請求。如果經常超過為您的帳戶所設的限制,您可以請求提高上限。若要請求提高,請參閱 AWS 服務限制

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName、BotAlias、Operation、InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

單位:計數

RuntimeUserErrors

指定期間內的使用者錯誤數量。使用者錯誤的回應碼範圍是 400 到 499。

使用 TextSpeech InputMode 進行 PostContent 操作的有效維度:

  • BotName, BotAlias, Operation, InputMode

PostText 操作的有效維度:

  • BotName, BotAlias, Operation

單位:計數

Amazon Lex 執行期指標使用 AWS/Lex 命名空間,並在下列維度中提供指標。您可以在 CloudWatch 主控台中依維度分組指標:

維度 說明
BotName, BotAlias, Operation, InputMode 依照機器人別名、機器人名稱、操作 (PostContent) 及文字或語音輸入,為指標進行分組。
BotName, BotVersion, Operation, InputMode 依照機器人名稱、機器人版本、操作 (PostContent) 及文字或語音輸入,為指標進行分組。
BotName, BotVersion, Operation 依照機器人名稱、機器人版本和操作 (PostText),為指標進行分組。
BotName, BotAlias, Operation 依照機器人名稱、機器人別名和操作 (PostText),為指標進行分組。

Amazon Lex 頻道關聯的 CloudWatch 指標

頻道關聯是 Amazon Lex 與 Facebook 等簡訊頻道之間的關聯。下表說明 Amazon Lex 頻道關聯指標。

指標 說明
BotChannelAuthErrors

簡訊管道在指定期間內傳回的身分驗證錯誤數量。身分驗證錯誤表示在管道建立期間所提供的秘密字符無效或已過期。

BotChannelConfigurationErrors

指定期間內的組態錯誤數量。組態錯誤表示管道有一或多個組態項目無效。

BotChannelInboundThrottledEvents

訊息管道傳送的訊息在指定期間內由 Amazon Lex 調節的次數。

BotChannelOutboundThrottledEvents

從 Amazon Lex 到訊息管道的傳出事件在指定期間內受到限流的次數。

BotChannelRequestCount

指定期間內在管道上提出的請求數量。

BotChannelResponseCardErrors

Amazon Lex 在指定期間內無法張貼回應卡的次數。

BotChannelSystemErrors

在指定期間內,頻道在 Amazon Lex 中發生的內部錯誤數目。

Amazon Lex 頻道關聯指標使用 AWS/Lex 命名空間,並提供下列維度的指標。您可以在 CloudWatch 主控台中依維度分組指標:

維度 說明
BotAlias, BotChannelName, BotName, Source 依照機器人別名、管道名稱、機器人名稱和流量來源,為指標進行分組。

對話日誌的 CloudWatch 指標

Amazon Lex 使用下列指標進行對話記錄:

指標 說明
ConversationLogsAudioDeliverySuccess

在指定時段成功遞送至 S3 儲存貯體的音訊日誌數目。

單位:Count

ConversationLogsAudioDeliveryFailure

在指定時段無法遞送至 S3 儲存貯體的音訊日誌數目。遞送失敗表示針對對話日誌設定的資源發生錯誤。錯誤可能包括 IAM 許可不足、無法存取的 AWS KMS 金鑰或無法存取的 S3 儲存貯體。

單位:Count

ConversationLogsTextDeliverySuccess

在指定期間內成功交付至 CloudWatch Logs 的文字日誌數量。

單位:Count

ConversationLogsTextDeliveryFailure

在指定期間內無法交付至 CloudWatch Logs 的文字日誌數量。遞送失敗表示針對對話日誌設定的資源發生錯誤。錯誤可能包括 IAM 許可不足、無法存取的 AWS KMS 金鑰或無法存取的 CloudWatch Logs 日誌群組。

單位:Count

Amazon Lex 對話日誌指標使用 AWS/Lex 命名空間,並提供下列維度的指標。您可以在 CloudWatch 主控台中依維度分組指標。

維度 說明

BotAlias

依機器人別名將指標分組。

BotName

依機器人名稱將指標分組。

BotVersion

依機器人版本將指標分組。