Tutorial: Ouvindo EventBridge eventos do Amazon OpenSearch Service

Neste tutorial, você configura uma AWS Lambda função simples que escuta os eventos do Amazon OpenSearch Service e os grava em um stream de CloudWatch logs do Logs.

Pré-requisitos

Este tutorial pressupõe que você tenha um domínio de OpenSearch serviço existente. Se você ainda não criou um domínio, siga as etapas em Criação e gerenciamento de domínios OpenSearch do Amazon Service para criar um.

Etapa 1: Criar a função do Lambda

Neste procedimento, você cria uma função Lambda simples para servir como destino para mensagens de eventos OpenSearch de serviço.

Para criar uma função Lambda de destino

1. Abra o AWS Lambda console em https://console.aws.amazon.com/lambda/.

2. Escolha Criar função e Criar desde o início.

3. Em Nome da função, insira event-handler.

4. ParaRuntime, escolha Python 3.8.

5. Escolha Criar Função.

6. Na seção Function code, edite o código de exemplo de acordo com o exemplo a seguir.

   import json
   
   def lambda_handler(event, context):
       if event["source"] != "aws.es":
           raise ValueError("Function only supports input from events with a source type of: aws.es")
   
       print(json.dumps(event))

   Essa é uma função simples do Python 3.8 que imprime os eventos enviados pelo Service. OpenSearch Se tudo estiver configurado corretamente, no final deste tutorial, os detalhes do evento aparecerão no stream de CloudWatch registros de registros associado a essa função Lambda.

7. Escolha Implantar.

Etapa 2: registrar uma regra de evento

Nesta etapa, você cria uma EventBridge regra que captura eventos dos seus domínios de OpenSearch serviço. Essa regra captura todos os eventos na conta em que ela está definida. As mensagens de eventos em si contêm informações sobre a fonte do evento, inclusive o domínio do qual ele se originou. Você pode usar essas informações para filtrar e classificar eventos de forma programática.

Para criar uma EventBridge regra

1. Abra o EventBridge console em https://console.aws.amazon.com/events/.

2. Escolha Criar regra.

3. Nomeie a regra como event-rule.

4. Escolha Next.

5. Para o padrão do evento, selecione AWS services, Amazon OpenSearch Service e All Events. Esse padrão se aplica a todos os seus domínios de OpenSearch serviço e a todos os eventos OpenSearch de serviço. Como alternativa, você pode criar um padrão mais específico para filtrar alguns resultados.

6. Pressione Próximo.

7. Em Target (Destino), escolha Função do Lambda. No menu suspenso de função, escolha manipulador de eventos.

8. Pressione Próximo.

9. Ignore as tags e pressione Próximo novamente.

10. Revise a configuração e selecione Criar regra.

Etapa 3: Testar sua configuração

Na próxima vez que você receber uma notificação na seção Notificações do console de OpenSearch serviço, se tudo estiver configurado corretamente, sua função Lambda será acionada e gravará os dados do evento em um stream de CloudWatch registros da função.

Para testar sua configuração

1. Abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. No painel de navegação, escolha Logs e selecione o grupo de logs para sua função do Lambda (por exemplo, /aws/lambda/event-handler).

3. Selecione um fluxo de log para visualizar os dados do evento.