本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 監控 Amazon Textract
您可以透過 CloudWatch，為您的帳户取得個別 Amazon Textract 操作的指標或全域 Amazon Textract 指標。您可以使用這些指標來追蹤 Amazon Textart 解決方案的運作狀態，並設定警示，在一或多個指標落在定義閾值以外時通知您。例如，您可以查看發生的伺服器錯誤次數指標。您也可以查看特定 Amazon Textract 操作的成功次數指標。若要查看指標，您可以使用[Amazon CloudWatch](https://console.aws.amazon.com/cloudwatch/)，[AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/)，或[CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)。
## 使用 CloudWatch 指 Amazon Textract
要使用指標，您必須指定下列資訊：
+ 指標維度或者無維度。*維度*是一組用來單獨辨識指標的名稱值組。Amazon Textract 有一個維度，稱為*操作*。它提供特定操作的指標。如果您未指定維度，指標範圍將適用於帳號內的所有 Amazon Textract 操作。
+ 指標名稱，例如 `UserErrorCount`。
您可以 Amazon Textract 用AWS 管理主控台，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 身分驗證與存取控制](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)。
## 存取 Amazon Textract 標
以下範例展示如何使用 CloudWatch 主控台、AWS CLI和 CloudWatch API。
**檢視指標 (主控台)**
1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch) 開啟 CloudWatch 主控台。
1. 選擇**指標**中，選擇**所有指標**選項卡，然後選擇**Amazon Textract**。
1. 選擇**按操作**，然後選擇一個指標。
例如，您可以選擇**StartDocumentAnalysis**度量來衡量已啟動異步文檔分析的次數。
1. 選擇日期範圍的值。指標計數顯示於圖形中。
**若要成功查看指標`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](https://docs.aws.amazon.com/cli/latest/reference/get-metric-statistics.html)。
**若要存取指標 (CloudWatch API)**
+ 呼叫 `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`。如需詳細資訊，請參閲 。[Amazon CloudWatch API 參考](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)。
## 建立警示
您可以建立 CloudWatch 警示，在警示變更狀態時傳送 Simple Notification Service (Amazon SNS) 訊息。警示會在您指定的期間監看單一指標。警示會根據在數個期間與指定閾值相關的指標值，來執行一個或多個動作。此動作是傳送到 Amazon SNS 主題或 Auto Scaling 政策的通知。
警示僅會針對持續狀態變更呼叫動作。CloudWatch 警示不會僅因為它們處於特定狀態而叫用動作。狀態必須發生變更並維持一段指定的時間。
**若要設定警示 (主控台)**
1. 登入 AWS 管理主控台 並開啟位於 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 的 CloudWatch 主控台。
1. 在導覽窗格中，選擇**警報**，然後選擇**建立警示**。此操作可開啟**建立警示精靈**。
1. 選擇 **Select metric** (選取指標)。
1. 在 中**所有指標**選項卡上選擇**Textract**。
1. 選擇**按操作**，然後選擇一個指標。
例如，您可以選擇**StartDocumentAnalysis**可設定異步文件分析操作的最高次數警示。
1. 選擇 **Graphed metrics (圖表化指標)** 標籤。
1. 在 **Statistic (統計資料)** 中選擇 **Sum (總和)**。
1. 選擇 **Select metric** (選取指標)。
1. 填入 **Name** (名稱) 和 **Description** (說明)。對於 **Whenever** (每當) 選項，請選擇 **>=** 並輸入您所選擇的最大值。
1. 如果您希望 CloudWatch 在達到警示狀態時傳送電子郵件給您，請在**每當此警報時：**，選擇**狀態為警報**。要向現有的 Amazon SNS 主題發送警報，對於**發送通知至：**下，選擇現有 SNS 主題。若要設定新的電子郵件訂清單的名稱與電子郵件地址，請選擇**新列表**。CloudWatch 會儲存清單並顯示於欄位中，可提供未來設定警示時使用。
**注意**
如果您使用**新列表**若要建立新的 Amazon SNS 主題，電子郵件地址必須先經過驗證，目標收件人才可接收通知。Amazon SNS 只會在警示進入警示狀態時才會傳送電子郵件。如果此警示狀態在驗證電子郵件地址之前發生變更，目標收件人就不會收到通知。
1. 選擇 **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](https://docs.aws.amazon.com/cli/latest/reference/put-metric-alarm.html)。
**若要設定警示 (CloudWatch API)**
+ 呼叫 `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`。如需詳細資訊，請參閱「」*[Amazon CloudWatch API 參考](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*。