View a markdown version of this page

Criando um EventBridge cachimbo da Amazon - Amazônia EventBridge
Como especificar uma origemComo configurar a filtragemComo definir o enriquecimentoComo configurar um destinoComo configurar definições de pipeComo validar os parâmetros de configuração

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

Criando um EventBridge cachimbo da Amazon

EventBridge O Pipes permite criar integrações ponto a ponto entre fontes e destinos, incluindo transformações e enriquecimento avançados de eventos.

Para criar um EventBridge tubo, você executa as seguintes etapas:

  1. Como especificar uma origem

  2. Como configurar a filtragem de eventos (opcional)

  3. Como definir o enriquecimento do evento (opcional)

  4. Como configurar um destino

  5. Como configurar as definições de pipe

Para configurar rapidamente um pipe de amostra, consulte Primeiros passos: Crie um EventBridge canal Amazon. Este tópico é usado CloudFormation para implantar um tubo e seus recursos associados e orienta você por uma visão geral dos recursos de um tubo.

Para obter informações sobre como criar um pipe usando a AWS CLI, consulte create-pipe na Referência de Comandos da AWS CLI.

Como especificar uma origem

Para começar, especifique a origem da qual deseja que o pipe receba eventos.

Para especificar uma origem de pipe usando o console

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

  2. No painel de navegação, escolha Pipes.

  3. Escolha Criar pipe.

  4. Insira um nome para o pipe.

  5. (Opcional) Adicione uma descrição para o pipe.

  6. Na guia Criar pipe, em Origem, escolha o tipo de origem que você deseja especificar para esse pipe e configure a origem.

    As propriedades de configuração diferem com base no tipo de origem escolhida:

    Confluent
    Como configurar um fluxo do Confluent Cloud como origem usando o console

    1. Em Origem, selecione Confluent Cloud.

    2. Para Servidores bootstrap, insira os endereços de pares host:port de seus agentes.

    3. Em Nome do tópico: insira o nome do tópico do qual o pipe lerá.

    4. (Opcional) Em VPC, escolha a VPC que deseja. Em seguida, para sub-redes VPC, escolha as sub-redes desejadas. Em Grupos de segurança, escolha os grupos de segurança.

    5. Em Autenticação: opcional, ative Usar autenticação e faça o seguinte:

      1. Em Método de autenticação, escolha o tipo de autenticação.

      2. Em Chave secreta, escolha a chave secreta.

      Para obter mais informações, consulte Authenticate to Confluent Cloud resources na documentação da Confluent.

    6. (Opcional) Em Configurações adicionais, faça o seguinte:

      1. Para Posição inicial, escolha uma das seguintes opções:

        • Mais recente: comece a ler o fluxo com o registro mais recente no fragmento.

        • Horizonte de corte: comece a ler o fluxo com o registro mais recente não cortado no fragmento. Este é o registro mais antigo do fragmento.

      2. Em Tamanho do lote: opcional, insira um número máximo de registros para cada lote. O valor padrão é 100.

      3. Em Janela de lotes: opcional, insira um número máximo de segundos para coletar registros antes de continuar.

    DynamoDB

    1. Em Origem, escolha DynamoDB.

    2. Para o fluxo do DynamoDB, escolha o fluxo que você deseja usar como origem.

    3. Para Posição inicial, escolha uma das seguintes opções:

      • Mais recente: comece a ler o fluxo com o registro mais recente no fragmento.

      • Horizonte de corte: comece a ler o fluxo com o registro mais recente não cortado no fragmento. Este é o registro mais antigo do fragmento.

    4. (Opcional) Em Configurações adicionais, faça o seguinte:

      1. Em Tamanho do lote: opcional, insira um número máximo de registros para cada lote. O valor padrão é 10.

      2. Em Janela de lotes: opcional, insira um número máximo de segundos para coletar registros antes de continuar.

      3. Em Lotes simultâneos por fragmento: opcional, insira o número de lotes do mesmo fragmento que podem ser lidos ao mesmo tempo.

      4. Para Em caso de falha parcial do item do lote, escolha o seguinte:

        • AUTOMATIC_BISECT: divida cada lote na metade e faça novas tentativas com cada metade até que todos os registros sejam processados ou que reste apenas uma mensagem com falha no lote.

        nota

        Se não escolher AUTOMATIC_BISECT, poderá retornar registros específicos com falha e somente aqueles serão repetidos.

    Kinesis
    Para configurar uma origem do Kinesis usando o console

    1. Em Origem, escolha Kinesis.

    2. Para o fluxo do Kinesis, escolha o fluxo que você deseja usar como origem.

    3. Para Posição inicial, escolha uma das seguintes opções:

      • Mais recente: comece a ler o fluxo com o registro mais recente no fragmento.

      • Horizonte de corte: comece a ler o fluxo com o registro mais recente não cortado no fragmento. Este é o registro mais antigo do fragmento.

      • No timestamp: comece a ler o fluxo a partir de um horário especificado. Em Timestamp, insira os dados e a hora usando o formato YYYY/MM/DD hh:mm:ss.

    4. (Opcional) Em Configurações adicionais, faça o seguinte:

      1. Em Tamanho do lote: opcional, insira um número máximo de registros para cada lote. O valor padrão é 10.

      2. (Opcional) Para Janela batch: opcional, insira um número máximo de segundos para coletar registros antes de continuar.

      3. Em Lotes simultâneos por fragmento: opcional, insira o número de lotes do mesmo fragmento que podem ser lidos ao mesmo tempo.

      4. Para Em caso de falha parcial do item do lote, escolha o seguinte:

        • AUTOMATIC_BISECT: divida cada lote na metade e faça novas tentativas com cada metade até que todos os registros sejam processados ou que reste apenas uma mensagem com falha no lote.

        nota

        Se não escolher AUTOMATIC_BISECT, poderá retornar registros específicos com falha e somente aqueles serão repetidos.

    Amazon MQ
    Para configurar uma origem do Amazon MQ usando o console

    1. Em Origem, selecione Amazon MQ.

    2. Para o agente do Amazon MQ, escolha o fluxo que deseja usar como origem.

    3. Em Nome da fila, insira o nome da fila da qual o pipe lerá.

    4. Em Método de autenticação, escolha BASIC_AUTH.

    5. Em Chave secreta, escolha a chave secreta.

    6. (Opcional) Em Configurações adicionais, faça o seguinte:

      1. Em Tamanho do lote: opcional, insira um número máximo de mensagens para cada lote. O valor padrão é 100.

      2. Em Janela de lotes: opcional, insira um número máximo de segundos para coletar registros antes de continuar.

    Amazon MSK
    Para configurar uma origem do Amazon MSK usando o console

    1. Em Origem, selecione Amazon MSK.

    2. Em cluster do Amazon MSK, escolha o cluster que deseja usar.

    3. Em Nome do tópico: insira o nome do tópico do qual o pipe lerá.

    4. (Opcional) Em ID do grupo de consumidores: opcional, insira o ID de um grupo de consumidores no qual deseja que o pipe entre.

    5. (Opcional) Para Autenticação: opcional, ative Usar Autenticação e faça o seguinte:

      1. Em Método de autenticação, escolha o tipo que deseja.

      2. Em Chave secreta, escolha a chave secreta.

    6. (Opcional) Em Configurações adicionais, faça o seguinte:

      1. Em Tamanho do lote: opcional, insira um número máximo de registros para cada lote. O valor padrão é 100.

      2. Em Janela de lotes: opcional, insira um número máximo de segundos para coletar registros antes de continuar.

      3. Para Posição inicial, escolha uma das seguintes opções:

        • Mais recente: comece a ler o tópico com o registro mais recente no fragmento.

        • Horizonte de corte: comece a ler o tópico com o registro mais recente não cortado no fragmento. Este é o registro mais antigo do fragmento.

          nota

          Horizonte de corte é o mesmo que Mais antigo para Apache Kafka.

    Self managed Apache Kafka
    Para configurar uma origem autogerenciada do Apache Kafka usando o console

    1. Em Fonte, escolha Self-managed Apache Kafka.

    2. Para Servidores bootstrap, insira os endereços de pares host:port de seus agentes.

    3. Em Nome do tópico: insira o nome do tópico do qual o pipe lerá.

    4. (Opcional) Em VPC, escolha a VPC que deseja. Em seguida, para sub-redes VPC, escolha as sub-redes desejadas. Em Grupos de segurança, escolha os grupos de segurança.

    5. (Opcional) Para Autenticação: opcional, ative Usar Autenticação e faça o seguinte:

      1. Em Método de autenticação, escolha o tipo de autenticação.

      2. Em Chave secreta, escolha a chave secreta.

    6. (Opcional) Em Configurações adicionais, faça o seguinte:

      1. Para Posição inicial, escolha uma das seguintes opções:

        • Mais recente: comece a ler o fluxo com o registro mais recente no fragmento.

        • Horizonte de corte: comece a ler o fluxo com o registro mais recente não cortado no fragmento. Este é o registro mais antigo do fragmento.

      2. Em Tamanho do lote: opcional, insira um número máximo de registros para cada lote. O valor padrão é 100.

      3. Em Janela de lotes: opcional, insira um número máximo de segundos para coletar registros antes de continuar.

    Amazon SQS
    Para configurar uma origem do Amazon SQS usando o console

    1. Em Origem, escolha SQS.

    2. Na fila SQS, escolha a fila que você deseja usar.

    3. (Opcional) Em Configurações adicionais, faça o seguinte:

      1. Em Tamanho do lote: opcional, insira um número máximo de registros para cada lote. O valor padrão é 100.

      2. Em Janela de lotes: opcional, insira um número máximo de segundos para coletar registros antes de continuar.

Como configurar a filtragem de eventos (opcional)

É possível adicionar filtragem ao seu pipe para enviar apenas um subconjunto de eventos da sua origem para o destino.

Para configurar a filtragem usando o console

  1. Escolha Filtragem.

  2. Em Exemplo de evento: opcional, você verá um evento de amostra que pode ser usado para criar seu padrão de evento ou pode inserir seu próprio evento escolhendo Inserir seu próprio evento.

  3. Em Padrão do evento, insira o padrão do evento que deseja usar para filtrar os eventos. Para obter mais informações sobre construção de filtros, consulte Filtragem de eventos no Amazon Pipes EventBridge.

    A seguir, um exemplo de padrão de evento que envia somente eventos com o valor Seattle no campo Cidade.

    {
  "data": {
    "City": ["Seattle"]
  }
}

Agora que os eventos estão sendo filtrados, é possível adicionar enriquecimento opcional e um destino para o pipe.

Como definir o enriquecimento do evento (opcional)

Você pode enviar os dados do evento para enriquecimento para uma função do Lambda, máquina de AWS Step Functions estado, Amazon API Gateway ou destino da API.

Para selecionar o enriquecimento

  1. Escolha Enriquecimento.

  2. Em Detalhes, em Serviço, selecione o serviço e as configurações relacionadas que deseja usar para enriquecimento.

Também é possível transformar os dados antes de enviá-los para serem aprimorados.

(Opcional) Para definir o transformador de entrada

  1. Escolha o Transformador de entrada de enriquecimento: opcional.

  2. Em Sample events/Event Payload, escolha o tipo de evento de amostra.

  3. Para Transformer, insira a sintaxe do transformador, como "Event happened at <$.detail.field>." onde <$.detail.field> é uma referência a um campo do evento de amostra. Também é possível clicar duas vezes em um campo do evento de amostra para adicioná-lo ao transformador.

  4. Em Saída, verifique se a saída tem a aparência desejada.

Agora que os dados foram filtrados e aprimorados, é preciso definir um destino para o qual enviar os dados do evento.

Como configurar um destino

Para configurar um destino

  1. Selecione Target.

  2. Em Detalhes, para o Serviço de destino, escolha o destino. Os campos que são exibidos variam de acordo com o serviço escolhido. Insira as informações específicas desse tipo de destino conforme necessário.

Também é possível transformar os dados antes de enviá-los ao destino.

(Opcional) Para definir o transformador de entrada

  1. Escolha Transformador de entrada de destino: opcional.

  2. Em Sample events/Event Payload, escolha o tipo de evento de amostra.

  3. Para Transformer, insira a sintaxe do transformador, como "Event happened at <$.detail.field>." onde <$.detail.field> é uma referência a um campo do evento de amostra. Também é possível clicar duas vezes em um campo do evento de amostra para adicioná-lo ao transformador.

  4. Em Saída, verifique se a saída tem a aparência desejada.

Agora que o pipe está configurado, verifique se suas configurações estão definidas corretamente.

Como configurar as definições de pipe

Um pipe está ativo por padrão, mas você pode desativá-lo. Também é possível especificar as permissões do pipe, configurar o registro em log de pipes e adicionar tags.

Configurar as definições de pipe

  1. Escolha a guia Configurações de pipe.

  2. Por padrão, os pipes recém-criados ficam ativos assim que são criados. Se quiser criar um pipe inativo, em Ativação, para Ativar pipe, desative Ativo.

  3. Em Permissões, para Perfil de execução, faça o seguinte:

    1. Para EventBridge criar uma nova função de execução para esse canal, escolha Criar uma nova função para esse recurso específico. Em Nome do perfil, você pode, opcionalmente, editar o nome do perfil.

    2. Para um perfil de execução existente, escolha Usar perfil existente. Em Nome do perfil, escolha o perfil.

    Gerenciador de funções ativado

    Se o gerente de funções estiver habilitado em sua conta, EventBridge anexará a função para você. EventBridge substitui as opções Criar uma nova função para esse recurso específico e Usar função existente por uma opção Personalizar. Para usar um perfil diferente, escolha Personalizar. Consulte mais informações em Criar um perfil do IAM no Guia do usuário do IAM.

  4. (Opcional) Se você tiver especificado um DynamoDB fluxo Kinesis or como origem do canal, poderá configurar uma política de repetição e uma fila de cartas mortas (DLQ).

    Em Política de repetição e Dead-letter fila - opcional, faça o seguinte:

    Em Revisar política, faça o seguinte:

    1. Se quiser habilitar políticas de novas tentativas, ative Novas tentativas. Por padrão, os pipes recém-criados não têm uma política de repetição ativada.

    2. Em Tempo Máximo do Evento, insira um valor entre um minuto (00:01) e 24 horas (24:00).

    3. Em Tentativas de Repetição, insira um número entre 0 e 185.

    4. Se você quiser usar uma fila de cartas mortas (DLQ), ative a Dead-letter fila, escolha o método de sua preferência e escolha a fila ou o tópico que você gostaria de usar. Por padrão, os pipes recém-criados não usam uma DLQ.

  5. Escolha o formulário KMS key a EventBridge ser usado ao criptografar dados de tubulação.

    Para obter mais informações sobre como EventBridge usa KMS keys, consulteCriptografia em repouso.

    • Escolha Usar Chave pertencente à AWS para EventBridge para criptografar os dados usando um. Chave pertencente à AWS

      Chave pertencente à AWS É um KMS key que EventBridge possui e gerencia para uso em várias AWS contas. Em geral, a menos que seja necessário auditar ou controlar a chave de criptografia que protege os recursos, uma Chave pertencente à AWS é uma boa escolha.

      Esse é o padrão.

    • Escolha Usar chave gerenciada pelo cliente para EventBridge para criptografar os dados usando o chave gerenciada pelo cliente que você especificar ou criar.

      Chaves gerenciadas pelo cliente estão KMS keys na sua AWS conta que você cria, possui e gerencia. Você tem controle total sobre essas KMS keys.

      1. Especifique um existente chave gerenciada pelo cliente ou escolha Criar um novo KMS key.

        EventBridge exibe o status da chave e quaisquer aliases de chave que tenham sido associados ao especificado chave gerenciada pelo cliente.

  6. (Opcional) Em Logs: opcional, você pode configurar como o EventBridge Pipes envia informações de registro em log para os serviços compatíveis, incluindo como configurar esses logs.

    Para obter mais informações sobre o registro em log de pipes, consulte Registrando o desempenho do Amazon EventBridge Pipes.

    CloudWatch os registros são selecionados como destino do registro por padrão, assim como o nível do ERROR registro. Então, por padrão, o EventBridge Pipes cria um novo grupo de CloudWatch logs para o qual ele envia registros de log contendo o ERROR nível de detalhe.

    Para que o EventBridge Pipes envie registros de log para qualquer um dos destinos de log suportados, faça o seguinte:

    1. Em Registros: opcional, escolha os destinos para os quais deseja que os registros de log sejam entregues.

    2. Em Nível de registro, escolha o nível de informações a EventBridge serem incluídas nos registros de registro. O nível de log ERROR é selecionado por padrão.

      Para obter mais informações, consulte Especificando o nível EventBridge de registro de tubos.

    3. Selecione Incluir dados de execução se EventBridge quiser incluir informações de carga útil do evento e informações de solicitação e resposta de serviço nos registros de registro.

      Para obter mais informações, consulte Incluindo dados de execução nos registros do EventBridge Pipes.

    4. Configure cada destino de log selecionado por você:

      Para CloudWatch Logs registros, em CloudWatch registros, faça o seguinte:

      • Para grupo de CloudWatch registros, escolha se deseja EventBridge criar um novo grupo de registros ou selecionar um grupo de registros existente ou especificar o ARN de um grupo de registros existente.

      • Para novos grupos de logs, edite o nome do grupo de logs conforme desejado.

      CloudWatch os registros são selecionados por padrão.

      Para registros de Firehose fluxo, em Registro de Firehose fluxo, selecione o Firehose fluxo.

      Para Amazon S3 registros, em registros do S3, faça o seguinte:

      • Insira o nome do bucket a ser usado como destino do log.

      • Insira o ID da AWS conta do proprietário do bucket.

      • Insira qualquer texto de prefixo que você queira usar quando o EventBridge criar objetos do S3.

        Para obter informações, consulte Como organizar objetos usando prefixos no Guia do usuário do Amazon Simple Storage Service .

      • Escolha como você deseja EventBridge formatar os registros de log do S3:

  7. (Opcional) Em Tags: opcional, escolha Adicionar nova tag e insira uma ou mais tags para a regra. Para obter mais informações, consulte Recursos de marcação na Amazon EventBridge.

  8. Escolha Criar pipe.

Como validar os parâmetros de configuração

Depois que um tubo é criado, EventBridge valida os seguintes parâmetros de configuração:

  • Função do IAM — Como a origem de um canal não pode ser alterada após a criação do canal, EventBridge verifica se a função do IAM fornecida pode acessar a origem.

    nota

    EventBridge não realiza a mesma validação para enriquecimentos ou alvos porque eles podem ser atualizados após a criação do canal.

  • Lotes — EventBridge valida se o tamanho do lote da origem não excede o tamanho máximo do lote do destino. Se isso acontecer, EventBridge requer um tamanho de lote menor. Além disso, se um destino não oferecer suporte ao agrupamento em lote, você não poderá configurar o agrupamento em lote EventBridge para a origem.

  • Enriquecimentos — EventBridge valida que o tamanho do lote para enriquecimentos do API Gateway e do destino da API é 1, pois somente tamanhos de lote de 1 são suportados.