

# Como criar pipelines
<a name="Creating-pipelines"></a>

O assistente de configuração de pipeline orienta você durante a criação do pipeline de dados.

1. Em **Configurações gerais**, forneça os detalhes da fonte de dados, incluindo nome e tipo da fonte. Você também pode especificar tags de pipeline e o nome do pipeline.

1. Em **Destino**, especifique os detalhes do destino. O CloudWatch Logs é o destino padrão. 

1. Em **Processador**, adicione os processadores e analisadores desejados. Um analisador é a primeira etapa obrigatória para certos tipos de dados. Você pode realizar uma análise personalizada usando processadores como Grok ou CSV. Os processadores que não são compatíveis com o tipo de dado estão desabilitados.

   Para configurar processadores usando linguagem natural, habilite o botão de alternância **Assistida por IA**. Insira uma descrição das transformações de logs necessárias, e os pipelines do CloudWatch vão gerar automaticamente a configuração do processador. Para logs fornecidos pela AWS, uma amostra de evento de logs também é gerada para que você possa verificar a saída antes da implantação. Você pode revisar e editar a configuração gerada antes de criar o pipeline.
**Importante**  
Para usar a configuração do processador assistida por IA, você deve ter a permissão `logs:GeneratePipeline` do IAM. Para obter mais informações, consulte [Permissões de configuração do processador assistida por IA](pipeline-iam-reference.md#ai-assisted-permissions).

   Você também pode adicionar regras de processamento condicional aos processadores compatíveis usando o parâmetro `when`. O processamento condicional permite controlar em quais entradas de logs um processador atua. Para obter a sintaxe da expressão e os processadores compatíveis, consulte [Sintaxe da expressão para processamento condicional](conditional-processing.md).

   Para preservar cópias não modificadas de seus dados de logs para fins de auditoria ou conformidade, habilite o botão de alternância **Manter log original**. Quando habilitados, os pipelines do CloudWatch armazenam automaticamente uma cópia de cada evento de logs bruto antes que qualquer transformação ocorra no campo do sistema `@original_message` do evento. Isso garante que os dados originais estejam sempre disponíveis para auditorias ou investigações, mesmo depois de os processadores modificarem os eventos de logs. O botão de alternância **Manter log original** está disponível somente para pipelines com uma fonte de logs fornecida pelo CloudWatch.

1. Em **Revisar e criar**, revise a configuração do alarme. Se estiver satisfeito com a configuração, escolha **Criar pipeline** para comece a implantação e a criação dos recursos do pipeline. A criação do pipeline leva até 5 minutos, dependendo do tipo de fonte. Após a conclusão, você será direcionado para a guia Pipelines no console de ingestão.

**Importante**  
As configurações do processador de pipeline são registradas em log de eventos do AWS CloudTrail para fins de auditoria e conformidade. Para proteger as informações sensíveis, não inclua senhas, chaves de API ou outras informações sensíveis nas configurações do processador.