監控 Amazon Textract

您可以透過 CloudWatch，為您的帳户取得個別 Amazon Textract 操作的指標或全域 Amazon Textract 指標。您可以使用這些指標來追蹤 Amazon Textart 解決方案的運作狀態，並設定警示，在一或多個指標落在定義閾值以外時通知您。例如，您可以查看發生的伺服器錯誤次數指標。您也可以查看特定 Amazon Textract 操作的成功次數指標。若要查看指標，您可以使用Amazon CloudWatch，AWS CLI，或CloudWatch API。

使用 CloudWatch 指 Amazon Textract

要使用指標，您必須指定下列資訊：

• 指標維度或者無維度。維度是一組用來單獨辨識指標的名稱值組。Amazon Textract 有一個維度，稱為操作。它提供特定操作的指標。如果您未指定維度，指標範圍將適用於帳號內的所有 Amazon Textract 操作。

• 指標名稱，例如 UserErrorCount。

您可以 Amazon Textract 用AWS Management Console，AWS CLI或 CloudWatch API。您也可以透過其中一個 Amazon AWS 軟體開發套件 (SDK) 或 CloudWatch API 工具來使用 CloudWatch API。主控台會根據 CloudWatch API 的原始資料顯示一系列圖形。根據需求，您可能偏好使用顯示於主控台中的圖形或自 API 擷取的圖形。

下列清單顯示一些常見的指標用途。這些是協助您開始的建議，而不是完整清單。

我要如何？	相關指標
我要如何得知我的應用程式已達每秒最高請求數量？	監控 ThrottledCount 指標的 Sum 數據。
我要如何監控請求錯誤？	使用 UserErrorCount 指標的 Sum 統計資料。
我要如何找到請求總數？	使用 ResponseTime 指標的 SampleCount 統計資料。其中包括任何產生錯誤的請求。如果您只想要查看成功操作呼叫，請使用 SuccessfulRequestCount 指標。
如何監控 Amazon Textract 操作呼叫的延遲？	使用 ResponseTime 指標。

您必須擁有適當的 CloudWatch 許可才可使用 CloudWatch 來監控 Amazon Textract。如需詳細資訊，請參閱 Amazon CloudWatch 身分驗證與存取控制。

存取 Amazon Textract 標

以下範例展示如何使用 CloudWatch 主控台、AWS CLI和 CloudWatch API。

檢視指標 (主控台)

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

2. 選擇指標中，選擇所有指標選項卡，然後選擇Amazon Textract。

3. 選擇按操作，然後選擇一個指標。

   例如，您可以選擇StartDocumentAnalysis度量來衡量已啟動異步文檔分析的次數。

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

若要成功查看指標StartDocumentAnalysis在一段時間內發出的操作呼叫 (CLI)

• 開啟 AWS CLI，然後輸入下列命令：

  aws cloudwatch get-metric-statistics \
      --metric-name SuccessfulRequestCount \
      --start-time 2019-02-01T00:00:00Z \
      --period 3600 \
      --end-time 2019-03-01T00:00:00Z \
      --namespace AWS/Textract \
      --dimensions Name=Operation,Value=StartDocumentAnalysis \
      --statistics Sum

  此範例顯示在一段時間內執行的成功 StartDocumentAnalysis 操作呼叫。如需詳細資訊，請參閱 get-metric-statistics。

若要存取指標 (CloudWatch API)

• 呼叫 GetMetricStatistics。如需詳細資訊，請參閲 。Amazon CloudWatch API 參考。

建立警示

您可以建立 CloudWatch 警示，在警示變更狀態時傳送 Simple Notification Service (Amazon SNS) 訊息。警示會在您指定的期間監看單一指標。警示會根據在數個期間與指定閾值相關的指標值，來執行一個或多個動作。此動作是傳送到 Amazon SNS 主題或 Auto Scaling 政策的通知。

警示僅會針對持續狀態變更呼叫動作。CloudWatch 警示不會僅因為它們處於特定狀態而叫用動作。狀態必須發生變更並維持一段指定的時間。

若要設定警示 (主控台)

1. 登入 AWS Management Console 並開啟位於 https://console.aws.amazon.com/cloudwatch/ 的 CloudWatch 主控台。

2. 在導覽窗格中，選擇警報，然後選擇建立警示。此操作可開啟建立警示精靈。

3. 選擇 Select metric (選取指標)。

4. 在 中所有指標選項卡上選擇Textract。

5. 選擇按操作，然後選擇一個指標。

   例如，您可以選擇StartDocumentAnalysis可設定異步文件分析操作的最高次數警示。

6. 選擇 Graphed metrics (圖表化指標) 標籤。

7. 在 Statistic (統計資料) 中選擇 Sum (總和)。

8. 選擇 Select metric (選取指標)。

9. 填入 Name (名稱) 和 Description (說明)。對於 Whenever (每當) 選項，請選擇 >= 並輸入您所選擇的最大值。

10. 如果您希望 CloudWatch 在達到警示狀態時傳送電子郵件給您，請在每當此警報時：，選擇狀態為警報。要向現有的 Amazon SNS 主題發送警報，對於發送通知至：下，選擇現有 SNS 主題。若要設定新的電子郵件訂清單的名稱與電子郵件地址，請選擇新列表。CloudWatch 會儲存清單並顯示於欄位中，可提供未來設定警示時使用。

    注意

    如果您使用新列表若要建立新的 Amazon SNS 主題，電子郵件地址必須先經過驗證，目標收件人才可接收通知。Amazon SNS 只會在警示進入警示狀態時才會傳送電子郵件。如果此警示狀態在驗證電子郵件地址之前發生變更，目標收件人就不會收到通知。

11. 選擇 Create Alarm (建立警示)。

設定警示 (AWS CLI)

• 開啟 AWS CLI，然後輸入下列命令。變更的值alarm-actions參數，以連結您之前建立的 Amazon SNS 主題。

  aws cloudwatch put-metric-alarm \
      --alarm-name StartDocumentAnalysisUserErrors \
      --alarm-description "Alarm when more than 10 StartDocumentAnalysys user errors occur within 5 minutes" \
      --metric-name UserErrorCount \
      --namespace AWS/Textract \
      --statistic Sum \
      --period 300 \
      --threshold 10 \
      --comparison-operator GreaterThanThreshold \
      --evaluation-periods 1 \
      --unit Count \
      --dimensions Name=Operation,Value=StartDocumentAnalysis \
      --alarm-actions arn:aws:sns:us-east-1:111111111111:alarmtopic 

  此範例説明如何為呼叫在 5 分鐘內發生 10 次以上的用户錯誤時通知StartDocumentAnalysis。如需詳細資訊，請參閱 put-metric-alarm。

若要設定警示 (CloudWatch API)

• 呼叫 PutMetricAlarm。如需詳細資訊，請參閱「」Amazon CloudWatch API 參考。