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: Ereignisse Datadog von Amazon an senden EventBridge
<a name="eb-tutorial-datadog"></a>

Sie können EventBridge es verwenden, um [Ereignisse](eb-events.md) an Dienste von Drittanbietern weiterzuleiten, z. [https://www.datadoghq.com/](https://www.datadoghq.com/)

In diesem Tutorial verwenden Sie die EventBridge Konsole, um eine Verbindung zuDatadog, ein [API-Ziel](eb-api-destinations.md), auf das verwiesen wirdDatadog, und eine [Regel zum Weiterleiten](eb-rules.md) von Ereignissen herzustellenDatadog. 

**Topics**
+ [Voraussetzungen](#eb-dd-prereqs)
+ [Schritt 1: Erstellen einer Verbindung](#eb-dd-create-connection)
+ [Schritt 2: Erstellen eines API-Ziels](#eb-dd-api-destination)
+ [Schritt 3: Erstellen einer Regel](#eb-dd-create-rule)
+ [Schritt 4: Testen der Regel](#eb-dd-test-rule)
+ [Schritt 5: Bereinigen Ihrer Ressourcen](#cleanup)

## Voraussetzungen
<a name="eb-dd-prereqs"></a>

Zum Durcharbeiten dieses Tutorials benötigen Sie die folgenden Ressourcen:
+ Ein [Datadog-Konto](https://www.datadoghq.com/free-datadog-trial/)
+ Einen [Datadog-API-Schlüssel](https://docs.datadoghq.com/account_management/api-app-keys/)
+ Ein EventBridge -fähiger [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) -Bucket.

## Schritt 1: Erstellen einer Verbindung
<a name="eb-dd-create-connection"></a>

Zum Senden von Ereignissen an Datadog müssen Sie zunächst eine Verbindung zur Datadog-API herstellen.

**So erstellen Sie die Verbindung**

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 **API-Ziele** aus.

1. Wählen Sie die Registerkarte **Verbindungen** und dann **Verbindung erstellen** aus.

1. Geben Sie einen Namen und eine Beschreibung für die Verbindung ein. Geben Sie beispielsweise **Datadog** als Name und **Datadog API Connection** als Beschreibung ein.

1. Wählen Sie für **Autorisierungstyp** die Option **API Key** aus.

1. Geben Sie für **API-Schlüsselname** **DD-API-KEY** ein.

1. Fügen Sie für **Wert** Ihren geheimen Datadog-API-Schlüssel ein.

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

## Schritt 2: Erstellen eines API-Ziels
<a name="eb-dd-api-destination"></a>

Nachdem Sie die Verbindung erstellt haben, erstellen Sie als Nächstes das API-Ziel, das als [Ziel](eb-targets.md) der Regel verwendet werden soll.

**So erstellen Sie das API-Ziel**

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 **API-Ziele** aus.

1. Wählen Sie **API-Ziel erstellen** aus.

1. Geben Sie einen Namen und eine Beschreibung für das API-Ziel ein. Geben Sie beispielsweise **DatadogAD** für den Namen und **Datadog API Destination** für die Beschreibung ein.

1. Geben Sie als **API-Zielendpunkt** den Datadog Logs-Endpunkt ein:**https://http-intake.logs.datadoghq.com/api/v2/logs**.
**Anmerkung**  
In diesem Tutorial werden Ereignisse an Datadog Logs übermittelt. Sie können Ereignisse auch Datadog über den Ereignisendpunkt bereitstellen:`https://api.datadoghq.com/api/v1/events`.

1. Wählen Sie in **HTTP method** **POST**.

1. Geben Sie für **Begrenzung der Aufrufrate** **300** ein.

1. Wählen Sie für **Verbindung** die Option **Vorhandene Verbindung verwenden** und die `Datadog`-Verbindung aus, die Sie in Schritt 1 erstellt haben.

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

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

Als Nächstes erstellen Sie eine Regel zum Senden von Ereignissen an Datadog, wenn ein Amazon-S3-Objekt erstellt wird.

**So erstellen Sie eine Regel**

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 beispielsweise **DatadogRule** für den Namen und **Rule to send events to Datadog for S3 object creation** für die Beschreibung ein.

1. Bei **Event bus** (Ereignisbus) wählen Sie **default** (Standard) aus.

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

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

1. Wählen Sie für **Event source** (Ereignisquelle) **Other** (Andere) aus.

1. Geben Sie für **Ereignismuster** Folgendes ein:

   ```
   {
     "source": ["aws.s3"]
   }
   ```

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

1. Wählen Sie für **Zieltypen** die Option **EventBridge API-Ziel** aus.

1. Wählen Sie für **API-Ziel** die Option **Vorhandenes API-Ziel verwenden** und dann das `DatadogAD`-Ziel aus, das Sie in Schritt 2 erstellt haben.

1. Wählen Sie für **Ausführungsrolle** die Option **Eine neue Rolle für diese spezifische Ressource erstellen** aus.

1. Gehen Sie für **Weitere Einstellungen** wie folgt vor:

   1. Wählen Sie für **Zieleingabe konfigurieren** die Option **Eingabe-Transformator** aus der Dropdown-Liste aus.

   1. Wählen Sie **Eingabe-Transformator konfigurieren** aus.

   1. Geben Sie für **Beispielereignisse** Folgendes ein:

      ```
      {
        "detail":[]
      }
      ```

   1. Gehen Sie für **Zieleingabe-Transformator** wie folgt vor:

      1. Geben Sie für **Eingabepfad** Folgendes ein:

         ```
         {"detail":"$.detail"}
         ```

      1. Geben Sie für **Eingabevorlage** Folgendes ein:

         ```
         {"message": <detail>}
         ```

   1. Wählen Sie **Bestätigen** 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 4: Testen der Regel
<a name="eb-dd-test-rule"></a>

Um Ihre Regel zu testen, erstellen Sie ein [Amazon S3 S3-Objekt](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html), indem Sie eine Datei in einen EventBridge -fähigen Bucket hochladen. Das erstellte Objekt wird in der Datadog-Logs-Konsole protokolliert.

## 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 Verbindungen zu löschen**

1. Öffnen Sie die [API-Zielseite](https://console.aws.amazon.com/events/home#/apidestinations) der EventBridge Konsole.

1. Wählen Sie die Registerkarte **Connections (Verbindungen)** aus.

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

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

1. Geben Sie den Namen der Verbindung ein und wählen Sie **Löschen** aus.

**Um die EventBridge API-Destination (en) zu löschen**

1. Öffnen Sie die [API-Zielseite](https://console.aws.amazon.com/events/home#/apidestinations) der EventBridge Konsole.

1. Wählen Sie das/die API-Ziel(e) aus, das/die Sie erstellt haben.

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

1. Geben Sie den Namen des API-Ziels ein und wählen Sie **Löschen** aus.

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

1. Öffnen Sie die [Regelseite](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.