本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon 进行监控 CloudWatch
<a name="cloudwatch"></a>

Amazon 近乎实时地 CloudWatch 监控您的 AWS 资源和您运行 AWS 的应用程序。您可以使用监控 Amazon Location 资源 CloudWatch，该资源可以近乎实时地收集原始数据并将指标处理成有意义的统计数据。您可以查看长达 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)
+ [CloudWatch Amazon Location Service 的指标示例](#example-alarms)

## Amazon Location Service 指标与维度
<a name="metrics-exported-to-cloudwatch"></a>

指标是导出到 CloudWatch的时间顺序数据点。维度是标识指标 name/value 的一对。有关更多信息，请参阅 Amazon CloudWatch 用户指南中的[使用 CloudWatch 指标](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)和[CloudWatch 维度](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)。

**注意**  
由于 Amazon Location Service 采用分布式架构，结果为近似值。在大多数情况下，计数应接近实际发送的 API 操作数。

### Amazon Location Service 指标
<a name="service-metrics"></a>

以下是 Amazon Location Service 在`AWS/Location`命名空间 CloudWatch 中导出的指标。


| 指标 | 说明 | Dimensions | 
| --- | --- | --- | 
|  `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 指标维度
<a name="service-dimensions"></a>

您可以使用下表中的维度筛选 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
<a name="view-metrics"></a>

您可以在 Amazon CloudWatch 控制台上或使用 Amazon CloudWatch API 查看 Amazon Location Service 的指标。

**使用 CloudWatch 控制台查看指标**

**Example**  

1. 打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。

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

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

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

1. 选择指标，然后添加到图表。
有关更多信息，请参阅 *Amazon CloudWatch 用户指南*中的[查看可用指标](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)。

## 为 Amazon Location Service 指标创建 CloudWatch 警报
<a name="create-alarms"></a>

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

以下主题从较高层面上概括介绍了如何使用 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) 主题。输入主题名称和要向其发送通知的电子邮件。
   + 在**发送通知**下，输入要向其发送通知的其他电子邮件地址。
   + 选择 **Add notification（添加通知）**。此列表将保存下来并会在将来的警报字段中显示出来。

1. 完成后选择**下一步**。

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

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

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

有关如何使用 CloudWatch 控制台设置警报的更多信息，请参阅 *Amazon CloudWatch 用户指南*中的[创建发送电子邮件的警](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)报。

## 用于 CloudWatch 根据配额监控使用情况
<a name="alarms-on-quotas"></a>

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

有关 CloudWatch 如何使用监控配额的信息，请参阅 *Amazon CloudWatch 用户指南*中的[可视化服务配额和设置警报](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)。

## CloudWatch Amazon Location Service 的指标示例
<a name="example-alarms"></a>

您可以使用 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)API 检索亚马逊位置的指标。
+ 例如，您可以在数字下降时监控 `CallCount` 并设置警报。

  监控 `SendDeviceLocation` 的 `CallCount` 指标可以帮助您深入了解被跟踪的资产。如果 `CallCount` 下降，则意味着被追踪的资产（例如卡车车队）已停止发送其当前位置。为此设置警报可以帮助通知您发生了问题。
+ 再举一个例子，您可以监控 `ErrorCount` 并设置警报，以了解何时出现数量激增。

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

以下是创建地图资源的示例输出 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)，其中包含`ErrorCount`用于创建地图资源的指标。`CallCount`

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