

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Surveillez avec Amazon CloudWatch
<a name="cloudwatch"></a>

Amazon CloudWatch surveille vos AWS ressources et les applications que vous exécutez AWS en temps quasi réel. Vous pouvez surveiller les ressources Amazon Location à l'aide CloudWatch de ce service qui collecte des données brutes et traite les métriques pour en faire des statistiques pertinentes en temps quasi réel. Vous pouvez consulter des informations historiques sur une période allant jusqu'à 15 mois ou consulter des statistiques de recherche dans la CloudWatch console Amazon pour mieux comprendre les performances de votre application ou service. Vous pouvez également définir des alarmes en définissant des seuils, envoyer des notifications ou prendre des mesures lorsque ces seuils sont atteints. 

 Pour plus d'informations, consultez le [guide de CloudWatch l'utilisateur Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)

**Topics**
+ [Statistiques et dimensions d'Amazon Location Service](#metrics-exported-to-cloudwatch)
+ [Afficher les statistiques d'Amazon Location Service](#view-metrics)
+ [Créez des CloudWatch alarmes pour les métriques d'Amazon Location Service](#create-alarms)
+ [CloudWatch À utiliser pour surveiller l'utilisation par rapport aux quotas](#alarms-on-quotas)
+ [CloudWatch exemples de mesures pour Amazon Location Service](#example-alarms)

## Statistiques et dimensions d'Amazon Location Service
<a name="metrics-exported-to-cloudwatch"></a>

Les métriques sont des points de données ordonnés dans le temps qui sont exportés vers CloudWatch. Une dimension est une name/value paire qui identifie la métrique. Pour plus d'informations, consultez la section [Utilisation CloudWatch des métriques et des CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) [dimensions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) dans le guide de CloudWatch l'utilisateur Amazon.

**Note**  
Le résultat est approximatif en raison de l'architecture distribuée d'Amazon Location Service. Dans la plupart des cas, le nombre doit être proche du nombre réel d'opérations d'API envoyées.

### Statistiques du service de location Amazon
<a name="service-metrics"></a>

Voici les métriques vers lesquelles Amazon Location Service exporte CloudWatch dans l'espace de `AWS/Location` noms.


| Métrique | Description | Dimensions | 
| --- | --- | --- | 
|  `CallCount`  |  Le nombre d'appels effectués vers un point de terminaison d'API donné.  Statistique valide : somme Unités : nombre  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName OperationName, OperationVersion OperationName, OperationVersion, ResourceName ApiKeyName, OperationName, OperationVersion ApiKeyName, OperationName, OperationVersion, ResourceName  | 
|  `ErrorCount`  |  Le nombre de réponses d'erreur suite à des appels effectués vers un point de terminaison d'API donné. Statistique valide : somme Unités : nombre  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 
|  `SuccessCount`  |  Le nombre d'appels réussis effectués vers un point de terminaison d'API donné.  Statistique valide : somme Unités : nombre  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 
|  `CallLatency`  |  Le temps nécessaire à l'opération pour traiter et renvoyer une réponse lorsqu'un appel est effectué vers un point de terminaison d'API donné. Statistique valide : moyenne Unités : millisecondes  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 

### Dimensions d'Amazon Location Service pour les statistiques
<a name="service-dimensions"></a>

Vous pouvez utiliser les dimensions du tableau suivant pour filtrer les métriques d'Amazon Location Service.


| Dimension | Description | 
| --- | --- | 
|  OperationName   |  Filtre les métriques Amazon Location pour le fonctionnement de l'API avec le nom d'opération spécifié.  | 
|  OperationName, ResourceName  |  Filtrez les métriques Amazon Location pour le fonctionnement de l'API avec le nom de l'opération et le nom de la ressource spécifiés.  | 
|  ApiKeyName, OperationName  |  Filtrez les métriques Amazon Location pour le fonctionnement de l'API avec le nom d'opération spécifié et en utilisant le nom de clé d'API donné.  | 
|  ApiKeyName, OperationName, ResourceName  |  Filtrez les métriques Amazon Location pour le fonctionnement de l'API avec le nom de l'opération et le nom de la ressource spécifiés et en utilisant le nom de clé d'API donné.  | 
|  OperationName, OperationVersion  |  Filtre les métriques Amazon Location pour le fonctionnement de l'API avec le nom d'opération spécifié.  Les cartes, lieux et itinéraires autonomes d'Amazon Location Service seront exportés vers cette dimension.   | 
|  OperationName, OperationVersion, ResourceName   |  Filtrez les métriques Amazon Location pour le fonctionnement de l'API avec le nom de l'opération, la version et le nom de ressource Amazon Location spécifiés.  Les cartes, lieux et itinéraires autonomes d'Amazon Location seront des métriques exportées vers cette dimension.   | 
|  ApiKeyName, OperationName, OperationVersion  |  Filtrez les métriques Amazon Location pour le fonctionnement de l'API avec le nom et la version de l'opération spécifiés et en utilisant le nom de clé d'API donné.  Les cartes, lieux et itinéraires autonomes d'Amazon Location seront des métriques exportées vers cette dimension.   | 
|  ApiKeyName, OperationName, OperationVersion, ResourceName   |  Filtrez les métriques Amazon Location pour le fonctionnement de l'API avec le nom de l'opération, la version, le nom de ressource spécifiés et en utilisant le nom de clé d'API donné.  Les cartes, lieux et itinéraires autonomes d'Amazon Location seront des métriques exportées vers cette dimension.   | 

## Afficher les statistiques d'Amazon Location Service
<a name="view-metrics"></a>

Vous pouvez consulter les statistiques d'Amazon Location Service sur la Amazon CloudWatch console ou à l'aide de l' Amazon CloudWatch API.

**Pour afficher les métriques à l'aide de la CloudWatch console**

**Example**  

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le panneau de navigation, sélectionnez ‎**Métriques**.

1. Dans l'**onglet Toutes les mesures**, choisissez l'espace de noms **Location**.

1. Sélectionnez le type de métrique à afficher.

1. Sélectionnez la métrique et ajoutez-la au graphique.
Pour plus d'informations, consultez la section [Afficher les métriques disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) dans le *guide de CloudWatch l'utilisateur Amazon*. 

## Créez des CloudWatch alarmes pour les métriques d'Amazon Location Service
<a name="create-alarms"></a>

Vous pouvez l'utiliser CloudWatch pour définir des alarmes sur vos statistiques Amazon Location Service. Par exemple, vous pouvez créer une alarme CloudWatch pour envoyer un e-mail chaque fois qu'un pic de nombre d'erreurs survient. 

Les rubriques suivantes vous offrent une présentation générale de la configuration des alarmes à l'aide de CloudWatch. Pour obtenir des instructions détaillées, consultez la section [Utilisation des alarmes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) dans le *guide de CloudWatch l'utilisateur Amazon*. 

**Pour définir des alarmes à l'aide de la CloudWatch console**

**Example**  

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le volet de navigation, choisissez **Alarm**.

1. Sélectionnez **Create Alarm (Créer une alerte)**.

1. Choisissez **Sélectionner une métrique**.

1. Dans l'onglet **Toutes les mesures**, sélectionnez l'espace de noms **Location**.

1. Sélectionnez une catégorie de mesures.

1. Recherchez la ligne contenant la métrique pour laquelle vous souhaitez créer une alarme, puis cochez la case à côté de cette ligne.

1. Choisissez **Select metric** (Sélectionner une métrique).

1. Sous **Métrique**, renseignez les valeurs.

1. Spécifiez les **conditions** de l'alarme.

1. Choisissez **Suivant**.

1. Si vous souhaitez envoyer une notification lorsque les conditions d'alarme sont remplies :
   + Sous **Déclencheur d'état** d'alarme, sélectionnez l'état d'alarme pour demander l'envoi d'une notification.
   + Sous **Sélectionnez une rubrique SNS**, choisissez **Create new topic** pour créer une nouvelle rubrique Amazon Simple Notification Service (Amazon SNS). Entrez le nom du sujet et l'adresse e-mail à laquelle envoyer la notification. 
   + Sous **Envoyer une notification**, entrez des adresses e-mail supplémentaires auxquelles envoyer la notification.
   + Sélectionnez **Ajouter une notification**. La liste est enregistrée et s’affiche dans le champ des alarmes futures.

1. Choisissez **Next** une fois que vous avez terminé.

1. Entrez le nom et la description de l'alarme, puis choisissez **Next**.

1. Confirmez les détails de l'alarme, puis choisissez **Next**.

**Note**  
Lorsque vous créez une nouvelle rubrique Amazon SNS, vous devez vérifier l'adresse e-mail avant de pouvoir envoyer une notification. Si l'e-mail n'est pas vérifié, la notification ne sera pas reçue lorsqu'une alarme est déclenchée par un changement d'état.

Pour plus d'informations sur la façon de configurer des alarmes à l'aide de la CloudWatch console, consultez la section [Créer une alarme qui envoie un e-mail](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) dans le *guide de CloudWatch l'utilisateur Amazon*. 

## CloudWatch À utiliser pour surveiller l'utilisation par rapport aux quotas
<a name="alarms-on-quotas"></a>

Vous pouvez créer des CloudWatch alarmes Amazon pour vous avertir lorsque l'utilisation d'un quota donné dépasse un seuil configurable. Cela vous permet de savoir quand vous êtes proche de vos limites de quota, et soit d'adapter votre utilisation pour éviter les dépassements de coûts, soit de demander une augmentation de quota, si nécessaire. 

Pour plus d'informations sur la manière de CloudWatch surveiller les quotas, consultez la section [Visualisation de vos quotas de service et définition des alarmes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html) dans le *guide de l' CloudWatch utilisateur Amazon*.

## CloudWatch exemples de mesures pour Amazon Location Service
<a name="example-alarms"></a>

Vous pouvez utiliser l'[GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)API pour récupérer des statistiques pour Amazon Location. 
+ Par exemple, vous pouvez surveiller `CallCount` et définir une alarme en cas de baisse du nombre de personnes. 

  Le suivi `CallCount` des indicateurs `SendDeviceLocation` peut vous aider à vous faire une idée des actifs suivis. Si le `CallCount` taux baisse, cela signifie que les actifs suivis, tels qu'une flotte de camions, ont cessé d'indiquer leur position actuelle. Le réglage d'une alarme à cet effet peut vous aider à vous avertir qu'un problème est survenu.
+ Par exemple, vous pouvez surveiller `ErrorCount` et définir une alarme en cas de pic de nombre de personnes.

  Les traceurs doivent être associés aux collections de géofences afin que l'emplacement des appareils puisse être évalué par rapport aux géofences. Si vous avez un parc d'appareils qui nécessite des mises à jour de localisation continues, le fait de voir le chiffre « `CallCount` pour » `BatchEvaluateGeofence` ou « `BatchPutDevicePosition` tomber à zéro » indique que les mises à jour ne sont plus diffusées.

Voici un exemple de sortie pour [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)les métriques pour `CallCount` et `ErrorCount` pour la création de ressources cartographiques.

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