使用 Amazon CloudWatch 监控 - Amazon Location Service
指标与维度查看 指标创建 CloudWatch 警报使用 CloudWatch 根据配额监控使用情况指标输出示例

使用 Amazon CloudWatch 监控

Amazon CloudWatch 近乎实时监控您的 AWS 资源以及在 AWS 上运行的应用程序。您可以使用 CloudWatch 监控 Amazon Location 资源，此工具收集原始数据并近乎实时将指标处理成有意义的统计信息。您可以查看最长 15 个月的历史信息，也可以搜索要在 Amazon CloudWatch 控制台中查看的指标，以更深入地了解应用程序或服务的运行情况。您还可以通过定义阈值来设置警报，并在达到相应阈值时发送通知或执行操作。

有关更多信息，请参阅 Amazon CloudWatch 用户指南。

Amazon Location Service 指标与维度

指标是导出到 CloudWatch 的时间顺序数据点。维度是用于标识指标的名称/值对。有关更多信息，请参阅 Amazon CloudWatch 用户指南中的使用 CloudWatch 指标和 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 端点发出调用时，该操作处理和返回响应所花费的时间。

有效统计数据：平均值

单位：毫秒

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 CloudWatch 控制台上或使用 Amazon CloudWatch API 查看 Amazon Location Service 的指标。

使用 CloudWatch 控制台查看指标

  1. 通过以下网址打开 CloudWatch 控制台：https://console.aws.amazon.com/cloudwatch/。

  2. 在导航窗格中，选择指标。

  3. 在所有指标选项卡上，选择 Location 命名空间。

  4. 选择要查看的指标类型。

  5. 选择指标，然后添加到图表。

有关更多信息，请参阅 Amazon CloudWatch 用户指南中的查看可用指标。

为 Amazon Location Service 指标创建 CloudWatch 警报

您可以使用 CloudWatch 对 Amazon Location Service 指标设置警报。例如，您可以在 CloudWatch 中创建一个警报，用于在错误数出现峰值时立即发送电子邮件。

以下主题从较高层面上概括介绍了如何使用 CloudWatch 设置警报。有关详细说明，请参阅 Amazon CloudWatch 用户指南中的使用警报。

使用 CloudWatch 控制台设置警报

  1. 通过 https://console.aws.amazon.com/cloudwatch/ 打开 CloudWatch 控制台。

  2. 在导航窗格中，选择警报。

  3. 选择创建警报。

  4. 选择选择指标。

  5. 在所有指标选项卡上，选择 Location 命名空间。

  6. 选择指标类别。

  7. 找到您要为其创建警报的指标所在行，然后选中该行旁边的复选框。

  8. 选择选择指标。

  9. 在指标下，填写值。

  10. 指定警报条件。

  11. 选择下一步。

  12. 如果您想在满足警报条件时发送通知，请执行以下操作：

    • 在警报状态触发器下，选择警报状态以提示发送通知。

    • 在选择 SNS 主题下，选择创建新主题以创建新的 Amazon Simple Notification Service (Amazon SNS) 主题。输入主题名称和要向其发送通知的电子邮件。

    • 在发送通知下，输入要向其发送通知的其他电子邮件地址。

    • 选择 Add notification（添加通知）。此列表将保存下来并会在将来的警报字段中显示出来。

  13. 完成后选择下一步。

  14. 输入警报的名称和描述，然后选择下一步。

  15. 确认警报详情，然后选择下一步。

注意

创建新的 Amazon SNS 主题时，必须先验证电子邮件地址，然后才能发送通知。如果电子邮件未通过验证，则当警报因状态变化而启动时，将不会收到通知。

有关如何使用 CloudWatch 控制台设置警报的更多信息，请参阅 Amazon CloudWatch 用户指南中的创建发送电子邮件的警报。

使用 CloudWatch 根据配额监控使用情况

您可以创建 Amazon CloudWatch 警报，用于在给定配额使用率超过可配置阈值时通知您。这使您能够识别何时接近配额限制，并调整利用率以避免成本超支，或者在需要时请求增加配额。

有关如何使用 CloudWatch 监控配额的信息，请参阅 Amazon CloudWatch 用户指南中的可视化您的服务配额和设置警报。

Amazon Location Service 的 CloudWatch 指标示例

您可以使用 GetMetricData 来检索 Amazon Location 的指标。

  • 例如，您可以在数字下降时监控 CallCount 并设置警报。

    监控 SendDeviceLocation 的 CallCount 指标可以帮助您深入了解被跟踪的资产。如果 CallCount 下降，则意味着被追踪的资产（例如卡车车队）已停止发送其当前位置。为此设置警报可以帮助通知您发生了问题。

  • 再举一个例子，您可以监控 ErrorCount 并设置警报，以了解何时出现数量激增。

    跟踪器必须与地理围栏集合相链接，才能根据地理围栏评估设备位置。如果您的设备群需要持续更新位置，看到 BatchEvaluateGeofence 或 BatchPutDevicePosition 的 CallCount 为零表示更新不再流动。

以下是 GetMetricData 的输出示例，其中包含用于创建地图资源 CallCount 和 ErrorCount 的指标。

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