La AWS SDK pour JavaScript v2 est arrivée end-of-support. Nous vous recommandons de migrer vers la [AWS SDK pour JavaScript version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Pour plus de détails et d'informations sur la façon de migrer, veuillez consulter cette [annonce](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).

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.

# Obtenir des métriques auprès d'Amazon CloudWatch
<a name="cloudwatch-examples-getting-metrics"></a>

![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)

**Cet exemple de code Node.js présente :**
+ Comment récupérer une liste de CloudWatch métriques publiées.
+ Comment publier des points de données dans CloudWatch des métriques

## Scénario
<a name="cloudwatch-examples-getting-metrics-scenario"></a>

Les métriques sont des données sur les performances de vos systèmes. Vous pouvez activer la surveillance détaillée de certaines ressources, telles que vos instances Amazon EC2 ou vos propres indicateurs d'application. 

Dans cet exemple, une série de modules Node.js sont utilisés pour obtenir des métriques CloudWatch et envoyer des événements à Amazon CloudWatch Events. Les modules Node.js utilisent le SDK pour JavaScript obtenir des métriques CloudWatch en utilisant les méthodes suivantes de la classe `CloudWatch` client :
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#listMetrics-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#listMetrics-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#putMetricData-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#putMetricData-property)

Pour plus d'informations sur CloudWatch les métriques, consultez la section [Utilisation d'Amazon CloudWatch Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

## Tâches prérequises
<a name="cloudwatch-examples-getting-metrics-prerequisites"></a>

Pour configurer et exécuter cet exemple, vous devez d'abord :
+ Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org).
+ Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md).

## Affichage de la liste des métriques
<a name="cloudwatch-examples-getting-metrics-listing"></a>

Créez un module Node.js nommé `cw_listmetrics.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour y accéder CloudWatch, créez un objet `AWS.CloudWatch` de service. Créez un objet JSON contenant les paramètres requis pour répertorier les métriques dans l'espace de noms `AWS/Logs`. Appelez la méthode `listMetrics` pour répertorier la métrique `IncomingLogEvents`.

```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create CloudWatch service object
var cw = new AWS.CloudWatch({ apiVersion: "2010-08-01" });

var params = {
  Dimensions: [
    {
      Name: "LogGroupName" /* required */,
    },
  ],
  MetricName: "IncomingLogEvents",
  Namespace: "AWS/Logs",
};

cw.listMetrics(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Metrics", JSON.stringify(data.Metrics));
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node cw_listmetrics.js
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_listmetrics.js).

## Envoi de métriques personnalisées
<a name="cloudwatch-examples-getting-metrics-publishing-custom"></a>

Créez un module Node.js nommé `cw_putmetricdata.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour y accéder CloudWatch, créez un objet `AWS.CloudWatch` de service. Créez un objet JSON contenant les paramètres requis afin d'envoyer un point de données pour la métrique personnalisée `PAGES_VISITED`. Appelez la méthode `putMetricData`.

```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create CloudWatch service object
var cw = new AWS.CloudWatch({ apiVersion: "2010-08-01" });

// Create parameters JSON for putMetricData
var params = {
  MetricData: [
    {
      MetricName: "PAGES_VISITED",
      Dimensions: [
        {
          Name: "UNIQUE_PAGES",
          Value: "URLS",
        },
      ],
      Unit: "None",
      Value: 1.0,
    },
  ],
  Namespace: "SITE/TRAFFIC",
};

cw.putMetricData(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", JSON.stringify(data));
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node cw_putmetricdata.js
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_putmetricdata.js).