翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon CloudWatch で   を監視する Amazon CloudWatch は、 AWS リソースと AWS で実行するアプリケーションをほぼリアルタイムでモニタリングします。raw データを収集し、メトリクスをほぼリアルタイムで意味のある統計に処理する CloudWatch を使用して、Amazon Location リソースをモニタリングすることができます。最大 15 か月間の履歴情報が表示できます。また、メトリクスを Amazon CloudWatch コンソールで検索して、アプリケーションやサービスのパフォーマンスに関するより詳細な情報を確認することもできます。しきい値を定義してアラームを設定し、そのしきい値に達したときに通知を送信したりアクションを実行したりすることもできます。 詳細については、「[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)」を参照してください **Topics** + [Amazon Location Service メトリクスとディメンション](#metrics-exported-to-cloudwatch) + [Amazon Location Service のメトリクスを見る](#view-metrics) + [Amazon Location Service メトリクス用の CloudWatch アラームの作成](#create-alarms) + [CloudWatch を使用してクォータの使用量をモニタリングする](#alarms-on-quotas) + [Amazon Location Service の CloudWatch メトリクス例](#example-alarms) ## Amazon Location Service メトリクスとディメンション メトリックスは、CloudWatch にエクスポートされる時系列のデータポイントです。ディメンションは、メトリクスを識別する名前と値のペアです。CloudWatch メトリクスの詳細については、[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)の [Amazon CloudWatch メトリクスの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)を参照してください。 **注記** Amazon Location Service の分散アーキテクチャにより、結果は概算になります。ほとんどの場合、カウントは送信される API オペレーションの実際の数に近い必要があります。 ### Amazon Location Service のメトリクス 以下は、Amazon Location Service が `AWS/Location` 名前空間で CloudWatch にエクスポートするメトリクスは次のとおりです。 | メトリクス | 説明 | ディメンション | | --- | --- | --- | | `CallCount` | 特定の API エンドポイントに対して行われた呼び出しの回数。 有効な統計: Sum 単位: カウント | OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName OperationName、OperationVersion OperationName、OperationVersion、ResourceName ApiKeyName、OperationName、OperationVersion ApiKeyName、OperationName、OperationVersion、ResourceName | | `ErrorCount` | 特定の API エンドポイントに対して行われた呼び出しによるエラーレスポンスの数。 有効な統計: Sum 単位: カウント | OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName | | `SuccessCount` | 特定の API エンドポイントに対して成功した呼び出しの数。 有効な統計: Sum 単位: カウント | OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName | | `CallLatency` | 特定の API エンドポイントに対して呼び出しが行われたときに、オペレーションがレスポンスを処理して応答が返されるまでにかかる時間。 有効な統計: Average 単位: ミリ秒 | OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName | ### Amazon Location Service メトリクスのディメンション Amazon Location Service のメトリクスをフィルターするには、次の表のディメンションを使用できます。 | ディメンション | 説明 | | --- | --- | | OperationName | 指定されたオペレーション名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。 | | OperationName、ResourceName | 指定されたオペレーション名とリソース名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。 | | ApiKeyName、OperationName | 指定されたオペレーション名と指定された API キー名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。 | | ApiKeyName、OperationName、ResourceName | 指定されたオペレーション名、リソース名、および指定された API キー名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。 | | OperationName、OperationVersion | 指定されたオペレーション名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。 Amazon Location Service スタンドアロンのマップ、場所、ルートは、このディメンションへのエクスポートメトリクスになります。 | | OperationName、OperationVersion、ResourceName | 指定されたオペレーション名、バージョン、Amazon Location リソース名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。 Amazon Location スタンドアロンのマップ、場所、ルートは、このディメンションへのエクスポートメトリクスになります。 | | ApiKeyName、OperationName、OperationVersion | 指定されたオペレーション名、バージョン、および指定された API キー名を使用して、API オペレーションに対する Amazon Location メトリクスをフィルタリングします。 Amazon Location スタンドアロンのマップ、場所、ルートは、このディメンションへのエクスポートメトリクスになります。 | | ApiKeyName、OperationName、OperationVersion、ResourceName | 指定されたオペレーション名、バージョン、リソース名、および指定された API キー名を使用して、API オペレーションに対する Amazon Location メトリクスをフィルタリングします。 Amazon Location スタンドアロンのマップ、場所、ルートは、このディメンションへのエクスポートメトリクスになります。 | ## Amazon Location Service のメトリクスを見る Amazon Location Service のメトリクスは、 Amazon CloudWatch コンソールまたは Amazon CloudWatch API を使用して表示できます。 **CloudWatch コンソールを使用してメトリクスを表示するには** **Example** 1. CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。 1. ナビゲーションペインで [**Metrics (メトリクス)**] を選択してください。 1. **[すべてのメトリクス]** タブで、**[Location]** 名前空間を選択します。 1. 表示するメトリクスのタイプを選択します。 1. メトリクスを選択してグラフに追加します。 詳細については、*Amazon CloudWatch ユーザーガイド*の「[使用可能なメトリクスの表示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)」を参照してください。 ## Amazon Location Service メトリクス用の CloudWatch アラームの作成 CloudWatch を使って、Amazon Location Service のメトリクスにアラームを設定することができます。例えば、CloudWatch でアラームを作成し、エラーが急増するたびにメールを送信することができます。 以下のトピックでは、 を使用してアラームを設定する方法の概要について説明します。詳細な手順については、*Amazon CloudWatch ユーザーガイド*の「[Amazon CloudWatch でのアラームの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)」を参照してください。 **CloudWatch コンソールを使用してアラームを設定するには** **Example** 1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。 1. ナビゲーションペインで、**アラーム**を選択します。 1. **アラームの作成**(アラームの作成) を選択します。 1. **メトリクスの選択** を選択します。 1. **[すべてのメトリクス]** タブで、**[Location]** 名前空間を選択します。 1. メトリクスカテゴリを選択してくだい。 1. アラームを作成したいメトリクスのあるその行の横にあるチェックボックスを選択してください。 1. **メトリクスの選択** を選択します。 1. **[メトリクス]** に値を入力してください。 1. アラームの **[条件]** を指定してください。 1. [**次へ**] を選択します。 1. アラーム条件が満たされたときに通知を送信したい場合: + **アラーム状態のトリガー**で、通知の送信を促すアラーム状態を選択します。 + **SNS トピックの選択**で**新しいトピックの作成**を選択し、新しい Amazon Simple Notification Service (Amazon SNS) トピックを作成します。トピック名と通知の送信先のメールを入力します。 + **通知を送信**で、通知の送信先となる追加のメールアドレスを入力します。 + **通知を追加** をクリックします。このリストは保存され、今後のアラーム用のフィールドに表示されます。 1. 終了したら、**次へ**を選択します。 1. アラームの名前と説明を入力し、**次へ**を選択します。 1. アラームの詳細を確認して、**次へ**を選択します。 **注記** 新しいAmazon SNS トピックを作成する場合、E メールアドレスを検証しなければ、そのアドレスで通知を受け取ることができません。メールが確認されていない場合、状態の変化によりアラームが開始されても、通知は受信されません。 CloudWatch コンソールを使用してアラームを設定する方法の詳細については、*Amazon CloudWatch ユーザーガイド*の「[メールを送信するアラームの作成](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)」を参照してください。 ## CloudWatch を使用してクォータの使用量をモニタリングする Amazon CloudWatch アラームを作成して、特定のクォータの使用率が設定可能なしきい値を超えた場合に通知することができます。これにより、割り当ての限界に近づいたことを認識し、コストオーバーを避けるために利用率を調整するか、必要であれば割り当ての増額を要求することができる。 CloudWatch を利用してクォータをモニタリングする方法については、*Amazon CloudWatch ユーザーガイド*の「[Service Quotas の可視化とアラームの設定](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)」を参照してください。 ## Amazon Location Service の CloudWatch メトリクス例 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) API を利用して、Amazon Location のメトリクスを取得することができます。 + 例えば、`CallCount` をモニタリングして、数値が低下したときのアラームを設定することができます。 `SendDeviceLocation` の `CallCount` メトリクスをモニタリングすることで、追跡対象資産の全体像を把握しやすくなります。`CallCount` 値が下がった場合は、トラックのフリートなどの追跡対象資産が現在の位置の送信を停止したことを意味します。このアラームを設定することで、問題が発生したことを知らせるのに役立ちます。 + 別の例では、`ErrorCount` をモニタリングして、数値の急上昇が起こったときにアラームを設定することができます。 デバイスの位置をジオフェンスと照合して評価するには、トラッカーをジオフェンスコレクションに関連付ける必要があります。継続的な位置情報の更新を必要とするデバイスフリートがある場合、`BatchEvaluateGeofence` または `BatchPutDevicePosition` の `CallCount` がゼロになるのは、更新がもはや流れていないことを表示します。 以下は、マップリソースを作成するためのメトリクスとマップリソースを作成するための `CallCount` と `ErrorCount` のメトリックを含む [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) のアウトプット例です。 ``` { "StartTime": 1518867432, "EndTime": 1518868032, "MetricDataQueries": [ { "Id": "m1", "MetricStat": { "Metric": { "Namespace": "AWS/Location", "MetricName": "CallCount", "Dimensions": [ { "Name": "SendDeviceLocation", "Value": "100" } ] }, "Period": 300, "Stat": "SampleCount", "Unit": "Count" } }, { "Id": "m2", "MetricStat": { "Metric": { "Namespace": "AWS/Location", "MetricName": "ErrorCount", "Dimensions": [ { "Name": "AssociateTrackerConsumer", "Value": "0" } ] }, "Period": 1, "Stat": "SampleCount", "Unit": "Count" } } ] } ```