Amazon CloudWatch による Rekognition のモニタリング - Amazon Rekognition
Rekognition での CloudWatch メトリクスの使用です。Rekognition メトリクスにアクセスします。アラームの作成Rekognition の CloudWatch メトリクスです。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon CloudWatch による Rekognition のモニタリング

CloudWatch を使用すると、個々の Rekognition オペレーションのメトリクス、またはアカウントのグローバルRekognition メトリクスを取得できます。メトリクスを使用して、Rekognition ベースのソリューションの健全性を追跡し、1つまたは複数のメトリクスが定義したしきい値を下回った場合に通知するアラームを設定することができます。メトリクスでは、サーバーエラーの発生数や顔の削除数などを確認できます。特定の Rekognition オペレーションが成功した回数のメトリクスを確認することもできます。メトリクスを表示するには、Amazon CloudWatch、アマゾン AWS Command Line Interface、または CloudWatch API を使用することができます。

また、Rekognition コンソールを使用して、選択した期間の集計メトリクスを表示することもできます。詳細については、「演習 4: 集計メトリクスを参照する (コンソール)」を参照してください。

Rekognition での CloudWatch メトリクスの使用です。

メトリクスを使用するには、以下の情報を指定する必要があります。

  • メトリクスのディメンション、またはディメンションなし。ディメンションは、メトリクスを一意に識別するための名前と値のペアです。Rekognition は Operation という 1 つのディメンションを持っています。オペレーション別のメトリクスを提供します。ディメンションを指定しないと、アカウント内のすべての Rekognition オペレーションがメトリクスの対象範囲になります。

  • メトリクス名 (UserErrorCount など)。

AWS Management Console、AWS CLI、または CloudWatch API を使用して Rekognition のモニタリングデータを取得することができます。また、Amazon AWS Software Development Kits (SDK) の 1 つまたは CloudWatch API ツールを使用して CloudWatch API を使用することができます。コンソールには、CloudWatch API の raw データに基づいて一連のグラフが表示されます。必要に応じて、コンソールに表示されるグラフまたは API から取得したグラフを使用できます。

以下のリストは、メトリクスの一般的な利用方法をいくつか示しています。ここで紹介するのは開始するための提案事項です。すべてを網羅しているわけではありません。

目的 関連するメトリクス

認識された顔の数を追跡する

DetectedFaceCount メトリクスの Sum 統計をモニタリングします。

アプリケーションが 1 秒あたりの最大リクエスト数に達したかどうかを確認する

ThrottledCount メトリクスの Sum 統計をモニタリングします。

リクエストエラーをモニタリングする

UserErrorCount メトリクスの Sum 統計を使用します。

リクエストの総数を確認する

ResponseTime と、ResponseTime メトリクスの Data Samples 統計を使用します。これには、エラーになったリクエストも含まれます。オペレーションの呼び出しが成功した回数のみを確認する場合は、SuccessfulRequestCount メトリクスを使用します。

Rekognition オペレーションの呼び出しのレイテンシーをモニタリングする

ResponseTime メトリクスを使用します。

IndexFaces が Rekognition コレクションに顔を何回正常に追加したかをモニタリングするにはどうすればよいですか？

SuccessfulRequestCount メトリクスの Sum 統計と IndexFaces オペレーションをモニタリングします。オペレーションとメトリクスを選択するには、Operation ディメンションを使用します。

CloudWatch で Rekognition をモニタリングするには、適切な CloudWatch のアクセス許可が必要です。詳細については、「Amazon CloudWatch に対する認証とアクセスコントロール」を参照してください。

Rekognition メトリクスにアクセスします。

以下の例では、CloudWatch コンソール、AWS CLI、CloudWatch APIを使用して、Rekognition メトリクスにアクセスする方法を示します。

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

  1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

  2. [メトリクス] を選択し、[すべてのメトリクス] タブを選択して、[Rekognition] を選択します。

  3. [範囲の定められていないメトリクス] を選択し、メトリクスを選択します。

    たとえば、顔の検出数を確認するには、[DetectedFace] メトリクスを選びます。

  4. 日付範囲の値を選択します。メトリクスのカウントがグラフに表示されます。

一定期間に DetectFaces オペレーションの呼び出しが成功した回数をメトリクスで確認するには (CLI)

  • AWS CLI を開き、以下のコマンドを入力します。

    aws cloudwatch get-metric-statistics --metric-name SuccessfulRequestCount --start-time 2017-1-1T19:46:20 --end-time 2017-1-6T19:46:57 --period 3600 --namespace AWS/Rekognition --statistics Sum --dimensions Name=Operation,Value=DetectFaces --region us-west-2

    この例では、一定期間に DetectFaces オペレーションの呼び出しが成功した回数を示しています。詳細については、「get-metric-statistics」を参照してください。

メトリクスにアクセスするには (CloudWatch API)

アラームの作成

アラームの状態が変化したときに Amazon Simple Notification Service (Amazon SNS) メッセージを送信する CloudWatch のアラームを作成することができます。アラームは、指定期間にわたって単一のメトリクスを監視し、指定したしきい値に対応したメトリクスの値に基づいて、期間数にわたって 1 つ以上のアクションを実行します。アクションは、Amazon SNS トピックまたは Auto Scaling ポリシーに送信される通知です。

アラームは、持続している状態変化に対してのみアクションを呼び出します。CloudWatch アラームは、特定の状態にあるという理由だけではアクションを呼び出しません。状態が変って、変わった状態が指定期間にわたって維持される必要があります。

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

  1. AWS Management Console にサインインして、CloudWatch コンソール https://console.aws.amazon.com/cloudwatch/ を開きます。

  2. [Create Alarm] を選択します。これにより、[Create Alarm Wizard] が起動します。

  3. [範囲の定められていないメトリクス] メトリクスリストで、[Rekognition メトリクス] を選択し、メトリクスを選択します。

    たとえば、顔の最大検出数のアラームを設定するには、[DetectedFaceCount] を選びます。

  4. [時間範囲] 領域で、顔の検出オペレーションを呼び出す期間の値を選択します。[次へ] を選択します。

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

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

    注記

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

  7. [Alarm Preview] (アラームの確認) セクションでアラームをプレビューします。[Create Alarm] (アラームの作成) を選択します。

アラームを設定するには (AWS CLI)

  • AWS CLI を開き、以下のコマンドを入力します。alarm-actions パラメータの値を変更して、作成済みの Amazon SNS トピックを参照します。

    aws cloudwatch put-metric-alarm --alarm-name UserErrors --alarm-description "Alarm when more than 10 user errors occur" --metric-name UserErrorCount --namespace AWS/Rekognition --statistic Average --period 300 --threshold 10 --comparison-operator GreaterThanThreshold --evaluation-periods 2 --alarm-actions arn:aws:sns:us-west-2:111111111111:UserError --unit Count

    この例では、5 分以内にユーザーエラーが 10 回を超えた場合のアラームの作成方法を示しています。詳細については、「put-metric-alarm」を参照してください。

アラームを設定するには (CloudWatch API)

Rekognition の CloudWatch メトリクスです。

このセクションでは、Amazon Rekognition で利用可能な Amazon CloudWatch メトリクスと Operation ディメンションに関する情報を提供します。

Rekognition コンソールから Rekognition の集計メトリクスを確認することもできます。詳細については、「演習 4: 集計メトリクスを参照する (コンソール)」を参照してください。

Rekognition の CloudWatch メトリクスです。

次の表は、Rekognition メトリクスをまとめたものです。

メトリクス 説明

SuccessfulRequestCount

成功したリクエストの数。成功したリクエストのレスポンスコード範囲は 200〜299 です。

単位: 個

有効な統計: Sum,Average

ThrottledCount

スロットルされたリクエストの数。Rekognitionは、アカウントに設定された 1 秒あたりのトランザクションの制限を超えるリクエストを受信すると、リクエストをスロットルします。アカウントに設定された制限を頻繁に超える場合は、制限の引き上げをリクエストできます。引き上げをリクエストするには、「AWS サービス制限」を参照してください。

単位: 個

有効な統計: Sum,Average

ResponseTime

Rekognition がレスポンスを計算するための時間 (ミリ秒)。

単位:

  1. Data Samples 統計のカウント

  2. Average 統計のミリ秒

有効な統計: Data Samples,Average

注記

ResponseTime メトリクスは Rekognition メトリクスペインに含まれていません。

DetectedFaceCount

IndexFaces または DetectFaces オペレーションで検出された顔の数。

単位: 個

有効な統計: Sum,Average

DetectedLabelCount

DetectLabels オペレーションで検出されたラベルの数。

単位: 個

有効な統計: Sum,Average

ServerErrorCount

サーバーエラーの数。サーバーエラーのレスポンスコード範囲は 500〜599 です。

単位: 個

有効な統計: Sum, Average

UserErrorCount

ユーザーエラーの数 (無効なパラメータ、無効なイメージ、アクセス権限なしなど)。ユーザーエラーのレスポンスコード範囲は 400〜499 です。

単位: 個

有効な統計: Sum,Average
MinInferenceUnits StartProjectVersion リクエスト中に指定された推論単位の最小数

単位: 個

有効な統計: Average
MaxInferenceUnits StartProjectVersion リクエスト中に指定された推論単位の最大数

単位: 個

有効な統計: Average

DesiredInferenceUnits

Rekognition がスケールアップまたはスケールダウンする推論単位の数

単位: 個

有効な統計: Average

InServiceInferenceUnits

モデルで使用されている推論単位の数

単位: 個

有効な統計: Average

平均統計を使用して、使用されたインスタンス数の 1 分間の平均値を取得することをお勧めします。

Rekognition ストリーミングの CloudWatch メトリクス

また、Rekognition には、ストリーミングオペレーション「Rekognition ストリーミング」に使用される 2 つ目の名前空間があります。次の表は、Rekognition ストリーミングのメトリクスをまとめたものです。

メトリクス 説明

SuccessfulRequestCount

成功したリクエストの数。成功したリクエストのレスポンスコード範囲は 200〜299 です。

単位: 個

有効な統計: Sum,Average
CallCount

アカウントで実行された指定されたオペレーションの数。

有効な統計: Sum,Average

ThrottledCount

スロットルされたリクエストの数。Rekognitionは、アカウントに設定された 1 秒あたりのトランザクションの制限を超えるリクエストを受信すると、リクエストをスロットルします。アカウントに設定された制限を頻繁に超える場合は、制限の引き上げをリクエストできます。引き上げをリクエストするには、「AWS サービス制限」を参照してください。

単位: 個

有効な統計: Sum,Average

ServerErrorCount

サーバーエラーの数。サーバーエラーのレスポンスコード範囲は 500〜599 です。

単位: 個

有効な統計: Sum, Average

UserErrorCount

ユーザーエラーの数 (無効なパラメータ、無効なイメージ、アクセス権限なしなど)。ユーザーエラーのレスポンスコード範囲は 400〜499 です。

単位: 個

有効な統計: Sum,Average

Rekognition の CloudWatch ディメンション

オペレーション別のメトリクスを取得するには、Rekognition 名前空間を使用して、オペレーションディメンションを指定します。

ディメンションの詳細については、「Amazon CloudWatch ユーザーガイド」の「ディメンション」を参照してください。

Rekognition Custom Labels の CloudWatch ディメンション

次の表は、Rekognition Custom Labels で使用できる CloudWatch ディメンションを示しています。

ディメンション 説明
ProjectName CreateProject で作成した Rekognition Custom Labels プロジェクトの名前
VersionName CreateProjectVersion で作成した Rekognition Custom Labels プロジェクトバージョンの名前

ディメンションの詳細については、「Amazon CloudWatch ユーザーガイド」の「ディメンション」を参照してください。