

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Tutorial: invia eventi a Datadog da Amazon EventBridge
<a name="eb-tutorial-datadog"></a>

È possibile utilizzare EventBridge per indirizzare [eventi](eb-events.md) a servizi di terze parti, ad esempio. [https://www.datadoghq.com/](https://www.datadoghq.com/)

In questo tutorial, utilizzerai la EventBridge console per creare una connessioneDatadog, una [destinazione API](eb-api-destinations.md) che punti e una [regola](eb-rules.md) a cui indirizzare gli eventiDatadog. Datadog 

**Topics**
+ [Prerequisiti](#eb-dd-prereqs)
+ [Passaggio 1: creare una connessione](#eb-dd-create-connection)
+ [Passaggio 2: creare una destinazione API](#eb-dd-api-destination)
+ [Passaggio 3: creare una regola](#eb-dd-create-rule)
+ [Passaggio 4: testare la regola](#eb-dd-test-rule)
+ [Passaggio 5: eliminare le risorse](#cleanup)

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

Per completare questo tutorial, avrai bisogno delle seguenti risorse:
+ Un [account Datadog](https://www.datadoghq.com/free-datadog-trial/).
+ Una [chiave API Datadog](https://docs.datadoghq.com/account_management/api-app-keys/).
+ Un EventBridge bucket [Amazon Simple Storage Service (Amazon S3) abilitato per Amazon](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html).

## Passaggio 1: creare una connessione
<a name="eb-dd-create-connection"></a>

Per inviare eventi a Datadog, devi prima stabilire una connessione all'API Datadog.

**Per creare la connessione**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel riquadro di navigazione, scegli **Destinazioni API**.

1. Scegli la scheda **Connessioni**, quindi **Crea connessione**.

1. Immetti un nome e una descrizione per la connessione. Ad esempio, immetti **Datadog** come nome e **Datadog API Connection** come descrizione.

1. In **Tipo di autorizzazione**, scegli **Chiave API**.

1. In **Nome chiave API**, immetti **DD-API-KEY**.

1. In **Valore**, incolla la tua chiave API segreta Datadog.

1. Scegli **Create** (Crea).

## Passaggio 2: creare una destinazione API
<a name="eb-dd-api-destination"></a>

Ora che hai creato la connessione, devi creare la destinazione API da utilizzare come [destinazione](eb-targets.md) della regola.

**Per creare la destinazione API**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel riquadro di navigazione, scegli **Destinazioni API**.

1. Scegli **Crea una destinazione API**.

1. Immetti un nome e una descrizione per la destinazione API. In questo esempio, immetti **DatadogAD** come nome e **Datadog API Destination** come descrizione.

1. Per l'**endpoint di destinazione dell'API**, inserisci l'endpoint Datadog Logs:. **https://http-intake.logs.datadoghq.com/api/v2/logs**
**Nota**  
Questo tutorial fornisce eventi ai registri. Datadog Puoi anche fornire eventi Datadog utilizzando l'endpoint degli eventi:. `https://api.datadoghq.com/api/v1/events`

1. Per **HTTP method** (Metodo HTTP) scegli **POST**.

1. In **Limite di velocità di invocazione**, immetti **300**.

1. In **Connessione**, scegli **Utilizza una connessione esistente** e scegli la connessione `Datadog` che hai creato in Passaggio 1.

1. Scegli **Create** (Crea).

## Passaggio 3: creare una regola
<a name="eb-dd-create-rule"></a>

Ora creerai una regola per inviare eventi a Datadog quando viene creato un oggetto Amazon S3.

**Per creare una regola**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel pannello di navigazione, scegli **Regole**.

1. Scegli **Create rule** (Crea regola).

1. Immettere un nome e una descrizione per la regola. In questo esempio, immetti **DatadogRule** come nome e **Rule to send events to Datadog for S3 object creation** come descrizione.

1. Per **Event bus** (Bus di eventi), scegli **default**.

1. Per **Rule type** (Tipo di regola), scegli **Rule with an event pattern** (Regola con un modello di eventi).

1. Scegli **Next (Successivo)**.

1. In **Event source** (Origine eventi), scegli **Other** (Altro).

1. In **Modello di eventi**, immetti quanto segue:

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

1. Scegli **Next (Successivo)**.

1. Per i **tipi di Target**, scegli la **destinazione EventBridge dell'API**.

1. In **Destinazione API**, scegli **Utilizza una destinazione API esistente**, quindi scegli la destinazione `DatadogAD` creata in Passaggio 2.

1. In **Ruolo di esecuzione**, scegli **Crea un nuovo ruolo per questa risorsa specifica**.

1. In **Impostazioni aggiuntive**, procedi come segue:

   1. In **Configura l'input di destinazione**, scegli **Trasformatore di input** dall'elenco a discesa.

   1. Scegli **Configura il trasformatore di input**.

   1. In **Eventi di esempio**, immetti quanto segue:

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

   1. In **Trasformatore di input di destinazione**, procedi come segue:

      1. In **Percorso di input**, immetti quanto segue:

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

      1. In **Modello di input**, immetti quanto segue:

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

   1. Scegli **Conferma**.

1. Scegli **Next (Successivo)**.

1. Scegli **Next (Successivo)**.

1. Rivedi i dettagli della regola e scegli **Create rule** (Crea regola).

## Passaggio 4: testare la regola
<a name="eb-dd-test-rule"></a>

Per testare la tua regola, crea un [oggetto Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) caricando un file in un bucket abilitato. EventBridge L'oggetto creato verrà registrato nella console Datadog Logs.

## Passaggio 5: eliminare le risorse
<a name="cleanup"></a>

Ora è possibile eliminare le risorse create per questo tutorial, a meno che non si voglia conservarle. Eliminando AWS le risorse che non utilizzi più, eviti addebiti inutili sul tuo account. AWS 

**Per eliminare le EventBridge connessioni**

1. Apri la [pagina di destinazione dell'API](https://console.aws.amazon.com/events/home#/apidestinations) della EventBridge console.

1. Scegliere la scheda **Connessioni**.

1. Seleziona la connessione che hai creato.

1. Scegliere **Delete** (Elimina).

1. Immetti il nome della connessione e scegli **Elimina**.

**Per eliminare le destinazioni EventBridge API**

1. Apri la [pagina di destinazione dell'API](https://console.aws.amazon.com/events/home#/apidestinations) della EventBridge console.

1. Seleziona la destinazione API che hai creato.

1. Scegliere **Delete** (Elimina).

1. Immetti il nome della destinazione API e scegli **Elimina**.

**Per eliminare la/le EventBridge regola/e**

1. Apri la [pagina Regole](https://console.aws.amazon.com/events/home#/rules) della EventBridge console.

1. Seleziona la regola che hai creato.

1. Scegliere **Delete (Elimina)**.

1. Scegli **Delete** (Elimina).