# 프로세서 호환성 및 제한 사항
<a name="processor-compatibility"></a>일반 프로세서 규칙

최대 개수  
파이프라인 1개에 최대 20개의 프로세서까지 가능합니다.

파서 배치  
구문 분석기 프로세서(OCSF, CSV, Grok 등)를 사용하는 경우 파이프라인의 첫 번째 프로세서여야 합니다.

고유 프로세서  
다음 프로세서는 파이프라인당 한 번만 표시될 수 있습니다.  
+ `add_entries`
+ `copy_values`


| 프로세서 유형 | CloudWatch Logs 소스 | S3 소스 | API 기반 소스 | 
| --- | --- | --- | --- | 
| OCSF | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 
| parse\_vpc | 첫 번째 프로세서여야 합니다. | 해당 사항 없음 | 해당 사항 없음 | 
| parse\_route53 | 첫 번째 프로세서여야 합니다. | 해당 사항 없음 | 해당 사항 없음 | 
| parse\_rds | 첫 번째 프로세서여야 합니다. | 해당 사항 없음 | 해당 사항 없음 | 
| parse\_json | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 
| grok | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 
| csv | 첫 번째 프로세서여야 합니다. | 호환되지 않음 | 호환되지 않음 | 
| key\_value | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 
| add\_entries | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 
| copy\_values | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 
| 문자열 프로세서(소문자, 대문자, 자르기) | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 
| 필드 프로세서(move\_keys, rename\_keys) | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 
| 데이터 변환(날짜, 평면화) | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 첫 번째 프로세서여야 합니다. | 

**호환성 정의**  

첫 번째 프로세서여야 합니다.  
사용할 경우 파이프라인 구성에서 첫 번째 프로세서여야 합니다.

호환되지 않음  
이 소스 유형과 함께 사용할 수 없습니다.

해당 사항 없음  
프로세서가 이 소스 유형과 관련이 없습니다.

## 프로세서별 제한 사항
<a name="processor-specific-restrictions"></a>

다음 표에서는 소스 유형별 프로세서 제한 사항을 설명합니다.


| 처리자 | 소스 유형 | 제한 사항 | 
| --- | --- | --- | 
| OCSF | CloudWatch 로그를 CloudTrail과 함께 사용 |  +  `data_source_name`이 `aws_cloudtrail`인 경우에만 허용됩니다. <br />+  CloudTrail 전용 스키마 버전을 사용해야 합니다. <br />+  다른 프로세서와 조합할 수 없습니다.   | 
| OCSF | API 기반 소스 |  +  소스 전용 스키마(예: Office 365는 microsoft\_office365\_management\_activity)를 사용해야 함 <br />+  각 소스 유형에 대한 특정 매핑 버전이 필요합니다. <br />+  파이프라인의 첫 번째 프로세서여야 합니다.   | 
| parse\_vpc | CloudWatch Logs |  +  VPC 흐름 로그에만 유효합니다. <br />+  첫 번째 프로세서여야 합니다. <br />+  입력에 원시 VPC 흐름 로그 형식이 포함되어야 합니다.   | 
| parse\_route53 | CloudWatch Logs |  +  Route 53 Resolver 쿼리 로그에만 유효합니다. <br />+  첫 번째 프로세서여야 합니다. <br />+  입력에 Route 53 Resolver 쿼리 로그 형식이 포함되어야 합니다.   | 
| parse\_rds | CloudWatch Logs |  +  `data_source_name`이 `amazon_rds`인 경우에만 유효 <br />+  첫 번째 프로세서여야 합니다. <br />+  파라미터를 가져오지 않습니다. 로그 유형은 파이프라인의 `data_source_type`에서 추론됩니다.   | 
| add\_entries | 모든 소스 |  +  파이프라인당 최대 1개의 인스턴스 <br />+  키 이름은 필드 이름 지정 규칙에 따라 유효해야 합니다.   | 
| copy\_values | 모든 소스 |  +  파이프라인당 최대 1개의 인스턴스 <br />+  소스 필드가 이벤트 내에 존재해야 합니다.   | 

**중요**  
제한 사항이 있는 프로세서를 사용할 경우:  
배포 전에 항상 `ValidateTelemetryPipelineConfiguration` API를 사용하여 파이프라인 구성을 검증합니다.
`TestTelemetryPipeline` API를 사용해 샘플 데이터로 파이프라인을 테스트하여 올바르게 처리되는지 확인
배포 후 파이프라인 지표를 모니터링하여 이벤트가 예상되로 처리되는지 확인