翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Textract モニタリング
CloudWatch を使用すると、アカウントの個々の Amazon Textract オペレーションまたはグローバルなAmazon Textract メトリクスのメトリクスを取得できます。メトリクスを使用すると、Amazon TextTract ベースのソリューションの状態をトラッキングし、定義されているしきい値を 1 つ以上のメトリクスが超えた場合に通知するようにアラームをセットアップできます。たとえば、サーバーエラーの発生数のメトリクスを確認することができます。特定の 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/)。
## Amazon Textract での CloudWatch メトリクスの使用
メトリクスを使用するには、以下の情報を指定する必要があります。
+ メトリクスディメンション、またはディメンションなし。*ディメンション*は、メトリクスを一意に識別するための名前と値のペアです。Amazon Textract にはディメンションが 1 つあり、*オペレーション*。オペレーション別のメトリクスを提供します。ディメンションを指定しないと、アカウント内のすべての Amazon Textract オペレーションがメトリクスの対象範囲になります。
+ メトリクス名 (`UserErrorCount` など)。
Amazon Textract のモニタリングデータは、AWS マネジメントコンソールとすると、AWS CLI、CloudWatch API。CloudWatch API は、いずれかの Amazon AWS Software Development Kit (SDK) または CloudWatch API ツールでも使用できます。コンソールには、CloudWatch API の raw データに基づいて一連のグラフが表示されます。必要に応じて、コンソールに表示されるグラフまたは API から取得したグラフを使用できます。
###
以下のリストは、メトリクスの一般的な利用方法をいくつか示しています。ここで紹介するのは開始するための提案事項です。すべてを網羅しているわけではありません。
| 目的 | 関連するメトリクス |
| --- | --- |
| アプリケーションが 1 秒あたりの最大リクエスト数に達したかどうかを確認する | `ThrottledCount` メトリクスの `Sum` 統計をモニタリングします。 |
| リクエストエラーをモニタリングする | `UserErrorCount` メトリクスの `Sum` 統計を使用します。 |
| リクエストの総数を確認する | `ResponseTime` メトリクスの `SampleCount` 統計を使用します。これには、エラーになったリクエストも含まれます。オペレーションの呼び出しが成功した回数のみを確認する場合は、`SuccessfulRequestCount` メトリクスを使用します。 |
| Amazon Textract オペレーションの呼び出しのレイテンシーをモニタリングするにはどうすればよういですか。 | `ResponseTime` メトリクスを使用します。 |
CloudWatch で Amazon Textract をモニタリングするには、適切な CloudWatch アクセス許可が必要です。詳細については、「[Amazon CloudWatch に対する認証とアクセスコントロール](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)」を参照してください。
## Amazon Textract メトリクスへのアクセス
以下の例では、CloudWatch コンソールを使用して Amazon Textract メトリクスにアクセスする方法を示しています。AWS CLI、CloudWatch API。
**メトリクスを表示するには (コンソール)**
1. CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/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/)」を参照してください。
## アラームの作成
アラームの状態が変わったときに Amazon Simple Notification Service (Amazon SNS) メッセージを送信する CloudWatch のアラームを作成することができます。指定した期間中、1 つのアラームが 1 つのメトリクスを監視します。このアラームは、複数の期間にわたる一定のしきい値とメトリクスの値の関係性に基づき、1 つ以上のアクションを実行します。アクションは、Amazon SNS のトピックまたは Auto Scaling のポリシーに送信される通知です。
アラームは、持続している状態変化に対してのみアクションを呼び出します。CloudWatch アラームは、特定の状態にあるというだけの理由ではアクションを呼び出しません。状態が変わって、変わった状態が指定期間にわたって維持される必要があります。
**アラームを設定するには (コンソール)**
1. AWS マネジメントコンソール にサインインして、CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。
1. ナビゲーションペインで、[**アラーム**] を選択し、[**アラームの作成**] を選択します。これにより、[**アラームウィザードの作成**] が起動します。
1. [**メトリクスの選択**] を選択します。
1. 左**すべてのメトリクス**[] タブで、[**Textract**。
1. 選択**オペレーション別**をクリックし、メトリクスを選びます。
たとえば、[] を選択します。**StartDocumentAnalysis**をクリックし、ドキュメントの非同期分析オペレーションの最大数のアラームを設定します。
1. [**グラフ化したメトリクス**] タブを選択します。
1. [**統計**] で、[**合計**] を選択します。
1. [**メトリクスの選択**] を選択します。
1. [**名前**] と [**説明**] を入力します。[**次の時**] で、[**>=**] を選択し、任意の最大値を入力します。
1. アラーム状態に達したときに CloudWatch から E メールを受け取るには、**このアラームはいつでも次のようになります。**で、**状態はALARM**。既存の Amazon SNS トピックにアラームを送信するには、[**通知の送信先:**] で既存の SNS トピックを選択します。新しいメールサブスクリプションリスト用の名前とメールアドレスを設定するには、[**新しいリスト**] を選択します。CloudWatch はリストを保存してフィールドに表示されるため、以降のアラーム設定に利用できます。
**注記**
[**新しいリスト**] を使用して新しい Amazon SNS トピックを作成する場合は、宛先に通知を送信する前にメールアドレスを検証する必要があります。Amazon SNS は、アラームがアラーム状態になったときにのみメールを送信します。アラーム状態になったときに E メールアドレスの検証がまだ完了していない場合、宛先には通知が届きません。
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
```
次の例では、へのコールに対して 10 回を超えるユーザエラーが 5 分以内に発生した場合のアラームの作成方法を示しています。`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/)*」を参照してください。