

La AWS SDK per JavaScript v2 è arrivata. end-of-support [Ti consigliamo di migrare alla AWS SDK per JavaScript v3.](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) [Per ulteriori dettagli e informazioni su come effettuare la migrazione, consulta questo annuncio.](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di allarmi in Amazon CloudWatch
<a name="cloudwatch-examples-creating-alarms"></a>

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

**Questo esempio di codice di Node.js illustra:**
+ Come recuperare le informazioni di base sui tuoi CloudWatch allarmi.
+ Come creare ed eliminare un CloudWatch allarme.

## Lo scenario
<a name="cloudwatch-examples-creating-alarms-scenario"></a>

Un allarme controlla un singolo parametro in un periodo di tempo specificato ed esegue una o più operazioni in base al valore del parametro relativo a una determinata soglia in una serie di periodi di tempo.

In questo esempio, una serie di moduli Node.js vengono utilizzati per creare allarmi in CloudWatch. I moduli Node.js utilizzano l'SDK per JavaScript creare allarmi utilizzando questi metodi della classe `AWS.CloudWatch` client:
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#describeAlarms-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#describeAlarms-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#putMetricAlarm-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#putMetricAlarm-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#deleteAlarms-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatch.html#deleteAlarms-property)

Per ulteriori informazioni sugli CloudWatch allarmi, consulta [Creating Amazon CloudWatch Alarms](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) nella *Amazon CloudWatch User* Guide.

## Attività prerequisite
<a name="cloudwatch-examples-creating-alarms-prerequisites"></a>

Per configurare ed eseguire questo esempio, è necessario completare queste attività:
+ Installa Node.js. Per ulteriori informazioni sull'installazione di Node.js, consulta il [sito Web Node.js](https://nodejs.org).
+ Creazione di un file di configurazione condiviso con le credenziali utente. Per ulteriori informazioni sulla fornitura di un file delle credenziali condiviso, consulta [Caricamento delle credenziali su Node.js dal file delle credenziali condiviso](loading-node-credentials-shared.md).

## Descrivere gli allarmi
<a name="cloudwatch-examples-creating-alarms-describing"></a>

Crea un modulo Node.js con il nome del file `cw_describealarms.js`. Assicurati di configurare il kit SDK come mostrato in precedenza. Per accedere CloudWatch, crea un oggetto di `AWS.CloudWatch` servizio. Crea un oggetto JSON per contenere i parametri per il recupero delle descrizioni dell'allarme, limitando gli allarmi restituiti a quelli con stato `INSUFFICIENT_DATA`. Quindi, chiama il metodo `describeAlarms` dell'oggetto di servizio `AWS.CloudWatch`.

```
// 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" });

cw.describeAlarms({ StateValue: "INSUFFICIENT_DATA" }, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    // List the names of all current alarms in the console
    data.MetricAlarms.forEach(function (item, index, array) {
      console.log(item.AlarmName);
    });
  }
});
```

Digita la seguente riga di comando per eseguire l'esempio.

```
node cw_describealarms.js
```

Questo codice di esempio può essere trovato [qui GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_describealarms.js).

## Creazione di un allarme per una CloudWatch metrica
<a name="cloudwatch-examples-creating-alarms-putmetricalarm"></a>

Crea un modulo Node.js con il nome del file `cw_putmetricalarm.js`. Assicurati di configurare il kit SDK come mostrato in precedenza. Per accedere CloudWatch, crea un oggetto `AWS.CloudWatch` di servizio. Crea un oggetto JSON per i parametri necessari per creare un allarme basato su una metrica, in questo caso l'utilizzo della CPU di un'istanza Amazon EC2. I parametri rimanenti sono impostati per attivare l'allarme quando il parametro supera una soglia del 70 percento. Quindi, chiama il metodo `describeAlarms` dell'oggetto di servizio `AWS.CloudWatch`.

```
// 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 = {
  AlarmName: "Web_Server_CPU_Utilization",
  ComparisonOperator: "GreaterThanThreshold",
  EvaluationPeriods: 1,
  MetricName: "CPUUtilization",
  Namespace: "AWS/EC2",
  Period: 60,
  Statistic: "Average",
  Threshold: 70.0,
  ActionsEnabled: false,
  AlarmDescription: "Alarm when server CPU exceeds 70%",
  Dimensions: [
    {
      Name: "InstanceId",
      Value: "INSTANCE_ID",
    },
  ],
  Unit: "Percent",
};

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

Digita la seguente riga di comando per eseguire l'esempio.

```
node cw_putmetricalarm.js
```

[Questo codice di esempio può essere trovato qui. GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_putmetricalarm.js)

## Eliminare un allarme
<a name="cloudwatch-examples-creating-alarms-deleting"></a>

Crea un modulo Node.js con il nome del file `cw_deletealarms.js`. Assicurati di configurare il kit SDK come mostrato in precedenza. Per accedere CloudWatch, crea un oggetto `AWS.CloudWatch` di servizio. Crea un oggetto JSON che contiene i nomi degli allarmi da eliminare. Quindi, chiama il metodo `deleteAlarms` dell'oggetto di servizio `AWS.CloudWatch`.

```
// 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 = {
  AlarmNames: ["Web_Server_CPU_Utilization"],
};

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

Digita la seguente riga di comando per eseguire l'esempio.

```
node cw_deletealarms.js
```

Questo codice di esempio può essere trovato [qui GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_deletealarms.js).