Die AWS SDK für JavaScript Version 2 ist erreicht end-of-support. Wir empfehlen Ihnen, auf [AWS SDK für JavaScript Version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/) zu migrieren. Weitere Einzelheiten und Informationen zur Migration finden Sie in dieser [Ankündigung](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Alarme in Amazon erstellen CloudWatch
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/de_de/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**Dieses Node.js-Codebeispiel zeigt:**
+ So rufen Sie grundlegende Informationen zu Ihren CloudWatch Alarmen ab.
+ So erstellen und löschen Sie einen CloudWatch Alarm.
## Das Szenario
Ein Alarm überwacht eine Metrik über einen bestimmten, von Ihnen definierten Zeitraum und führt eine oder mehrere Aktionen durch, die vom Wert der Metrik im Vergleich zu einem festgelegten Schwellenwert in einer Reihe von Zeiträumen abhängt.
In diesem Beispiel werden eine Reihe von Node.js-Modulen verwendet, um Alarme in CloudWatch zu erstellen. Die Module von Node.js verwenden das SDK JavaScript , um Alarme mithilfe der folgenden Methoden der `AWS.CloudWatch` Client-Klasse zu erstellen:
+ [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)
Weitere Informationen zu CloudWatch Alarmen finden Sie unter [ CloudWatch Amazon-Alarme erstellen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) im * CloudWatch Amazon-Benutzerhandbuch*.
## Erforderliche Aufgaben
Zum Einrichten und Ausführen dieses Beispiels müssen Sie zunächst diese Aufgaben abschließen:
+ Installieren Sie Node.js. Weitere Informationen über die Installation von Node.js finden Sie auf der [Node.js-Website](https://nodejs.org).
+ Erstellen Sie eine freigegebene Konfigurationsdatei mit Ihren Anmeldeinformationen. Weitere Informationen zum Bereitstellen einer Datei mit gemeinsam genutzten Anmeldeinformationen finden Sie unter [Laden der Anmeldeinformationen in Node.js aus der freigegebenen Anmeldeinformationsdatei](loading-node-credentials-shared.md).
## Beschreiben von Alarmen
Erstellen Sie ein Node.js-Modul mit dem Dateinamen `cw_describealarms.js`. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt, konfigurieren. Um darauf zuzugreifen CloudWatch, erstellen Sie ein `AWS.CloudWatch` Serviceobjekt. Erstellen Sie ein JSON-Objekt, um die Parameter für das Abrufen von Alarmbeschreibungen zu speichern und begrenzen Sie dabei die zurückgegebenen Alarme auf diejenigen mit Status `INSUFFICIENT_DATA`. Rufen Sie dann die `describeAlarms`-Methode des `AWS.CloudWatch`-Serviceobjekts auf.
```
// 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);
});
}
});
```
Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein.
```
node cw_describealarms.js
```
Diesen Beispielcode finden Sie [hier auf GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_describealarms.js).
## Einen Alarm für eine CloudWatch Metrik erstellen
Erstellen Sie ein Node.js-Modul mit dem Dateinamen `cw_putmetricalarm.js`. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt, konfigurieren. Um darauf zuzugreifen CloudWatch, erstellen Sie ein `AWS.CloudWatch` Serviceobjekt. Erstellen Sie ein JSON-Objekt für die Parameter, die zum Erstellen eines Alarms auf der Grundlage einer Metrik erforderlich sind, in diesem Fall der CPU-Auslastung einer Amazon EC2 EC2-Instance. Die restlichen Parameter werden so festgelegt, dass der Alarm ausgelöst wird, wenn die Metrik einen Grenzwert von 70 Prozent überschreitet. Rufen Sie dann die `describeAlarms`-Methode des `AWS.CloudWatch`-Serviceobjekts auf.
```
// 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);
}
});
```
Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein.
```
node cw_putmetricalarm.js
```
Diesen Beispielcode finden Sie [hier auf GitHub.](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_putmetricalarm.js)
## Löschen eines Alarms
Erstellen Sie ein Node.js-Modul mit dem Dateinamen `cw_deletealarms.js`. Stellen Sie sicher, dass Sie das SDK, wie zuvor dargestellt, konfigurieren. Um darauf zuzugreifen CloudWatch, erstellen Sie ein `AWS.CloudWatch` Serviceobjekt. Erstellen Sie ein JSON-Objekt, um die Namen der Alarme zu speichern, die Sie löschen möchten. Rufen Sie dann die `deleteAlarms`-Methode des `AWS.CloudWatch`-Serviceobjekts auf.
```
// 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);
}
});
```
Um das Beispiel auszuführen, geben Sie Folgendes in der Befehlszeile ein.
```
node cw_deletealarms.js
```
Diesen Beispielcode finden Sie [hier auf GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/cloudwatch/cw_deletealarms.js).