Tutorial: enviar eventos ao Datadog por meio do Amazon EventBridge
É possível usar o EventBridge para encaminhar eventos para serviços de terceiros, como Datadog
Neste tutorial, será usado o console do EventBridge para criar uma conexão aoDatadog, um Destino de API que aponta para o Datadog e uma regra que roteia eventos para o Datadog.
Etapas:
Pré-requisitos
Para concluir este tutorial, serão necessários os seguintes recursos:
Uma conta do Datadog
. Um bucket do Amazon Simple Storage Service (Amazon S3) habilitado pelo EventBridge.
Etapa 1: criar uma conexão
Para enviar eventos para o Datadog, primeiro é preciso estabelecer uma conexão com a API do Datadog.
Para criar a conexão
Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/
. -
No painel de navegação, escolha Destinos de API.
-
Escolha a guia Conexões e Criar conexão.
-
Insira um nome e uma descrição para a conexão. Por exemplo, insira
Datadog
como um nome eDatadog API Connection
como uma descrição. -
Em Tipo de autorização, escolha Chave de API.
-
Em Nome da API, insira
DD-API-KEY
. -
Em Valor, cole sua chave secreta de API do Datadog.
-
Escolha Criar.
Etapa 2: criar um destino de API
Agora que criou a conexão, criará o destino da API para usar como destino da regra.
Para criar o destino de API
Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/
. -
No painel de navegação, escolha Destinos de API.
-
Escolha Criar destino de API.
-
Insira um nome e uma descrição para o destino de API. Por exemplo, insira
DatadogAD
para o nome eDatadog API Destination
para a descrição. -
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
. -
Em Método HTTP, escolha POST.
-
Em Limite de taxa de invocação, insira
300
. -
Em Conexão, escolha Usar uma conexão existente e escolha a conexão
Datadog
criada na etapa 1. -
Escolha Criar.
Etapa 3: criar regra
Em seguida, será criada uma regra para enviar eventos para o Datadog quando um objeto do Amazon S3 é criado.
Para criar uma regra do
Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/
. -
No painel de navegação, escolha Regras.
-
Escolha Create rule.
-
Insira um nome e uma descrição para a regra. Por exemplo, insira
DatadogRule
para o nome eRule to send events to Datadog for S3 object creation
para a descrição. -
Em Event Bus (Barramento de eventos), escolha default (padrão).
-
Em Tipo de Regra, escolha Regra com Padrão de Evento.
-
Escolha Próximo.
-
Em Fonte do evento, escolha Outra.
-
Em Padrão de evento, insira um do seguintes:
{ "source": ["aws.s3"] }
-
Escolha Próximo.
-
Em Tipos de destino, escolha o Destino da API do EventBridge.
-
Em Destino da API, escolha Usar um destino de API existente e escolha o destino do
DatadogAD
criado na etapa 2. -
Em Perfil de execução, escolha Criar um novo perfil para este recurso específico.
-
Para Configurações de atualização, faça o seguinte:
-
Em Configurar entrada de destino, escolha Transformador de entrada na lista suspensa.
-
Escolha Configurar transformador de entrada
-
em Eventos de amostra, insira o seguinte:
{ "detail":[] }
-
Para o Transformador de entrada de destino, faça o seguinte:
-
Em Caminho de entrada, insira o seguinte:
{"detail":"$.detail"}
-
Em Modelo de entrada, insira o seguinte:
{"message": <detail>}
-
Escolha Confirmar.
-
-
Escolha Próximo.
-
Escolha Próximo.
-
Analise os detalhes da regra e selecione Criar regra.
Etapa 4: testar a regra
Para testar sua regra, crie um objeto do Amazon S3 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
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
-
Abra a página de Destino da API
do console do EventBridge. -
Escolha a guia Connections (Conexões).
-
Selecione as Conexões que foram criadas.
-
Escolha Excluir.
-
Insira o nome da conexão e escolha Excluir.
Para excluir os destinos da API do EventBridge
-
Abra a página de Destino da API
do console do EventBridge. -
Selecione os destinos da API que foram criados.
-
Escolha Excluir.
-
Insira o nome do destino da API e escolha Excluir.
Para excluir as regras do EventBridge
-
Abra a página Regras
no console do EventBridge. -
Selecione as regras que foram criadas.
-
Escolha Excluir.
-
Escolha Excluir.