As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Monitore com a Amazon CloudWatch
<a name="cloudwatch"></a>

A Amazon CloudWatch monitora seus AWS recursos e os aplicativos nos quais você executa quase AWS em tempo real. Você pode monitorar os recursos de localização da Amazon usando CloudWatch, que coleta dados brutos e processa métricas em estatísticas significativas quase em tempo real. Você pode visualizar informações históricas de até 15 meses ou pesquisar métricas para visualizar no CloudWatch console da Amazon para obter mais perspectivas sobre o desempenho de seu aplicativo ou serviço. Você também pode definir alarmes ao determinar limites e enviar notificações ou realizar ações quando esses limites são atingidos. 

 Para obter mais informações, consulte o [Guia CloudWatch do usuário da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)

**Topics**
+ [Métricas e dimensões do Amazon Location Service](#metrics-exported-to-cloudwatch)
+ [Ver indicadores do Amazon Location Service](#view-metrics)
+ [Crie CloudWatch alarmes para as métricas do Amazon Location Service](#create-alarms)
+ [Use CloudWatch para monitorar o uso em relação às cotas](#alarms-on-quotas)
+ [CloudWatch exemplos de métricas para Amazon Location Service](#example-alarms)

## Métricas e dimensões do Amazon Location Service
<a name="metrics-exported-to-cloudwatch"></a>

As métricas são pontos de dados ordenados por tempo que são exportados para o. CloudWatch Uma dimensão é um name/value par que identifica a métrica. Para obter mais informações, consulte [Uso de CloudWatch métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) e [CloudWatch dimensões](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) no Guia CloudWatch do usuário da Amazon.

**nota**  
O resultado é aproximado por causa da arquitetura distribuída do Amazon Location Service. Na maioria dos casos, a contagem deve ser próxima da quantidade real de operações de API enviadas.

### Métricas do Amazon Location Service
<a name="service-metrics"></a>

A seguir estão as métricas para as quais o Amazon Location Service exporta CloudWatch no `AWS/Location` namespace.


| Métrica | Description | Dimensões | 
| --- | --- | --- | 
|  `CallCount`  |  O número de chamadas feitas para um determinado endpoint da API.  Estatística válida: soma Unidades: contagem  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName OperationName, OperationVersion OperationName, OperationVersion, ResourceName ApiKeyName, OperationName, OperationVersion ApiKeyName, OperationName, OperationVersion, ResourceName  | 
|  `ErrorCount`  |  O número de respostas de erro de chamadas feitas para um determinado endpoint de API. Estatística válida: soma Unidades: contagem  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 
|  `SuccessCount`  |  O número de chamadas bem-sucedidas feitas para um determinado endpoint da API.  Estatística válida: soma Unidades: contagem  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 
|  `CallLatency`  |  A quantidade de tempo que a operação leva para processar e retornar uma resposta quando uma chamada é feita para um determinado endpoint da API. Estatística válida: média Unidade: milissegundos  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 

### Dimensões para métricas do Amazon Location Service
<a name="service-dimensions"></a>

Você pode usar as dimensões na tabela a seguir para filtrar métricas do Amazon Location Service.


| Dimensão | Description | 
| --- | --- | 
|  OperationName   |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado.  | 
|  OperationName, ResourceName  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado e o nome do recurso.  | 
|  ApiKeyName, OperationName  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado, usando o nome da chave de API determinado.  | 
|  ApiKeyName, OperationName, ResourceName  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado, o nome do recurso e usando o nome da chave de API determinado.  | 
|  OperationName, OperationVersion  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado.  Mapas, lugares e rotas independentes do Amazon Location Service serão métricas de exportação para essa dimensão.   | 
|  OperationName, OperationVersion, ResourceName   |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado, a versão e o nome do recurso do Amazon Location.  Mapas, lugares e rotas independentes do Amazon Location serão métricas de exportação para essa dimensão.   | 
|  ApiKeyName, OperationName, OperationVersion  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação, a versão e usando o nome da chave de API determinado.  Mapas, lugares e rotas independentes do Amazon Location serão métricas de exportação para essa dimensão.   | 
|  ApiKeyName, OperationName, OperationVersion, ResourceName   |  Filtra as métricas do Amazon Location para operação de API com o nome da operação, a versão, o nome do recurso e usando o nome da chave de API determinado.  Mapas, lugares e rotas independentes do Amazon Location serão métricas de exportação para essa dimensão.   | 

## Ver indicadores do Amazon Location Service
<a name="view-metrics"></a>

Você pode visualizar as métricas do Amazon Location Service no Amazon CloudWatch console ou usando a Amazon CloudWatch API.

**Para visualizar métricas usando o CloudWatch console**

**Example**  

1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, selecione **Métricas**.

1. Na **guia Todos os Indicadores**, escolha o namespace **Location**.

1. Selecione o tipo de indicador que você deseja visualizar.

1. Selecione um indicador para adicioná-lo ao gráfico.
Para obter mais informações, consulte [Exibir métricas disponíveis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) no *Guia CloudWatch do usuário da Amazon*. 

## Crie CloudWatch alarmes para as métricas do Amazon Location Service
<a name="create-alarms"></a>

Você pode usar CloudWatch para definir alarmes em suas métricas do Amazon Location Service. Por exemplo, você pode criar um alarme CloudWatch para enviar um e-mail sempre que ocorrer um pico na contagem de erros. 

Os tópicos a seguir fornecem uma visão geral de alto nível sobre como definir alarmes usando o CloudWatch. Para obter instruções detalhadas, consulte Como [usar alarmes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) no *Guia do CloudWatch usuário da Amazon*. 

**Para definir alarmes usando o console CloudWatch **

**Example**  

1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, selecione **Alarme**.

1. Escolha **Criar Alarm**.

1. Escolha **Selecionar métrica**.

1. Na guia **Todos os indicadores**, selecione o namespace **Location**.

1. Selecione uma categoria de indicador.

1. Encontre a linha com o indicador para o qual você deseja criar um alarme e marque a caixa de seleção ao lado dessa linha.

1. Escolha **Selecionar métrica**.

1. Em **Indicador**, preencha os valores.

1. Especifique as **Condições** do alarme.

1. Escolha **Próximo**.

1. Se você quiser enviar uma notificação quando as condições do alarme forem atendidas:
   + Em **Acionador do estado do alarme**, selecione o estado do alarme para solicitar o envio de uma notificação.
   + Em **Selecione um tópico do SNS**, escolha **Criar novo tópico** para criar um novo tópico do Amazon Simple Notification Service (Amazon SNS). Insira o nome do tópico e o e-mail para o qual enviar a notificação. 
   + Em **Enviar uma notificação para** inserir endereços de e-mail adicionais para os quais enviar a notificação.
   + Escolha **Adicionar notificação**. Essa lista é salva e aparece no campo para alarmes futuros.

1. Ao concluir, escolha **Next (Avançar)**.

1. Insira um nome e uma descrição para o alarme e selecione **Avançar**.

1. Confirme os detalhes do alarme e escolha **Avançar**.

**nota**  
Se você criar um novo tópico do Amazon SNS, o endereço de e-mail deverá ser verificado para que recebam notificações. Se o e-mail não for verificado, a notificação não será recebida quando um alarme for iniciado por uma mudança de estado.

Para obter mais informações sobre como definir alarmes usando o CloudWatch console, consulte [Criar um alarme que envia e-mail](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) no *Guia do CloudWatch usuário da Amazon*. 

## Use CloudWatch para monitorar o uso em relação às cotas
<a name="alarms-on-quotas"></a>

Você pode criar CloudWatch alarmes da Amazon para notificá-lo quando a utilização de uma determinada cota exceder um limite configurável. Isso permite que você reconheça quando está próximo dos limites de cota e adapte sua utilização para evitar custos excessivos ou solicite um aumento de cota, se necessário. 

*Para obter informações sobre como usar CloudWatch para monitorar cotas, consulte [Visualizando suas cotas de serviço e definindo alarmes no Guia do usuário](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html) da Amazon. CloudWatch *

## CloudWatch exemplos de métricas para Amazon Location Service
<a name="example-alarms"></a>

Você pode usar a [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)API para recuperar métricas para Amazon Location. 
+ Por exemplo, você pode monitorar `CallCount` e definir um alarme para quando ocorrer uma queda no número. 

  O monitoramento dos indicadores `CallCount` para `SendDeviceLocation` pode ajudar a dar uma perspectiva sobre os ativos rastreados. Se a `CallCount` cair, significa que os ativos rastreados, como uma frota de caminhões, pararam de enviar suas localizações atuais. Configurar um alarme para isso pode ajudar a notificá-lo de que um problema ocorreu.
+ Em outro exemplo, você pode monitorar `ErrorCount` e definir um alarme para quando ocorrer um aumento no número.

  Os rastreadores devem estar associados a coleções de geocercas para que as localizações dos dispositivos sejam avaliadas em relação às geocercas. Se você tem uma frota de dispositivos que exige atualizações contínuas de localização, ver o valor `CallCount` para `BatchEvaluateGeofence` ou `BatchPutDevicePosition` cair para zero indica que as atualizações não estão mais fluindo.

A seguir está um exemplo de saída [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)com as métricas para `CallCount` e `ErrorCount` para a criação de recursos de mapa.

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