

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á.

# Criação de regras para enviar eventos do Amazon Quick Sight para AWS Lambda
<a name="events-send-lambda"></a>

Neste tutorial, você cria uma AWS Lambda função que registra os eventos do ativo na conta Amazon Quick Sight. Em seguida, você criará uma regra que executa a função sempre que houver uma alteração em um ativo. Este tutorial pressupõe que você já se inscreveu no Amazon Quick Sight.

**Etapa 1: criar uma Lambda função**

Crie uma função Lambda para registrar em log os eventos de alteração de estado. Você especifica essa função quando cria sua regra.

1. Faça login no Console de gerenciamento da AWS e abra o AWS Lambda console em [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).

1. Se você estiver começando a usar o Lambda, verá uma página de boas-vindas. Escolha **Get Started Now (Começar agora)**. Do contrário, escolha **Create function (Criar função)**.

1. Escolha **Author from scratch**.

1. Na página Criar função, insira um nome e uma descrição para a função do Lambda. Por exemplo, atribua à função o nome `QuickSightAssetChangeFn`.

1. Em **Runtime**, selecione **Node.js 18.x**.

1. Em **Architecture** (Arquitetura), escolha **x86\$164**.

1. Em **Perfil de execução**, escolha **Criar um novo perfil com as permissões básicas do Lambda** ou **Usar um perfil existente** e selecione o perfil desejado.

1. Escolha a opção **Criar função**.

1. Na **QuickSightAssetChange**página, escolha **index.js**.

1. No painel de **index.js**, exclua o código existente.

1. Insira o trecho de código apresentado a seguir.

   ```
   console.log('Loading function');
   exports.handler = async (event, context) => {
     console.log('Received QuickSight event:', JSON.stringify(event));
   };
   ```

1. Escolha **Deploy (Implantar)**.

**Etapa 2: Criar uma regra**

Crie uma regra para executar sua função Lambda sempre que você tiver um ativo do create/update/delete Amazon Quick Sight.

1. Faça login no Console de gerenciamento da AWS e abra o EventBridge console da Amazon 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, digite `QuickSightAssetChangeRule`.

1. Selecione o barramento de eventos **padrão**.

1. Escolha **Rule with an event pattern** (Regra com padrão de eventos), depois selecione **Next** (Próximo).

1. Em **Origem do evento**, escolha **AWS eventos ou eventos de EventBridge parceiros**.

1. Na seção **Método de criação**, escolha **Padrão personalizado (editor JSON)**.

1. Na caixa de texto **Padrão de evento**, insira o trecho de código apresentado a seguir e escolha **Próximo**.

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

   Como alternativa, você pode criar a regra que se inscreve somente em um subconjunto de tipos de eventos no Amazon Quick Sight. Por exemplo, a regra apresentada a seguir será acionada somente quando um ativo for adicionado ou removido de uma pasta com o ID `77e307e8-b41b-472a-90e8-fe3f471537be`.

   ```
   {
     "source": ["aws.quicksight"],
     "detail-type": ["QuickSight Folder Membership Updated"],
     "detail": {
       "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
     }
   }
   ```

1. Em **Tipos de destino**, escolha **Serviço da AWS ** e **Função do Lambda**.

1. Em **Function** (Função), selecione a função do Lambda que você criou. Escolha **Próximo**.

1. Em **Configure tags** (Configurar etiquetas), escolha **Next** (Próximo).

1. Revise as etapas da sua regra. Em seguida, escolha **Create rule** (Criar regra).

**Etapa 3: Testar a regra**

Para testar a regra, crie uma análise. Após aguardar um minuto, verifique se a função do Lambda foi invocada.

1. Abra o console do Amazon Quick Sight em [https://quicksight.aws.amazon.com/](https://quicksight.aws.amazon.com/).

1. Criar uma nova análise.

1. No painel de navegação, escolha **Rules** (Regras) e escolha o nome da regra criada por você.

1. Em **Detalhes da regra**, escolha **Monitoramento**.

1. Você será redirecionado para o CloudWatch console da Amazon. Se você não for redirecionado, escolha **Exibir as métricas em CloudWatch**.

1. Em **All metrics** (Todas as métricas), escolha o nome da regra que você criou. O gráfico indica que a regra foi invocada.

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

1. Escolha o nome do grupo de logs para a função do Lambda. Por exemplo, .`/aws/lambda/function-name`

1. Escolha o nome do fluxo de logs para visualizar os dados fornecidos pela função para a instância que você iniciou. Será exibido um resultado semelhante ao seguinte:

   ```
   {
     "version": "0",
     "id": "3acb26c8-397c-4c89-a80a-ce672a864c55",
     "detail-type": "QuickSight Analysis Creation Successful",
     "source": "aws.quicksight",
     "account": "123456789012",
     "time": "2023-10-30T22:06:31Z",
     "region": "us-east-1",
     "resources": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],
     "detail": {
       "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
     }
   }
   ```

Para ver um exemplo do evento Amazon Quick Sight no formato JSON, consulte [Visão geral dos eventos do Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/developerguide/events.html).