Amazon CloudWatch を使用して Amazon Location Service をモニタリングする
Amazon CloudWatch は、AWS のリソースや AWS で実行しているアプリケーションを、リアルタイムでモニタリングします。raw データを収集し、メトリクスをほぼリアルタイムで意味のある統計に処理する CloudWatch を使用して、Amazon Location リソースをモニタリングすることができます。最大 15 か月間の履歴情報が表示できます。また、メトリクスを Amazon CloudWatch コンソールで検索して、Amazon Location リソースに関するより詳細な情報を確認することもできます。しきい値を定義してアラームを設定し、そのしきい値に達したときに通知を送信したりアクションを実行したりすることもできます。
詳細については、「Amazon CloudWatch ユーザーガイド」を参照してください
トピック
Amazon CloudWatch にエクスポートされた Amazon Location Service のメトリクス
メトリックスは、CloudWatch にエクスポートされる時系列のデータポイントです。ディメンションは、メトリクスを識別する名前と値のペアです。CloudWatch メトリクスの詳細については、Amazon CloudWatch ユーザーガイドの Amazon CloudWatch メトリクスの使用を参照してください。
以下は、Amazon Location Service が AWS/Location
名前空間で CloudWatch にエクスポートするメトリクスは次のとおりです。
メトリクス | 説明 |
---|---|
|
特定の API エンドポイントに対して行われた呼び出しの回数。 有効なディメンション:Amazon Location Service API 名 有効な統計: Sum 単位: カウント |
|
特定の API エンドポイントに対して行われた呼び出しによるエラー・レスポンスの数。 有効なディメンション:Amazon Location Service API 名 有効な統計: Sum 単位: カウント |
|
特定の API エンドポイントに対して成功した呼び出しの数。 有効なディメンション:Amazon Location Service API 名 有効な統計: Sum 単位: カウント |
|
特定の API エンドポイントに対して呼び出しが行われたときに、オペレーションがレスポンスを処理して応答が返されるまでにかかる時間。 有効なディメンション:Amazon Location Service API 名 有効な統計: Average 単位: ミリ秒 |
Amazon Location Service のメトリクスを見る
Amazon Location Service メトリクスは、Amazon CloudWatch コンソールまたは Amazon CloudWatch API を使って表示することができます。
CloudWatch コンソールを使用してメトリクスを表示するには
-
CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/
) を開きます。 -
ナビゲーションペインで [メトリクス]を選択します。
-
すべてのメトリクスタブで、Amazon Location 名前空間を選択してください。
-
表示するメトリクスのタイプを選択します。
-
メトリクスを選択してグラフに追加します。
詳細については、Amazon CloudWatch ユーザーガイドの「使用可能なメトリクスの表示」を参照してください。
Amazon Location Service メトリクス用の CloudWatch アラームの作成
CloudWatch を使って、Amazon Location Service のメトリクスにアラームを設定することができます。例えば、CloudWatch でアラームを作成し、エラーが急増するたびにメールを送信することができます。
以下のトピックでは、 を使用してアラームを設定する方法の概要について説明します。詳細な手順については、Amazon CloudWatch ユーザーガイドの「Amazon CloudWatch でのアラームの使用」を参照してください。
CloudWatch コンソールを使用してアラームを設定するには
-
CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/
) を開きます。 -
ナビゲーションペインで、アラームを選択します。
-
アラームの作成(アラームの作成) を選択します。
-
メトリクスの選択 を選択します。
-
すべてのメトリクスタブで、Amazon Location 名前空間を選択してください。
-
メトリクスカテゴリを選択してくだい。
-
アラームを作成したいメトリクスのあるその行の横にあるチェックボックスを選択してください。
-
メトリクスの選択 を選択します。
-
メトリクスに値を入力してください。
-
アラームの条件を指定してください。
-
次へ をクリックします。
-
アラーム条件が満たされたときに通知を送信したい場合:
-
アラーム状態のトリガーで、通知の送信を促すアラーム状態を選択します。
-
SNS トピックの選択で新しいトピックの作成を選択し、新しい Amazon Simple Notification Service (Amazon SNS) トピックを作成します。トピック名と通知の送信先のメールを入力します。
-
通知を送信で、通知の送信先となる追加のメールアドレスを入力します。
-
通知を追加 をクリックします。このリストは保存され、今後のアラーム用のフィールドに表示されます。
-
-
終了したら、次へを選択します。
-
アラームの名前と説明を入力し、次へを選択します。
-
アラームの詳細を確認して、次へを選択します。
注記
新しいAmazon SNS トピックを作成する場合、E メールアドレスを検証しなければ、そのアドレスで通知を受け取ることができません。メールが確認されていない場合、状態の変化によりアラームが開始されても、通知は受信されません。
CloudWatch コンソールを使用してアラームを設定する方法の詳細については、Amazon CloudWatch ユーザーガイドの「Create an Alarm that Sends Email」を参照してください。
CloudWatch を使用してクォータの使用量をモニタリングする
Amazon CloudWatch アラームを作成して、特定のクォータの使用率が設定可能なしきい値を超えた場合に通知することができます。これにより、割り当ての限界に近づいたことを認識し、コストオーバーを避けるために利用率を調整するか、必要であれば割り当ての増額を要求することができる。CloudWatch を利用してクォータをモニタリングする方法については、Amazon CloudWatch ユーザーガイドの「サービスクォータの可視化とアラームの設定」を参照してください。
Amazon Location Service の CloudWatch メトリクス例
GetMetricData API を利用して、Amazon Location のメトリクスを取得することができます。
-
例えば、
CallCount
をモニタリングして、数値が低下したときのアラームを設定することができます。SendDeviceLocation
のCallCount
メトリクスをモニタリングすることで、追跡対象資産の全体像を把握しやすくなります。CallCount
値が下がった場合は、トラックのフリートなどの追跡対象資産が現在の位置の送信を停止したことを意味します。このアラームを設定することで、問題が発生したことを知らせるのに役立ちます。 -
別の例では、
ErrorCount
をモニタリングして、数値の急上昇が起こったときにアラームを設定することができます。デバイスの位置をジオフェンスと照合して評価するには、トラッカーをジオフェンスコレクションに関連付ける必要があります。継続的な位置情報の更新を必要とするデバイスフリートがある場合、
BatchEvaluateGeofence
またはBatchPutDevicePosition
のCallCount
がゼロになるのは、更新がもはや流れていないことを表示します。
以下は、マップリソースを作成するためのメトリクスとマップリソースを作成するための CallCount
と ErrorCount
のメトリックを含む 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" } } ] }