翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon CloudWatch による Amazon Personalize のモニタリング
Amazon CloudWatch を使用すると、Amazon Personalize に関連付けられたメトリクスを取得できます。これらのメトリクスのうち 1 つ以上が定義されたしきい値から外れるときに通知を行うようにアラームを設定できます。メトリクスを表示するには、[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/) を使用できます。
**Topics**
+ [Amazon Personalize の CloudWatch メトリクスの使用](#using-metrics)
+ [Amazon Personalize メトリクスへのアクセス](#how-to-access)
+ [アラームを作成する](#alarms)
+ [Amazon Personalize のサーバーレスモニタリングアプリケーションの例](#creating-monitor-app)
+ [Amazon Personalize の CloudWatch メトリクス](cloudwatch-metrics.md)
## Amazon Personalize の CloudWatch メトリクスの使用
メトリクスを使用するには、以下の情報を指定する必要があります。
+ メトリクスの名前。
+ メトリクスディメンション。*ディメンション*は、メトリクスを一意に識別するための名前と値のペアです。
AWS マネジメントコンソール、 AWS CLI、または CloudWatch API を使用して、Amazon Personalize のモニタリングデータを取得できます。また、 AWS SDKs または CloudWatch API ツールを使用して CloudWatch API を使用することもできます。コンソールには、CloudWatch API の raw データに基づいて一連のグラフが表示されます。必要に応じて、コンソールに表示されるグラフまたは API から取得したグラフを使用できます。
以下のリストは、メトリクスの一般的な利用方法をいくつか示しています。ここで紹介するのは開始するための提案事項です。すべてを網羅しているわけではありません。
| どうすればよいか? | 関連するメトリクス |
| --- | --- |
| 記録されたイベント数を追跡するにはどうすればよいですか。 | `PutEventsRequests` メトリクスをモニタリングします。 |
| DatasetImportJob エラーをモニタリングするにはどうすればよいですか。 | `DatasetImportJobError` メトリクスを使用します。 |
| `GetRecommendations` 呼び出しのレイテンシーをモニタリングするにはどうすればよういですか。 | `GetRecommendationsLatency` メトリクスを使用します。 |
CloudWatch で Amazon Personalize をモニタリングするには、適切な CloudWatch の許可が必要です。詳細については、「[Amazon CloudWatch に対する認証とアクセスコントロール](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)」を参照してください。
## Amazon Personalize メトリクスへのアクセス
次の例は、CloudWatch コンソール、 AWS CLI、および CloudWatch API を使用して Amazon Personalize メトリクスにアクセスする方法を示しています。
**メトリクスを表示するには (コンソール)**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. **[Metrics]** (メトリクス) を選択し、**[All metrics]** (すべてのメトリクス) タブを選択して、`AWS/Personalize` を選択します。
1. メトリクスディメンションを選択します。
1. リストから目的のメトリクスを選択して、グラフの期間を選択します。
**一定期間中に受信したイベントのメトリクスを表示するには (CLI)。**
+ を開き AWS CLI 、次のコマンドを入力します。
```
aws cloudwatch get-metric-statistics \
--metric-name PutEventsRequests \
--start-time 2019-03-15T00:00:20Z \
--period 3600 \
--end-time 2019-03-16T00:00:00Z \
--namespace AWS/Personalize \
--dimensions Name=EventTrackerArn,Value=EventTrackerArn \
--statistics Sum
```
この例では、指定するイベントトラッカー ARN に一定期間中に受信したイベントを示します。詳細については、「[get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/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 のトピックまたは AWS Auto Scaling のポリシーに送信される通知です。
アラームは持続している状態変化に対してのみアクションを呼び出します。CloudWatch アラームは、特定の状態にあるという理由だけではアクションを呼び出しません。状態が変って、変わった状態が指定期間にわたって維持される必要があります。
**アラームを設定するには (コンソール)**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. ナビゲーションペインで、[**Alarms**] を選択し、[**Create alarm**] を選択します。これにより、[**Create Alarm Wizard**] が起動します。
1. **[メトリクスの選択]** を選択します。
1. **[All metrics]** (すべてのメトリクス) タブで、`AWS/Personalize` を選択します。
1. [**EventTrackerArn**]、[**PutEventsRequests**] メトリクスの順に選択します。
1. **[グラフ化したメトリクス]** タブを選択します。
1. [**統計**] で、[**合計**] を選択します。
1. **[メトリクスの選択]** を選択します。
1. [**名前**] と [**説明**] を入力します。[**次の時**] で、[**>**] を選択し、任意の最大値を入力します。
1. アラーム状態になったときに CloudWatch からメールを送信させたい場合は、**[Whenever this alarm:]** (このアラームが鳴る時:) で、**[State is ALARM]** (アラーム状態) を選択します。既存の Amazon SNS トピックにアラームを送信するには、[**通知の送信先:**] で既存の SNS トピックを選択します。新しいメールサブスクリプションリスト用の名前とメールアドレスを設定するには、[**新しいリスト**] を選択します。CloudWatch はリストを保存してフィールドに表示されるため、以降のアラーム設定に利用できます。
**注記**
[**新しいリスト**] を使用して新しい Amazon SNS トピックを作成する場合は、宛先に通知を送信する前にメールアドレスを検証する必要があります。Amazon SNS は、アラームがアラーム状態になったときにのみメールを送信します。アラーム状態になったときにメールアドレスの検証がまだ完了していない場合、宛先には通知が届きません。
1. [**アラームの作成**] を選択します。
**アラームを設定するには (AWS CLI)**
+ を開き AWS CLI、次のコマンドを入力します。`alarm-actions` パラメータの値を変更して、作成済みの Amazon SNS トピックを参照します。
```
aws cloudwatch put-metric-alarm \
--alarm-name PersonalizeCLI \
--alarm-description "Alarm when more than 10 events occur" \
--metric-name PutEventsRequests \
--namespace AWS/Personalize \
--statistic Sum \
--period 300 \
--threshold 10 \
--comparison-operator GreaterThanThreshold \
--evaluation-periods 1 \
--unit Count \
--dimensions Name=EventTrackerArn,Value=EventTrackerArn \
--alarm-actions SNSTopicArn
```
この例では、指定するイベントトラッカーで 5 分以内に 10 回以上発生したイベントへのアラームを作成する方法を示しています。詳細については、「[put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/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/)*」を参照してください。
## Amazon Personalize のサーバーレスモニタリングアプリケーションの例
Amazon Personalize のモニタリング、アラート、および最適化の機能を追加するアプリケーションの例については、[Amazon Personalize サンプル](https://github.com/aws-samples/amazon-personalize-samples)リポジトリの「[Amazon Personalize のモニタリング](https://github.com/aws-samples/amazon-personalize-monitor)」を参照してください。
# Amazon Personalize の CloudWatch メトリクス
このセクションには、Amazon Personalize で利用可能な Amazon CloudWatch メトリクスに関する情報が含まれています。詳細については、「[Amazon CloudWatch による Amazon Personalize のモニタリング](personalize-monitoring.md)」を参照してください。
次の表には、Amazon Personalize のメトリクスが一覧表示されています。GetRecommendations および GetPersonalizedRankingを除くすべてのメトリクスは、`Average, Minimum, Maximum, Sum` の統計をサポートします。GetRecommendations と GetPersonalizedRanking サポート `Sum` のみを受けてください。
| メトリクス | 説明 |
| --- | --- |
| DatasetImportJobRequests | 成功した [CreateDatasetImportJob](API_CreateDatasetImportJob.md) API 呼び出しの数。 ディメンション: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` |
| DatasetImportJobError | エラーが発生した `CreateDatasetImportJob` API 呼び出しの数。 ディメンション: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` |
| DatasetImportJobExecutionTime | `CreateDatasetImportJob` API 呼び出しからオペレーション完了 (または失敗) までの時間。 ディメンション: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` 単位: 秒 |
| DatasetSize | データセットインポートジョブによってインポートされるデータのサイズ。 ディメンション: `DatasetGroupArn, DatasetArn, DatasetImportJobArn` 単位: バイト |
| SolutionTrainingJobRequests | 成功した [CreateSolutionVersion](API_CreateSolutionVersion.md) API 呼び出しの数。 ディメンション: `SolutionArn, SolutionVersionArn` |
| SolutionTrainingJobError | エラーが発生した `CreateSolutionVersion` API 呼び出しの数。 ディメンション: `SolutionArn, SolutionVersionArn` |
| SolutionTrainingJobExecutionTime | `CreateSolutionVersion` API 呼び出しからオペレーション完了 (または失敗) までの時間。 ディメンション: `SolutionArn, SolutionVersionArn` 単位: 秒 |
| GetPersonalizedRanking | API コールが成功したかどうか。[GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)`sum` の統計を使用して、成功した GetPersonalizedRanking API コールの合計数を表示します。このメトリクスは他の統計をサポートしていません。 ディメンション: `CampaignArn` |
| GetPersonalizedRanking4xxErrors | 4xx HTTP 応答コードを返した `GetPersonalizedRanking` API 呼び出しの数。 ディメンション: `CampaignArn` |
| GetPersonalizedRanking5xxErrors | 5xx HTTP 応答コードを返した `GetPersonalizedRanking` 呼び出しの数。 ディメンション: `CampaignArn` |
| GetPersonalizedRankingLatency | `GetPersonalizedRanking` API 呼び出しを受信してからレコメンデーションを送信するまでの時間 (4xx および 5xx エラーを除く)。 ディメンション: `CampaignArn` 単位: ミリ秒 |
| GetRecommendations | [GetRecommendations](API_RS_GetRecommendations.md) API コールが成功したかどうか。`sum` の統計を使用して、成功した GetRecommendations API コールの合計数を表示します。このメトリクスは他の統計をサポートしていません。 ディメンション: `CampaignArn` |
| GetRecommendations4xxErrors | 4xx HTTP 応答コードを返した `GetRecommendations` API 呼び出しの数。 ディメンション: `CampaignArn` |
| GetRecommendations5xxErrors | 5xx HTTP 応答コードを返した `GetRecommendations` 呼び出しの数。 ディメンション: CampaignArn |
| GetRecommendationsLatency | `GetRecommendations` API 呼び出しを受信してからレコメンデーションを送信するまでの時間 (4xx および 5xx エラーを除く)。 ディメンション: `CampaignArn` 単位: ミリ秒 |
| PutEventsRequests | 成功した [PutEvents](API_UBS_PutEvents.md) API 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEvents4xxErrors | 4xx HTTP 応答コードを返した `PutEvents` API 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEvents5xxErrors | 5xx HTTP 応答コードを返した `PutEvents` 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn, EventTrackerArn` |
| PutEventLatency | `PutEvents` API 呼び出しの完了にかかった時間 (4xx および 5xx エラーを除く)。 ディメンション: ` DatasetGroupArn, DatasetArn, EventTrackerArn` 単位: ミリ秒 |
| PutItemsRequests | 成功した [PutItems](API_UBS_PutItems.md) API 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn` |
| PutItems4xxErrors | 4xx HTTP 応答コードを返した `PutItems` API 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn` |
| PutItems5xxErrors | 5xx HTTP 応答コードを返した `PutItems` 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn` |
| PutItemsLatency | `PutItems` API 呼び出しの完了にかかった時間 (4xx および 5xx エラーを除く)。 ディメンション: ` DatasetGroupArn, DatasetArn` 単位: ミリ秒 |
| PutUsersRequests | 成功した [PutUsers](API_UBS_PutUsers.md) API 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn` |
| PutUsers4xxErrors | 4xx HTTP 応答コードを返した `PutUsers` API 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn` |
| PutUsers5xxErrors | 5xx HTTP 応答コードを返した `PutUsers` 呼び出しの数。 ディメンション: ` DatasetGroupArn, DatasetArn` |
| PutUsersLatency | `PutUsers` API 呼び出しの完了にかかった時間 (4xx および 5xx エラーを除く)。 ディメンション: ` DatasetGroupArn, DatasetArn` 単位: ミリ秒 |