Amazon CloudWatch で を監視する - Amazon Location Service

Amazon CloudWatch で を監視する

Amazon CloudWatch は、AWS のリソースや AWS で実行しているアプリケーションを、リアルタイムでモニタリングします。raw データを収集し、メトリクスをほぼリアルタイムで意味のある統計に処理する CloudWatch を使用して、Amazon Location リソースをモニタリングすることができます。最大 15 か月間の履歴情報が表示できます。また、メトリクスを Amazon CloudWatch コンソールで検索して、アプリケーションやサービスのパフォーマンスに関するより詳細な情報を確認することもできます。しきい値を定義してアラームを設定し、そのしきい値に達したときに通知を送信したりアクションを実行したりすることもできます。

詳細については、「Amazon CloudWatch ユーザーガイド」を参照してください

Amazon Location Service メトリクスとディメンション

メトリックスは、CloudWatch にエクスポートされる時系列のデータポイントです。ディメンションは、メトリクスを識別する名前と値のペアです。CloudWatch メトリクスの詳細については、Amazon CloudWatch ユーザーガイドAmazon CloudWatch メトリクスの使用を参照してください。

注記

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 コンソールを使用してメトリクスを表示するには

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

  2. ナビゲーションペインで [Metrics (メトリクス)] を選択してください。

  3. [すべてのメトリクス] タブで、[Location] 名前空間を選択します。

  4. 表示するメトリクスのタイプを選択します。

  5. メトリクスを選択してグラフに追加します。

詳細については、Amazon CloudWatch ユーザーガイドの「使用可能なメトリクスの表示」を参照してください。

Amazon Location Service メトリクス用の CloudWatch アラームの作成

CloudWatch を使って、Amazon Location Service のメトリクスにアラームを設定することができます。例えば、CloudWatch でアラームを作成し、エラーが急増するたびにメールを送信することができます。

以下のトピックでは、 を使用してアラームを設定する方法の概要について説明します。詳細な手順については、Amazon CloudWatch ユーザーガイドの「Amazon CloudWatch でのアラームの使用」を参照してください。

CloudWatch コンソールを使用してアラームを設定するには

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

  2. ナビゲーションペインで、アラームを選択します。

  3. アラームの作成(アラームの作成) を選択します。

  4. メトリクスの選択 を選択します。

  5. [すべてのメトリクス] タブで、[Location] 名前空間を選択します。

  6. メトリクスカテゴリを選択してくだい。

  7. アラームを作成したいメトリクスのあるその行の横にあるチェックボックスを選択してください。

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

  9. [メトリクス] に値を入力してください。

  10. アラームの [条件] を指定してください。

  11. [次へ] を選択します。

  12. アラーム条件が満たされたときに通知を送信したい場合:

    • アラーム状態のトリガーで、通知の送信を促すアラーム状態を選択します。

    • SNS トピックの選択新しいトピックの作成を選択し、新しい Amazon Simple Notification Service (Amazon SNS) トピックを作成します。トピック名と通知の送信先のメールを入力します。

    • 通知を送信で、通知の送信先となる追加のメールアドレスを入力します。

    • 通知を追加 をクリックします。このリストは保存され、今後のアラーム用のフィールドに表示されます。

  13. 終了したら、次へを選択します。

  14. アラームの名前と説明を入力し、次へを選択します。

  15. アラームの詳細を確認して、次へを選択します。

注記

新しいAmazon SNS トピックを作成する場合、E メールアドレスを検証しなければ、そのアドレスで通知を受け取ることができません。メールが確認されていない場合、状態の変化によりアラームが開始されても、通知は受信されません。

CloudWatch コンソールを使用してアラームを設定する方法の詳細については、Amazon CloudWatch ユーザーガイドの「メールを送信するアラームの作成」を参照してください。

CloudWatch を使用してクォータの使用量をモニタリングする

Amazon CloudWatch アラームを作成して、特定のクォータの使用率が設定可能なしきい値を超えた場合に通知することができます。これにより、割り当ての限界に近づいたことを認識し、コストオーバーを避けるために利用率を調整するか、必要であれば割り当ての増額を要求することができる。

CloudWatch を利用してクォータをモニタリングする方法については、Amazon CloudWatch ユーザーガイドの「Service Quotas の可視化とアラームの設定」を参照してください。

Amazon Location Service の CloudWatch メトリクス例

GetMetricData API を利用して、Amazon Location のメトリクスを取得することができます。

  • 例えば、CallCount をモニタリングして、数値が低下したときのアラームを設定することができます。

    SendDeviceLocationCallCount メトリクスをモニタリングすることで、追跡対象資産の全体像を把握しやすくなります。CallCount 値が下がった場合は、トラックのフリートなどの追跡対象資産が現在の位置の送信を停止したことを意味します。このアラームを設定することで、問題が発生したことを知らせるのに役立ちます。

  • 別の例では、ErrorCount をモニタリングして、数値の急上昇が起こったときにアラームを設定することができます。

    デバイスの位置をジオフェンスと照合して評価するには、トラッカーをジオフェンスコレクションに関連付ける必要があります。継続的な位置情報の更新を必要とするデバイスフリートがある場合、BatchEvaluateGeofence または BatchPutDevicePositionCallCount がゼロになるのは、更新がもはや流れていないことを表示します。

以下は、マップリソースを作成するためのメトリクスとマップリソースを作成するための CallCountErrorCount のメトリックを含む GetMetricData のアウトプット例です。

{ "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" } } ] }