# Compatibilidade e restrições de processador
<a name="processor-compatibility"></a>Regras gerais de processador

Número máximo  
Um pipeline pode ter no máximo 20 processadores.

Posicionamento do analisador  
Os processadores de análise (OCSF, CSV, Grok etc.), se usados, devem ser o primeiro processador em um pipeline.

Processadores exclusivos  
Os processadores a seguir só podem aparecer uma vez por pipeline:  
+ `add_entries`
+ `copy_values`


| Tipo de processador | Fonte do CloudWatch Logs | Fonte do S3 | Fontes baseadas em API | 
| --- | --- | --- | --- | 
| OCSF | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 
| parse\$1vpc | Deve ser o primeiro processador | Não aplicável | Não aplicável | 
| parse\$1route53 | Deve ser o primeiro processador | Não aplicável | Não aplicável | 
| parse\$1json | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 
| grok | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 
| csv | Deve ser o primeiro processador | Não compatível | Não compatível | 
| key\$1value | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 
| add\$1entries | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 
| copy\$1values | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 
| Processadores de string (lowercase, uppercase, trim) | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 
| Processadores de campo (move\$1keys, rename\$1keys) | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 
| Transformação de dados (date, flatten) | Deve ser o primeiro processador | Deve ser o primeiro processador | Deve ser o primeiro processador | 

**Definições de compatibilidade**  

Deve ser o primeiro processador  
Quando usado, deve ser o primeiro processador na configuração do pipeline

Não compatível  
Não pode ser usado com esse tipo de origem

Não aplicável  
O processador não é relevante para esse tipo de origem

## Restrições específicas do processador
<a name="processor-specific-restrictions"></a>


**Restrições de processador por tipo de origem**  

| Processor | Source type (Tipo de origem) | Restrições | 
| --- | --- | --- | 
| OCSF | CloudWatch Logs com CloudTrail |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| OCSF | Fontes baseadas em API |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| parse\$1vpc | CloudWatch Logs |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| parse\$1route53 | CloudWatch Logs |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| add\$1entries | Todas as origens |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| copy\$1values | Todas as origens |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 

**Importante**  
Ao usar processadores com restrições:  
Sempre valide a configuração do pipeline usando a API `ValidateTelemetryPipelineConfiguration` antes da implantação
Teste o pipeline com dados de amostra usando a API `TestTelemetryPipeline` para garantir o processamento adequado
Monitore as métricas do pipeline após a implantação para garantir que os eventos sejam processados como esperado