# 处理器兼容性和限制
<a name="processor-compatibility"></a>一般处理器规则

最大计数  
一个管道最多可以有 20 个处理器。

解析器放置  
解析器处理器（若使用，例如 OCSF、CSV、Grok 等）必须是管道中的第一个处理器。

唯一的处理器  
以下处理器在每个管道中只能出现一次：  
+ `add_entries`
+ `copy_values`


| 处理器类型 | CloudWatch Logs 来源 | S3 来源 | 基于 API 的来源 | 
| --- | --- | --- | --- | 
| OCSF | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 
| parse\$1vpc | 必须是第一个处理器 | 不适用 | 不适用 | 
| parse\$1route53 | 必须是第一个处理器 | 不适用 | 不适用 | 
| parse\$1json | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 
| grok | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 
| csv | 必须是第一个处理器 | 不兼容 | 不兼容 | 
| key\$1value | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 
| add\$1entries | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 
| copy\$1values | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 
| 字符串处理器（lowercase、uppercase、trim） | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 
| 字段处理器（move\$1keys、rename\$1keys） | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 
| 数据转换（date、flatten） | 必须是第一个处理器 | 必须是第一个处理器 | 必须是第一个处理器 | 

**兼容性定义**  

必须是第一个处理器  
使用时，必须是管道配置中的第一个处理器

不兼容  
不能与此来源类型一起使用

不适用  
处理器与此来源类型无关

## 特定于处理器的限制
<a name="processor-specific-restrictions"></a>


**按来源类型划分的处理器限制**  

| 处理器 | 源类型 | 限制 | 
| --- | --- | --- | 
| OCSF | CloudWatch Logs 和 CloudTrail |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| OCSF | 基于 API 的来源 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| parse\$1vpc | CloudWatch Logs |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| parse\$1route53 | CloudWatch Logs |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| add\$1entries | 所有来源 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 
| copy\$1values | 所有来源 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/AmazonCloudWatch/latest/monitoring/processor-compatibility.html)  | 

**重要**  
使用具有限制的处理器时：  
在部署之前，请务必使用 `ValidateTelemetryPipelineConfiguration` API 验证您的管道配置
通过 `TestTelemetryPipeline` API 使用示例数据测试管道，确保正确处理
部署后监控管道指标，确保事件按预期处理