本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon CloudWatch 監控
<a name="cloudwatch"></a>

Amazon CloudWatch 會近乎即時 AWS 地監控您的 AWS 資源和您在 上執行的應用程式。您可以使用 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 指標和維度
<a name="metrics-exported-to-cloudwatch"></a>

指標是匯出至 CloudWatch 的時間排序資料點。維度是識別指標的名稱/值對。如需詳細資訊，請參閱《Amazon [ CloudWatch 使用者指南》中的使用 CloudWatch 指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)和 [CloudWatch 維度 CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)。 Amazon CloudWatch 

**注意**  
由於 Amazon Location Service 的分散式架構，結果為近似值。在大多數情況下，計數應接近實際傳送的 API 操作數量。

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

以下是 Amazon Location Service 在 `AWS/Location` 命名空間中匯出至 CloudWatch 的指標。


| 指標 | Description | 維度 | 
| --- | --- | --- | 
|  `CallCount`  |  對指定 API 端點進行的呼叫數。 有效統計資訊：總和 單位：Count  |  OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName OperationName、OperationVersion OperationName、OperationVersion、ResourceName ApiKeyName、OperationName、OperationVersion ApiKeyName、OperationName、OperationVersion、ResourceName  | 
|  `ErrorCount`  |  對指定 API 端點發出的呼叫的錯誤回應數目。 有效統計資訊：總和 單位：Count  |  OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName  | 
|  `SuccessCount`  |  對指定 API 端點進行的成功呼叫數。 有效統計資訊：總和 單位：Count  |  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 指標。


| 維度 | Description | 
| --- | --- | 
|  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. 在 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在導覽窗格中，選擇**指標**。

1. **在所有指標索引標籤**上，選擇**位置**命名空間。

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. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。

1. 在導覽窗格中，選擇**警示**。

1. 選擇**建立警示** 。

1. 選擇 **Select metric** (選取指標)。

1. **在所有指標**索引標籤上，選取**位置**命名空間。

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)。

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

您可以使用 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) API 來擷取 Amazon Location 的指標。
+ 例如，您可以監控`CallCount`和設定發生數字下降時的警示。

  監控 的`CallCount`指標`SendDeviceLocation`可協助您了解追蹤資產。如果 `CallCount`下降，這表示追蹤的資產，例如卡車機群，已停止傳送其目前位置。為此設定警示有助於通知您發生了問題。
+ 針對另一個範例，您可以監控`ErrorCount`並設定 的警示，以便在發生數字峰值時發出警示。

  追蹤器必須與地理圍欄集合相關聯，才能針對地理圍欄評估裝置位置。如果您有需要持續位置更新的裝置機群，請參閱 `CallCount` 的 `BatchEvaluateGeofence`或 `BatchPutDevicePosition` 降至零，表示更新不再流動。

以下是 [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"
      }
    }
  ]
}
```