As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Tutorial: enviar eventos ao Datadog por meio do Amazon EventBridge
<a name="eb-tutorial-datadog"></a>

É possível usar o EventBridge para encaminhar [eventos](eb-events.md) para serviços de terceiros, como [https://www.datadoghq.com/](https://www.datadoghq.com/).

Neste tutorial, será usado o console do EventBridge para criar uma conexão aoDatadog, um [Destino de API](eb-api-destinations.md) que aponta para o Datadog e uma [regra](eb-rules.md) que roteia eventos para o Datadog. 

**Topics**
+ [Pré-requisitos](#eb-dd-prereqs)
+ [Etapa 1: criar uma conexão](#eb-dd-create-connection)
+ [Etapa 2: criar um destino de API](#eb-dd-api-destination)
+ [Etapa 3: criar regra](#eb-dd-create-rule)
+ [Etapa 4: testar a regra](#eb-dd-test-rule)
+ [Etapa 5: limpar os recursos](#cleanup)

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

Para concluir este tutorial, serão necessários os seguintes recursos:
+ Uma [conta do Datadog](https://www.datadoghq.com/free-datadog-trial/).
+ Uma [chave de API do Datadog](https://docs.datadoghq.com/account_management/api-app-keys/).
+ Um bucket do [Amazon Simple Storage Service (Amazon S3)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) habilitado pelo EventBridge.

## Etapa 1: criar uma conexão
<a name="eb-dd-create-connection"></a>

Para enviar eventos para o Datadog, primeiro é preciso estabelecer uma conexão com a API do Datadog.

**Para criar a conexão**

1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. No painel de navegação, escolha **Destinos de API**.

1. Escolha a guia **Conexões** e **Criar conexão**.

1. Insira um nome e uma descrição para a conexão. Por exemplo, insira **Datadog** como um nome e **Datadog API Connection** como uma descrição.

1. Em **Tipo de autorização**, escolha **Chave de API**.

1. Em **Nome da API**, insira **DD-API-KEY**.

1. Em **Valor**, cole sua chave secreta de API do Datadog.

1. Escolha **Criar**.

## Etapa 2: criar um destino de API
<a name="eb-dd-api-destination"></a>

Agora que criou a conexão, criará o destino da API para usar como [destino](eb-targets.md) da regra.

**Para criar o destino de API**

1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. No painel de navegação, escolha **Destinos da API**.

1. Escolha **Criar destino de API**.

1. Insira um nome e uma descrição para o destino de API. Por exemplo, insira **DatadogAD** para o nome e **Datadog API Destination** para a descrição.

1. Em **Endpoint de destino de API**, insira o endpoint Datadog Logs: **https://http-intake.logs.datadoghq.com/api/v2/logs**.
**nota**  
Este tutorial fornece eventos para o Datadog Logs. Você também pode fornecer eventos para o Datadog usando o endpoint de eventos: `https://api.datadoghq.com/api/v1/events`.

1. Em **Método HTTP**, escolha **POST**.

1. Em **Limite de taxa de invocação**, insira **300**.

1. Em **Conexão**, escolha U**sar uma conexão existente** e escolha a conexão `Datadog` criada na etapa 1.

1. Escolha **Criar**.

## Etapa 3: criar regra
<a name="eb-dd-create-rule"></a>

Em seguida, será criada uma regra para enviar eventos para o Datadog quando um objeto do Amazon S3 é criado.

**Como criar uma regra**

1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. No painel de navegação, escolha **Regras**.

1. Escolha **Create rule**.

1. Insira um nome e uma descrição para a regra. Por exemplo, insira **DatadogRule** para o nome e **Rule to send events to Datadog for S3 object creation** para a descrição.

1. Em **Barramento de eventos**, escolha **padrão**.

1. Em **Rule type**, escolha **Rule with an event pattern**.

1. Escolha **Próximo**.

1. Em **Fonte do evento**, escolha **Outra**.

1. Em **Padrão de evento**, insira um do seguintes:

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

1. Escolha **Próximo**.

1. Em **Tipos de destino**, escolha o **Destino da API do EventBridge**.

1. Em **Destino da API**, escolha **Usar um destino de API existente** e escolha o destino do `DatadogAD` criado na etapa 2.

1. Em **Perfil de execução**, escolha **Criar um novo perfil para este recurso específico**.

1. Para **Configurações de atualização**, faça o seguinte:

   1. Em **Configurar entrada de destino**, escolha **Transformador de entrada** na lista suspensa.

   1. Escolha **Configurar transformador de entrada**

   1. em **Eventos de amostra**, insira o seguinte:

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

   1. Para o **Transformador de entrada de destino**, faça o seguinte:

      1. Em **Caminho de entrada**, insira o seguinte:

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

      1. Em **Modelo de entrada**, insira o seguinte:

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

   1. Escolha **Confirmar**.

1. Escolha **Próximo**.

1. Escolha **Próximo**.

1. Analise os detalhes da regra e selecione **Criar regra**.

## Etapa 4: testar a regra
<a name="eb-dd-test-rule"></a>

Para testar sua regra, crie um [objeto do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/upload-objects.html) fazendo o upload de um arquivo em um bucket compatível com o Eventbridge. O objeto criado será registrado em log no console de logs do Datadog.

## Etapa 5: limpar os recursos
<a name="cleanup"></a>

Agora você pode excluir os recursos criados para este tutorial, a menos que queira mantê-los. Ao excluir os recursos da AWS que não estão mais sendo usados, são evitadas cobranças desnecessárias em sua conta da AWS.

**Para excluir as conexões do EventBridge**

1. Abra a página de [Destino da API](https://console.aws.amazon.com/events/home#/apidestinations) do console do EventBridge.

1. Escolha a guia **Connections (Conexões)**.

1. Selecione as Conexões que foram criadas.

1. Escolha **Excluir**.

1. Insira o nome da conexão e escolha **Excluir**.

**Para excluir os destinos da API do EventBridge**

1. Abra a página de [Destino da API](https://console.aws.amazon.com/events/home#/apidestinations) do console do EventBridge.

1. Selecione os destinos da API que foram criados.

1. Escolha **Excluir**.

1. Insira o nome do destino da API e escolha **Excluir**.

**Para excluir as regras do EventBridge**

1. Abra a página [Regras](https://console.aws.amazon.com/events/home#/rules) no console do EventBridge.

1. Selecione as regras que foram criadas.

1. Escolha **Excluir**.

1. Escolha **Excluir**.