OTel trace group processor

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

OTel trace group 프로세서

otel_trace_group 프로세서는 span 레코드 모음에서 누락된 trace‑group 관련 필드를 OpenSearch 백엔드를 조회해서 완성해요. otel_trace_group 프로세서는 spanId에 대한 누락된 trace group 정보를 OpenSearch에 저장된 해당 루트 span의 관련 필드를 조회해서 식별해요.

OpenSearch

OpenSearch 클러스터에 사용자 이름과 비밀번호로 연결할 때는 다음 예시 pipeline.yaml 파일을 사용해서 otel_trace_group 프로세서를 구성하세요.

pipeline:
  ...
  processor:
    - otel_trace_group:
        hosts: ["https://localhost:9200"]
        cert: path/to/cert
        username: YOUR_USERNAME_HERE
        password: YOUR_PASSWORD_HERE

OTel trace group 프로세서에 필요한 OpenSearch 자격 증명과 권한 및 해당 자격 증명을 구성하는 방법에 대한 자세한 설명은 OpenSearch security를 참조하세요.

Amazon OpenSearch Service

Amazon OpenSearch Service를 사용할 때는 다음 예시 pipeline.yaml 파일을 사용해서 otel_trace_group 프로세서를 구성하세요.

pipeline:
  ...
  processor:
    - otel_trace_group:
        hosts: ["https://your-amazon-opensearch-service-endpoint"]
        aws_sigv4: true
        cert: path/to/cert
        insecure: false

구성

otel_trace_group 프로세서는 다음 옵션으로 구성할 수 있어요.

Name	Description	Default value
`hosts`	OpenSearch 노드의 IP 주소 목록. 필수.	기본값 없음.
`cert`	PEM 인코딩된 인증 기관(CA) 인증서. .pem 또는 .crt를 허용해요. 이는 클라이언트가 OpenSearch에서 사용하는 인증서에 서명한 CA를 신뢰할 수 있게 해요.	`null`
`aws_sigv4`	HTTP 요청에 AWS 자격 증명으로 서명하는 데 사용되는 불리언 플래그예요. Amazon OpenSearch Service에만 적용돼요. 자세한 내용은 OpenSearch security를 참조하세요.	`false`.
`aws_region`	Amazon OpenSearch Service 도메인의 AWS 리전을 나타내는 문자열이에요(예: `us-west-2`). Amazon OpenSearch Service에만 적용돼요.	`us-east-1`
`aws_sts_role_arn`	싱크 플러그인이 Amazon OpenSearch Service에 요청을 서명하기 위해 가정하는 AWS Identity and Access Management(IAM) 역할이에요. 제공되지 않으면 플러그인은 기본 자격 증명을 사용해요.	`null`
`aws_sts_header_overrides`	싱크 플러그인에 대해 IAM 역할이 가정하는 헤더 재정의 맵이에요.	`null`
`insecure`	SSL 인증서 확인을 해제하는 불리언 플래그예요. `true`로 설정하면 CA 인증서 확인이 해제되고 안전하지 않은 HTTP 요청이 전송돼요.	`false`
`username`	OpenSearch 클러스터의 내부 사용자 `YAML` 구성 파일에 사용되는 사용자 이름을 포함하는 문자열이에요.	`null`
`password`	OpenSearch 클러스터의 내부 사용자 `YAML` 구성 파일에 사용되는 비밀번호를 포함하는 문자열이에요.	`null`

구성 옵션 예시

aws_sts_header_overrides 옵션에서 구성 옵션 값을 정의할 수 있어요. 다음 예시를 참조하세요.

aws_sts_header_overrides:
  x-my-custom-header-1: my-custom-value-1
  x-my-custom-header-2: my-custom-value-2

메트릭

다음 표는 otel_trace_group 프로세서에 특화된 사용자 정의 메트릭을 설명해요.

Metric name	Type	Description
`recordsInMissingTraceGroup`	Counter	수신 레코드 중 trace group 필드가 누락된 개수예요.
`recordsOutFixedTraceGroup`	Counter	송신 레코드 중 trace group 필드가 성공적으로 완료된 개수예요.
`recordsOutMissingTraceGroup`	Counter	송신 레코드 중 trace group 필드가 누락된 개수예요.

더 알아보기 (Learn more)

원문 전체: https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/processors/otel-trace-group/