

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.

# Erstellen einer Regel, die bei einem Amazon RDS-Ereignis ausgelöst wird
<a name="rds-cloud-watch-events"></a>

Mit Amazon EventBridge können Sie AWS Services automatisieren und auf Systemereignisse wie Probleme mit der Anwendungsverfügbarkeit oder Ressourcenänderungen reagieren. 

**Topics**
+ [Regeln zum Senden von Amazon RDS-Ereignissen an Amazon erstellen EventBridge](#rds-cloudwatch-events.sending-to-cloudwatch-events)
+ [Tutorial: Statusänderungen der DB-Instance mithilfe von Amazon protokollieren EventBridge](#log-rds-instance-state)

## Regeln zum Senden von Amazon RDS-Ereignissen an Amazon erstellen EventBridge
<a name="rds-cloudwatch-events.sending-to-cloudwatch-events"></a>

Sie können einfache Regeln schreiben, um anzugeben, welche Amazon-RDS-Ereignisse Sie interessieren und welche automatisierten Aktionen zu ergreifen sind, wenn ein Ereignis mit einer Regel übereinstimmt. Sie können eine Vielzahl von Zielen festlegen, z. B. eine AWS Lambda Funktion oder ein Amazon SNS SNS-Thema, die Ereignisse im JSON-Format empfangen. Sie können Amazon RDS Amazon beispielsweise so konfigurieren, dass Ereignisse an Amazon gesendet werden, EventBridge wenn eine DB-Instance erstellt oder gelöscht wird. Weitere Informationen finden Sie im [Amazon CloudWatch Events-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/) und im [ EventBridge Amazon-Benutzerhandbuch](https://docs.aws.amazon.com/eventbridge/latest/userguide/).

**So erstellen Sie eine Regel, die bei einem Ereignis ausgelöst wird:**

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 unter **Events (Ereignisse)** die Option **Rules (Regeln)** aus.

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

1. Führen Sie für **Ereignisquelle** folgende Schritte aus:

   1. Wählen Sie **Event Pattern** aus.

   1. Wählen Sie für **Service Name (Servicename)** die Option **Relational Database Service (RDS)** aus.

   1. Wählen Sie unter **Event Type** (Ereignistyp) den Amazon-RDS-Ressourcentyp aus, der das Ereignis auslöst. Wenn beispielsweise eine DB-Instance das Ereignis auslöst, wählen Sie **RDS DB Instance Event** (RDS-DB-Instance-Ereignis) aus.

1. Wählen Sie für **Ziele** die Option **Ziel hinzufügen** und wählen Sie den AWS Dienst aus, der reagieren soll, wenn ein Ereignis des ausgewählten Typs erkannt wird. 

1. Geben Sie in die anderen Felder in diesem Abschnitt Informationen ein, die für diesen Zieltyp spezifisch sind, sofern vorhanden. 

1. Für viele Zieltypen sind EventBridge Berechtigungen erforderlich, um Ereignisse an das Ziel zu senden. In diesen Fällen EventBridge kann die IAM-Rolle erstellt werden, die für die Ausführung Ihrer Veranstaltung erforderlich ist: 
   + Um automatisch eine IAM-Rolle zu erstellen, wählen Sie **Eine neue Rolle für diese spezifische Ressource erstellen** aus.
   + Wenn Sie eine zuvor erstellte IAM-Rolle verwenden möchten, wählen Sie **Use existing role (Vorhandene Rolle verwenden)**.

1. Optional können Sie die Schritte 5 bis 7 wiederholen, um ein weiteres Ziel für diese Regel hinzuzufügen.

1. Wählen Sie **Configure details**. Geben Sie für **Rule definition** einen Namen und eine Beschreibung für die Regel ein.

   Der Regelname muss innerhalb dieser Region eindeutig sein.

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

Weitere Informationen finden Sie unter [Erstellen einer EventBridge Regel, die bei einem Ereignis ausgelöst](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/Create-CloudWatch-Events-Rule.html) wird im * CloudWatch Amazon-Benutzerhandbuch*.

## Tutorial: Statusänderungen der DB-Instance mithilfe von Amazon protokollieren EventBridge
<a name="log-rds-instance-state"></a>

In diesem Tutorial erstellen Sie eine AWS Lambda Funktion, die die Statusänderungen für eine Amazon RDS-Instance protokolliert. Anschließend erstellen Sie eine Regel, die die Funktion ausführt, sobald eine Statusänderung einer vorhandenen RDS-DB-Instance stattfindet. Das Tutorial geht davon aus, dass Sie eine kleine laufende Test-Instance haben, die Sie vorübergehend herunterfahren können.

**Wichtig**  
Führen Sie dieses Tutorial nicht für eine laufende Produktions-DB-Instance durch.

**Topics**
+ [Schritt 1: Erstellen Sie eine AWS Lambda Funktion](#rds-create-lambda-function)
+ [Schritt 2: Erstellen einer Regel](#rds-create-rule)
+ [Schritt 3: Testen der Regel](#rds-test-rule)

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

Erstellen Sie eine Lambda-Funktion, um die Statusänderungsereignisse zu protokollieren. Sie geben diese Funktion beim Erstellen der Regel 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. Wenn Sie noch nicht mit Lambda gearbeitet haben, wird Ihnen eine Willkommensseite angezeigt. Wählen Sie **Get Started Now**. Andernfalls, wählen Sie **Create function (Funktion erstellen)** aus.

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

1. Gehen Sie auf der Seite **Create function (Funktion erstellen)** wie folgt vor:

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

   1. Wählen Sie in **Runtime** **Node.js 16x** aus. 

   1. Wählen Sie für **Architecture** (Architektur) **x86\$164** aus.

   1. Führen Sie für **Execution role** (Ausführungsrolle) einen der folgenden Schritte aus:
      + Wählen Sie **Create a new role with basic Lambda permissions (Eine neue Rolle mit den grundlegenden Lambda-Berechtigungen erstellen)** aus.
      + Wählen Sie für **Execution role** (Ausführungsrolle) die Option **Use an existing role** (Vorhandene Rolle verwenden) aus. Wählen Sie die Rolle aus. 

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

1. Auf der**RDSInstanceStateChange**-Seite, machen Sie das Folgende:

   1. In **Code-Quelle** wählen Sie **index.js**. 

   1. Im Ausschnitt **index.js** löschen Sie den vorhandenen Code.

   1. Geben Sie den folgenden Code ein:

      ```
      console.log('Loading function');
      
      exports.handler = async (event, context) => {
          console.log('Received event:', JSON.stringify(event));
      };
      ```

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

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

Erstellen Sie eine Regel, damit die Lambda-Funktion ausgeführt wird, wenn Sie eine Amazon-RDS-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. Geben Sie z. B. ei **RDSInstanceStateChangeRule**.

1. Wählen Sie **Rule with an event pattern** 8Regel mit einem Ereignismuster) und dann **Next** (Weiter) aus.

1. Wählen Sie als **Eventquelle AWS ** **Events oder EventBridge Partnerevents** aus.

1. Scrollen Sie nach unten zum Abschnitt **Event pattern** (Ereignismuster).

1. Wählen Sie für **Ereignisquelle** die Option **AWS-Services** aus.

1. Wählen Sie für **AWS -Service** die Option **Relational Database Service (RDS)** aus.

1. Für **Ereignistyp** wählen Sie **RDS DB-Instance-Ereignis**.

1. Übernehmen Sie das Standard-Ereignismuster. Klicken Sie anschließend auf **Weiter**.

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

1. Für **Select a target** (Ein Ziel auswählen), wählen die Option **Lambda function** (Lambda-Funktion) aus.

1. Wählen Sie für **Function** (Funktion) die Lambda-Funktion aus, die Sie erstellt haben. Klicken Sie anschließend auf **Weiter**.

1. Wählen Sie in **Configure tags** (Tags konfigurieren) **Next** (Weiter) aus.

1. Überprüfen Sie die Schritte in Ihrer Regel. Wählen Sie dann **Create rule** (Regel erstellen) aus.

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

Um Ihre Regel zu testen, fahren Sie eine RDS-DB-Instance herunter. Warten Sie einige Minuten, bis die Instance heruntergefahren wurde, und prüfen Sie dann, ob Ihre Lambda-Funktion aufgerufen wurde.

**Testen der Regel durch Anhalten einer DB-Instance**

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

1. Stopp einer RDS-DB-Instance.

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 **Rules (Regeln)**, den Namen der von Ihnen erstellten Regel aus.

1. Wählen Sie unter **Regeldetails** die Option **Überwachung** aus.

   Sie werden zur CloudWatch Amazon-Konsole weitergeleitet. Wenn Sie nicht weitergeleitet werden, klicken Sie auf **Metriken anzeigen in CloudWatch**.

1. In **Alle Metriken** wählen Sie den Namen der Regel aus, die Sie erstellt haben.

   Das Diagramm sollte darauf hinweisen, dass die Regel aufgerufen wurde.

1. Wählen Sie im Navigationsbereich **Log groups (Protokollgruppen)** aus.

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

1. Wählen Sie den Namen des Protokoll-Streams aus, um die von der Funktion für die von Ihnen gestartete Instance bereitgestellten Daten anzuzeigen. Das empfangene Ergebnis sollte in etwa wie folgt aussehen:

   ```
   {
       "version": "0",
       "id": "12a345b6-78c9-01d2-34e5-123f4ghi5j6k",
       "detail-type": "RDS DB Instance Event",
       "source": "aws.rds",
       "account": "111111111111",
       "time": "2021-03-19T19:34:09Z",
       "region": "us-east-1",
       "resources": [
           "arn:aws:rds:us-east-1:111111111111:db:testdb"
       ],
       "detail": {
           "EventCategories": [
               "notification"
           ],
           "SourceType": "DB_INSTANCE",
           "SourceArn": "arn:aws:rds:us-east-1:111111111111:db:testdb",
           "Date": "2021-03-19T19:34:09.293Z",
           "Message": "DB instance stopped",
           "SourceIdentifier": "testdb",
           "EventID": "RDS-EVENT-0087"
       }
   }
   ```

   Weitere Beispiele für RDS-Ereignisse im JSON-Format finden Sie unter [Überblick über Ereignisse für Amazon RDS](working-with-events.md#rds-cloudwatch-events.sample).

1. (Optional) Zum Abschluss können Sie die Amazon-RDS-Konsole öffnen und die von Ihnen gestoppte Instance starten.