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.

# Tutorial: Den Status einer Amazon EC2 EC2-Instance protokollieren mit EventBridge
<a name="eb-log-ec2-instance-state"></a>

Sie können eine [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)-Funktion erstellen, die eine Statusänderung einer [Amazon-EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html)-Instance protokolliert. Anschließend können Sie eine [Regel](eb-rules.md) erstellen, die Ihre Lambda-Funktion ausführt, sobald ein Statusübergang oder ein Übergang zu einem oder mehreren Status stattfindet, die für sie von Interesse sind. In diesem Tutorial protokollieren Sie den Start einer neuen Instance.

**Topics**
+ [Schritt 1: Erstellen Sie eine Funktion AWS Lambda](#eb-ec2-create-lambda-function)
+ [Schritt 2: Erstellen einer Regel](#eb-ec2-create-rule)
+ [Schritt 3: Testen der Regel](#eb-api-test-rule)
+ [Schritt 4: Bestätigen des Erfolgs](#success)
+ [Schritt 5: Bereinigen Ihrer Ressourcen](#cleanup)

## Schritt 1: Erstellen Sie eine Funktion AWS Lambda
<a name="eb-ec2-create-lambda-function"></a>

Erstellen Sie eine Lambda-Funktion, um die [Ereignisse](eb-events.md) bezüglich der Änderung des Status zu protokollieren. Wenn Sie die Regel in Schritt 2 erstellen, geben Sie diese Funktion an.

**So erstellen Sie eine Lambda-Funktion**

1. Öffnen Sie die AWS Lambda Konsole unter [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).

1. Wählen Sie **Funktion erstellen**.

1. Wählen Sie **Von Grund auf neu schreiben** aus.

1. Geben Sie einen Namen und eine Beschreibung für die Lambda-Funktion ein. Geben Sie der Funktion beispielsweise den Namen `LogEC2InstanceStateChange`.

1. Behalten Sie die übrigen Optionen als Standardwerte bei und wählen Sie **Funktion erstellen** aus.

1. Doppelklicken Sie auf der Registerkarte **Code** der Funktionsseite auf **index.js**.

1. Ersetzen Sie den vorhandenen Code mit folgendem Code.

   ```
   'use strict';
   
   exports.handler = (event, context, callback) => {
       console.log('LogEC2InstanceStateChange');
       console.log('Received event:', JSON.stringify(event, null, 2));
       callback(null, 'Finished');
   };
   ```

1. Wählen Sie **Deploy (Bereitstellen)** aus.

## Schritt 2: Erstellen einer Regel
<a name="eb-ec2-create-rule"></a>

Erstellen Sie eine Regel, um die Lambda-Funktion auszuführen, die Sie in Schritt 1 erstellt haben. Die Regel wird ausgeführt, wenn Sie eine Amazon-EC2-Instance starten.

**Um die EventBridge Regel zu erstellen**

1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Wählen Sie im Navigationsbereich **Regeln** aus.

1. Wählen Sie **Regel erstellen** aus.

1. Geben Sie einen Namen und eine Beschreibung für die Regel ein. Nennen Sie die Regel beispielsweise `TestRule`.

1. Wählen Sie für **Event Bus** den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie **Standard** aus. Wenn ein AWS -Service in Ihrem Konto ein Ereignis ausgibt, wird es stets an den Standard-Event-Bus Ihres Kontos weitergeleitet.

1. Bei **Regeltyp** wählen Sie **Regel mit einem Ereignismuster** aus.

1. Wählen Sie **Weiter** aus.

1. Als **Event source** (Ereignisquelle) wählen Sie **AWS -Services** aus.

1. Gehen Sie bei **Event pattern** (Ereignismuster) wie folgt vor:

   1. Wählen Sie für **Ereignisquelle** die Option **EC2** aus der Dropdown-Liste aus.

   1. Wählen Sie für **Ereignistyp** die Option **Benachrichtigung über die Statusänderung der EC2-Instance** aus der Dropdown-Liste aus

   1. Wählen Sie **Spezifische Statusart(en)** und anschließend **Wird ausgeführt** aus der Dropdown-Liste aus.

   1. Wählen Sie **Beliebige Instance** aus.

1. Wählen Sie **Weiter** aus.

1. Bei **Zieltypen** wählen Sie **AWS -Service** aus.

1. Wählen Sie für **Ziel auswählen** die Option **Lambda-Funktion** aus der Dropdown-Liste aus.

1. Wählen Sie für **Funktion** die Lambda-Funktion aus, die Sie im Abschnitt **Schritt 1: Erstellen einer Lambda-Funktion** erstellt haben. Wählen Sie in diesem Beispiel `LogEC2InstanceStateChange` aus.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie **Weiter** aus.

1. Überprüfen Sie die Details der Regel und wählen Sie dann **Regel erstellen** aus.

## Schritt 3: Testen der Regel
<a name="eb-api-test-rule"></a>

Sie können Ihre Regeln testen, indem Sie eine Amazon EC2-Instance mithilfe der Amazon EC2-Konsole anhalten. Warten Sie einige Minuten, bis die Instance beendet ist, und überprüfen Sie dann Ihre AWS Lambda Messwerte auf der CloudWatch Konsole, um sicherzustellen, dass Ihre Funktion ausgeführt wurde.

**Testen der Regel durch Anhalten einer Instance**

1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Starten Sie eine Instance. Weitere Informationen finden Sie unter [Launch Your Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/LaunchingAndUsingInstances.html) im *Amazon EC2 EC2-Benutzerhandbuch*.

1. Halten Sie die Instance an. Weitere Informationen finden Sie unter [Stoppen und Starten Ihrer Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html) im *Amazon EC2 EC2-Benutzerhandbuch*.

1. So zeigen Sie die Ausgabe aus der Lambda-Funktion an:

   1. Öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)

   1. Wählen Sie im Navigationsbereich **Protokolle** aus.

   1. Wählen Sie den Namen der Protokollgruppe für Ihre Lambda-Funktion aus (`/aws/lambda/function-name`).

   1. Wählen Sie den Namen des Protokoll-Streams aus, um die von der Funktion für die von Ihnen angehaltene Instance bereitgestellten Daten anzuzeigen.

1. (Optional) Beenden Sie die angehaltene Instance, wenn Sie fertig sind. Weitere Informationen finden Sie unter [Beenden Ihrer Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html) im *Amazon-EC2-Benutzerhandbuch*.

## Schritt 4: Bestätigen des Erfolgs
<a name="success"></a>

Wenn Sie das Lambda-Ereignis in den CloudWatch Protokollen sehen, haben Sie dieses Tutorial erfolgreich abgeschlossen. Wenn das Ereignis nicht in Ihren CloudWatch Protokollen enthalten ist, beginnen Sie mit der Fehlerbehebung, indem Sie überprüfen, ob die Regel erfolgreich erstellt wurde. Wenn die Regel korrekt aussieht, überprüfen Sie, ob der Code Ihrer Lambda-Funktion korrekt ist.

## Schritt 5: Bereinigen Ihrer Ressourcen
<a name="cleanup"></a>

Sie können jetzt die Ressourcen, die Sie für dieses Tutorial erstellt haben, löschen, es sei denn, Sie möchten sie behalten. Indem Sie AWS Ressourcen löschen, die Sie nicht mehr verwenden, verhindern Sie, dass Ihr AWS Konto unnötig belastet wird.

**Um die EventBridge Regel (n) zu löschen**

1. Öffnen Sie die [Seite Regeln](https://console.aws.amazon.com/events/home#/rules) der EventBridge Konsole.

1. Wählen Sie die Regel(n) aus, die Sie erstellt haben.

1. Wählen Sie **Löschen** aus.

1. Wählen Sie **Löschen** aus.

**So löschen Sie die Lambda-Funktion(en)**

1. Öffnen Sie die Seite [Funktionen](https://console.aws.amazon.com/lambda/home#/functions) der Lambda-Konsole.

1. Wählen Sie die Funktion(en) aus, die Sie erstellt haben.

1. Wählen Sie **Aktionen**, **Löschen** aus.

1. Wählen Sie **Löschen** aus.