翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon CloudWatch による Rekognition のモニタリング CloudWatch を使用すると、個々の Rekognition オペレーションのメトリクス、またはアカウントのグローバルRekognition メトリクスを取得できます。メトリクスを使用して、Rekognition ベースのソリューションの健全性を追跡し、1つまたは複数のメトリクスが定義したしきい値を下回った場合に通知するアラームを設定することができます。メトリクスでは、サーバーエラーの発生数や顔の削除数などを確認できます。特定の Rekognition オペレーションが成功した回数のメトリクスを確認することもできます。メトリクスを表示するには、[Amazon CloudWatch](https://console.aws.amazon.com/cloudwatch/)、[Amazon AWS Command Line Interface](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/)、または [CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/) を使用できます。 また、Rekognition コンソールを使用して、選択した期間の集計メトリクスを表示することもできます。詳細については、「[演習 4: 集計メトリクスを参照する (コンソール)](aggregated-metrics.md)」を参照してください。 ## Rekognition での CloudWatch メトリクスの使用です。 メトリクスを使用するには、以下の情報を指定する必要があります。 + メトリクスのディメンション、またはディメンションなし。*ディメンション*は、メトリクスを一意に識別するための名前と値のペアです。Rekognition は *Operation* という 1 つのディメンションを持っています。オペレーション別のメトリクスを提供します。ディメンションを指定しないと、アカウント内のすべての Rekognition オペレーションがメトリクスの対象範囲になります。 + メトリクス名 (`UserErrorCount` など)。 AWS マネジメントコンソール、 AWS CLI、または CloudWatch API を使用して Rekognition のモニタリングデータを取得することができます。CloudWatch API は、いずれかの Amazon AWS Software Development Kit (SDK) または 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 に対する認証とアクセスコントロール](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)」を参照してください。 ## Rekognition メトリクスにアクセスします。 次の例は、CloudWatch コンソール、、 AWS CLIおよび CloudWatch API を使用して Rekognition メトリクスにアクセスする方法を示しています。 **メトリクスを表示するには (コンソール)** 1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch) を開いてください。 1. [**メトリクス**] を選択し、[**すべてのメトリクス**] タブを選択して、[**Rekognition**] を選択します。 1. [**範囲の定められていないメトリクス**] を選択し、メトリクスを選択します。 たとえば、顔の検出数を確認するには、[**DetectedFace**] メトリクスを選びます。 1. 日付範囲の値を選択します。メトリクスのカウントがグラフに表示されます。 **一定期間に `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](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 つ以上のアクションを実行します。アクションは、Amazon SNS トピックまたは Auto Scaling ポリシーに送信される通知です。 アラームは持続している状態変化に対してのみアクションを呼び出します。CloudWatch アラームは、特定の状態にあるという理由だけではアクションを呼び出しません。状態が変って、変わった状態が指定期間にわたって維持される必要があります。 **アラームを設定するには (コンソール)** 1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。 1. [**Create Alarm**] を選択します。これにより、[**Create Alarm Wizard**] が起動します。 1. [**範囲の定められていないメトリクス**] メトリクスリストで、[**Rekognition メトリクス**] を選択し、メトリクスを選択します。 たとえば、顔の最大検出数のアラームを設定するには、[**DetectedFaceCount**] を選びます。 1. [**時間範囲**] 領域で、顔の検出オペレーションを呼び出す期間の値を選択します。[**次へ**] を選択します。 1. [**名前**] と [**説明**] を入力します。[**次の時**] で、[**>=**] を選択し、任意の最大値を入力します。 1. アラーム状態になったときに CloudWatch からメールを送信させたい場合は、[**このアラームが鳴る時:**] で、[**アラーム状態**] を選択します。既存の Amazon SNS トピックにアラームを送信するには、[**通知の送信先:**] で既存の SNS トピックを選択します。新しいメールサブスクリプションリストの名前と E メールアドレスを設定するには、[**トピックの作成**] を選択します。このリストは、 CloudWatch に保存されてフィールドに表示されるため、以降のアラーム設定に利用できます。 **注記** [**トピックの作成**] を使用して新しい Amazon SNS トピックを作成する場合、目的の受信者が通知を受け取る前に、 E メール アドレスを確認する必要があります。Amazon SNS は、アラームがアラーム状態になったときにのみメールを送信します。アラーム状態になったときにメールアドレスの検証がまだ完了していない場合、宛先には通知が届きません。 1. **[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](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/)*」を参照してください。 ## Rekognition の CloudWatch メトリクスです。 このセクションでは、Amazon Rekognition で利用可能な Amazon CloudWatch メトリクスと *Operation* ディメンションに関する情報を提供します。 Rekognition コンソールから Rekognition の集計メトリクスを確認することもできます。詳細については、「[演習 4: 集計メトリクスを参照する (コンソール)](aggregated-metrics.md)」を参照してください。 ### Rekognition の CloudWatch メトリクスです。 次の表は、Rekognition メトリクスをまとめたものです。 | メトリクス | 説明 | | --- | --- | | SuccessfulRequestCount | 成功したリクエストの数。成功したリクエストのレスポンスコード範囲は 200〜299 です。 単位: 数 有効な統計: `Sum,Average` | | ThrottledCount | スロットルされたリクエストの数。Rekognitionは、アカウントに設定された 1 秒あたりのトランザクションの制限を超えるリクエストを受信すると、リクエストをスロットルします。アカウントに設定された制限を頻繁に超える場合は、制限の引き上げをリクエストできます。引き上げをリクエストするには、「[AWS サービス制限](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)」を参照してください。 単位: 数 有効な統計: `Sum,Average` | | ResponseTime | Rekognition がレスポンスを計算するための時間 (ミリ秒)。 単位: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/rekognition/latest/dg/rekognition-monitoring.html) 有効な統計: `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 サービス制限](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)」を参照してください。 単位: 数 有効な統計: `Sum,Average` | | ServerErrorCount | サーバーエラーの数。サーバーエラーのレスポンスコード範囲は 500〜599 です。 単位: 数 有効な統計: `Sum, Average` | | UserErrorCount | ユーザーエラーの数 (無効なパラメータ、無効なイメージ、アクセス権限なしなど)。ユーザーエラーのレスポンスコード範囲は 400〜499 です。 単位: 数 有効な統計: `Sum,Average` | | ConcurrentSessions | アカウントが現在使用している同時セッションの数。単位: 数有効な統計: `Max,Average` | ### Rekognition の CloudWatch ディメンション オペレーション別のメトリクスを取得するには、`Rekognition` 名前空間を使用して、オペレーションディメンションを指定します。 ディメンションの詳細については、「[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)」の「*ディメンション*」を参照してください。 ### Rekognition Custom Labels の CloudWatch ディメンション 次の表は、Rekognition Custom Labels で使用できる CloudWatch ディメンションを示しています。 **** | ディメンション | 説明 | | --- | --- | | ProjectName | CreateProject で作成した Rekognition Custom Labels プロジェクトの名前 | | VersionName | CreateProjectVersion で作成した Rekognition Custom Labels プロジェクトバージョンの名前 | ディメンションの詳細については、「[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)」の「*ディメンション*」を参照してください。