Anunciamos el próximo fin del soporte para AWS SDK para JavaScript v2. Se recomienda que migre a AWS SDK para JavaScript v3. Para ver las fechas, los detalles adicionales y la información sobre cómo realizar la migración, consulte el anuncio enlazado.

Obtención de métricas de Amazon CloudWatch

Este ejemplo de código de Node.js muestra:

El escenario

Las métricas son los datos sobre el desempeño de los sistemas. Puede habilitar la supervisión detallada de algunos recursos, como las instancias de Amazon EC2, o de sus propias métricas de aplicación.

En este ejemplo se van a utilizar una serie de módulos de Node.js para obtener métricas de CloudWatch y para enviar eventos a Amazon CloudWatch Events. Los módulos de Node.js usan el SDK para JavaScript para obtener métricas de CloudWatch mediante los métodos de la clase de cliente CloudWatch siguiente:

Para obtener más información sobre las métricas de CloudWatch, consulte Uso de métricas de Amazon CloudWatch en la Guía del usuario de Amazon CloudWatch.

Tareas previas necesarias

Para configurar y ejecutar este ejemplo, primero debe completar estas tareas:

Mostrar métricas

Cree un módulo de Node.js con el nombre de archivo cw_listmetrics.js. Asegúrese de configurar el SDK tal y como se ha indicado anteriormente. Para obtener acceso a CloudWatch, cree un objeto de servicio de AWS.CloudWatch. Cree un objeto JSON que contenga los parámetros necesarios para generar métricas en el espacio de nombres AWS/Logs. Llame al método listMetrics para obtener una lista de la métrica 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));
  }
});

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node cw_listmetrics.js

Este código de ejemplo se puede encontrar aquí en GitHub.

Envío de métricas personalizadas

Cree un módulo de Node.js con el nombre de archivo cw_putmetricdata.js. Asegúrese de configurar el SDK tal y como se ha indicado anteriormente. Para obtener acceso a CloudWatch, cree un objeto de servicio de AWS.CloudWatch. Cree un objeto JSON que contenga los parámetros necesarios para enviar un punto de datos para la métrica personalizada PAGES_VISITED. Llame al método 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));
  }
});

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node cw_putmetricdata.js

Este código de ejemplo se puede encontrar aquí en GitHub.