Amazon Textract のモニタリング

メトリクスを表示するには (コンソール)

1. CloudWatch コンソールの https://console.aws.amazon.com/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 リファレンス」を参照してください。

アラームを設定するには (コンソール)

1. にサインイン AWS マネジメントコンソール し、https://console.aws.amazon.com/cloudwatch/ で CloudWatch コンソールを開きます。

2. ナビゲーションペインで、[アラーム] を選択し、[アラームの作成] を選択します。これにより、[アラームウィザードの作成] が起動します。

3. [メトリクスの選択] を選択します。

4. すべてのメトリクスタブで、Textract を選択します。

5. オペレーション別 を選択し、メトリクスを選択します。

   たとえば、StartDocumentAnalysis を選択して、非同期ドキュメント分析オペレーションの最大数のアラームを設定します。

6. [グラフ化したメトリクス] タブを選択します。

7. [統計] で、[合計] を選択します。

8. [メトリクスの選択] を選択します。

9. [名前] と [説明] を入力します。[次の時] で、[>=] を選択し、任意の最大値を入力します。

10. アラーム状態になったときに CloudWatch からメールを送信させたい場合は、[このアラームが鳴る時:] で、[アラーム状態] を選択します。既存の Amazon SNS トピックにアラームを送信するには、[通知の送信先:] で既存の SNS トピックを選択します。新しいメールサブスクリプションリスト用の名前とメールアドレスを設定するには、[新しいリスト] を選択します。CloudWatch はリストを保存してフィールドに表示されるため、以降のアラーム設定に利用できます。

    注記

    [新しいリスト] を使用して新しい Amazon SNS トピックを作成する場合は、宛先に通知を送信する前にメールアドレスを検証する必要があります。Amazon SNS は、アラームがアラーム状態になったときにのみメールを送信します。アラーム状態になったときに E メールアドレスの検証がまだ完了していない場合、宛先には通知が届きません。

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 リファレンス」を参照してください。