Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Tutoriel : Envoyer des événements Datadog depuis Amazon EventBridge
<a name="eb-tutorial-datadog"></a>

Vous pouvez l'utiliser EventBridge pour acheminer [des événements](eb-events.md) vers des services tiers, tels que [https://www.datadoghq.com/](https://www.datadoghq.com/).

Dans ce didacticiel, vous allez utiliser la EventBridge console pour créer une connexionDatadog, une [destination d'API](eb-api-destinations.md) pointant vers Datadog et une [règle](eb-rules.md) vers laquelle acheminer les événementsDatadog. 

**Topics**
+ [Prérequis](#eb-dd-prereqs)
+ [Étape 1 : Créer une connexion](#eb-dd-create-connection)
+ [Étape 2 : Créer la destination d’API](#eb-dd-api-destination)
+ [Étape 3 : Créer une règle](#eb-dd-create-rule)
+ [Étape 4 : Tester la règle](#eb-dd-test-rule)
+ [Étape 5 : Nettoyer vos ressources](#cleanup)

## Prérequis
<a name="eb-dd-prereqs"></a>

Pour suivre ce didacticiel, vous aurez besoin des ressources suivantes :
+ Un [compte Datadog](https://www.datadoghq.com/free-datadog-trial/).
+ Une [clé d’API Datadog](https://docs.datadoghq.com/account_management/api-app-keys/).
+ Un EventBridge bucket [Amazon Simple Storage Service (Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)) activé.

## Étape 1 : Créer une connexion
<a name="eb-dd-create-connection"></a>

Pour envoyer des événements à Datadog, vous devez d’abord établir une connexion à l’API Datadog.

**Pour créer la connexion**

1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dans le panneau de navigation, choisissez **Destinations d’API**.

1. Choisissez l’onglet **Connexions**, puis sélectionnez **Créer une connexion**.

1. Nommez et décrivez la connexion. Par exemple, entrez **Datadog** pour le nom et **Datadog API Connection** pour la description.

1. Pour **Type d’autorisation**, choisissez **Clé API**.

1. Pour **Nom de clé de l’API**, entrez **DD-API-KEY**.

1. Pour **Valeur**, collez votre clé d’API secrète Datadog.

1. Choisissez **Créer**.

## Étape 2 : Créer la destination d’API
<a name="eb-dd-api-destination"></a>

Maintenant que vous avez créé la connexion, vous allez créer la destination d’API à utiliser comme [cible](eb-targets.md) de la règle.

**Pour créer la destination d’API**

1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dans le panneau de navigation, choisissez **Destinations d’API**.

1. Choisissez **Créer une destination d’API**.

1. Nommez et décrivez la destination d’API. Par exemple, entrez **DatadogAD** pour le nom et **Datadog API Destination** pour la description.

1. Pour le point de **terminaison de destination de l'API**, entrez le point de terminaison Datadog Logs :**https://http-intake.logs.datadoghq.com/api/v2/logs**.
**Note**  
Ce didacticiel fournit des événements à Datadog Logs. Vous pouvez également envoyer des événements à Datadog l'aide du point de terminaison des événements :`https://api.datadoghq.com/api/v1/events`.

1. Dans le champ **HTTP Method**, sélectionnez **POST**.

1. Pour **Limite du taux d’appel**, entrez **300**.

1. Pour **Connexion**, choisissez **Utiliser une connexion existante** et sélectionnez la connexion `Datadog` que vous avez créée à l’étape 1.

1. Choisissez **Créer**.

## Étape 3 : Créer une règle
<a name="eb-dd-create-rule"></a>

Vous allez maintenant créer une règle de sorte que des événements soient envoyés à Datadog lorsqu’un objet Amazon S3 est créé.

**Pour créer une règle**

1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dans le volet de navigation, choisissez **Règles**.

1. Choisissez **Créer une règle**.

1. Saisissez un nom et une description pour la règle. Par exemple, entrez **DatadogRule** pour le nom et **Rule to send events to Datadog for S3 object creation** pour la description.

1. Pour **Event bus** (Bus d’événement), choisissez **default** (défaut).

1. Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.

1. Choisissez **Suivant**.

1. Pour **Event source** (Source de l'événement), choisissez **Other** (Autres).

1. Pour **Modèle d’événement**, entrez ce qui suit :

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

1. Choisissez **Suivant**.

1. Pour les **types de cibles**, choisissez la **destination de EventBridge l'API**.

1. Pour **Destination d’API**, choisissez **Utiliser une destination d’API existante**, puis choisissez la destination `DatadogAD` que vous avez créée à l’étape 2.

1. Pour **Rôle d’exécution**, choisissez **Créer un rôle pour cette ressource spécifique**.

1. Pour **Réglages supplémentaires**, procédez comme suit :

   1. Pour **Configurer l’entrée cible**, choisissez **Transformateur d’entrée** dans la liste déroulante.

   1. Choisissez **Configurer le transformateur d’entrée**.

   1. Pour **Exemples d’événements**, entrez ce qui suit :

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

   1. Pour **Transformateur d’entrée cible**, procédez comme suit :

      1. Pour **Chemin d’entrée**, entrez ce qui suit :

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

      1. Pour **Modèle d’entrée**, entrez ce qui suit :

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

   1. Choisissez **Confirmer**.

1. Choisissez **Suivant**.

1. Choisissez **Suivant**.

1. Consultez les détails de la règle et choisissez **Create rule** (Créer une règle).

## Étape 4 : Tester la règle
<a name="eb-dd-test-rule"></a>

Pour tester votre règle, créez un [objet Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) en téléchargeant un fichier dans un compartiment EventBridge activé. L’objet créé sera journalisé dans la console Datadog Logs.

## Étape 5 : Nettoyer vos ressources
<a name="cleanup"></a>

Vous pouvez maintenant supprimer les ressources que vous avez créées pour ce didacticiel, sauf si vous souhaitez les conserver. En supprimant AWS les ressources que vous n'utilisez plus, vous évitez des frais inutiles sur votre AWS compte.

**Pour supprimer les EventBridge connexions**

1. Ouvrez la [page de destination de l'API](https://console.aws.amazon.com/events/home#/apidestinations) de la EventBridge console.

1. Choisissez l'onglet **Connections (Connexions)**.

1. Sélectionnez la ou les connexions que vous avez créées.

1. Sélectionnez **Delete (Supprimer)**.

1. Entrez le nom de la connexion et choisissez **Supprimer**.

**Pour supprimer la ou les destinations de l' EventBridge API**

1. Ouvrez la [page de destination de l'API](https://console.aws.amazon.com/events/home#/apidestinations) de la EventBridge console.

1. Sélectionnez la ou les destinations d’API que vous avez créées.

1. Sélectionnez **Delete (Supprimer)**.

1. Entrez le nom de la destination d’API et choisissez **Supprimer**.

**Pour supprimer la ou les EventBridge règles**

1. Ouvrez la [page Règles](https://console.aws.amazon.com/events/home#/rules) de la EventBridge console.

1. Sélectionnez la ou les règles que vous avez créées.

1. Sélectionnez **Delete (Supprimer)**.

1. Sélectionnez **Supprimer**.