Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

4.5. 커넥터

커넥터는 두 개의 파이프라인을 연결합니다. 파이프라인의 끝에서는 내보내기 역할을 하여 데이터를 사용하고, 다른 파이프라인의 시작에서는 받기 역할로 데이터를 내보냅니다. 동일하거나 다른 데이터 유형의 데이터를 사용하고 방출할 수 있습니다. 소비된 데이터를 요약하기 위해 데이터를 생성하고 방출할 수도 있고, 단순히 데이터를 복제하거나 라우팅할 수도 있습니다.

현재 OpenTelemetry의 Red Hat 빌드에 사용할 수 있는 일반 공급 및 기술 미리 보기 커넥터는 다음과 같습니다.

4.5.1. 카운트 커넥터
링크 복사

Count Connector는 내보내기 파이프라인의 추적 범위, 추적 범위 이벤트, 메트릭, 메트릭 데이터 포인트 및 로그 레코드를 계산합니다.

중요

Count Connector는 기술 미리보기 기능일 뿐입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

기본 메트릭 이름은 다음과 같습니다.

  • trace.span.count
  • trace.span.event.count
  • metric.count
  • metric.datapoint.count
  • log.record.count

사용자 정의 메트릭 이름을 공개할 수도 있습니다.

활성화된 Count Connector가 있는 OpenTelemetry Collector 사용자 지정 리소스(CR)

# ...
  config:
    receivers:
      otlp:
        protocols:
          grpc:
            endpoint: 0.0.0.0:4317
    exporters:
      prometheus:
        endpoint: 0.0.0.0:8889
    connectors:
      count: {}
    service:
      pipelines:
1 

        traces/in:
          receivers: [otlp]
          exporters: [count]
2 

        metrics/out:
          receivers: [count]
3 

          exporters: [prometheus]
# ...
Copy to Clipboard Toggle word wrap

1
파이프라인에서 Count Connector를 내보내기 또는 수신자로 올바르게 구성하고 생성된 메트릭을 올바른 내보내기로 내보내는 것이 중요합니다.
2
Count Connector는 내보내기 도구로서 스팬을 수신하도록 구성됩니다.
3
Count Connector는 생성된 메트릭을 수신기로서 방출하도록 구성됩니다.
작은 정보

Count Connector가 예상한 메트릭을 생성하지 못하는 경우 OpenTelemetry Collector가 예상한 스팬, 메트릭 및 로그를 수신하고 있는지, 그리고 원격 측정 데이터가 예상대로 Count Connector를 통해 흐르는지 확인할 수 있습니다. 디버그 내보내기 기능을 사용하여 수신 원격 측정 데이터를 검사할 수도 있습니다.

Count Connector는 정의된 조건에 따라 원격 측정 데이터를 계산하고 spans , spanevents , metrics , datapoints 또는 log 와 같은 필드를 사용하여 구성하면 해당 데이터를 메트릭으로 노출할 수 있습니다. 다음 예를 보세요.

조건에 따라 스팬을 계산하기 위한 Count Connector에 대한 OpenTelemetry Collector CR 예시

# ...
  config:
    connectors:
      count:
        spans:
1 

          <custom_metric_name>:
2 

            description: "<custom_metric_description>"
            conditions:
              - 'attributes["env"] == "dev"'
              - 'name == "devevent"'
# ...
Copy to Clipboard Toggle word wrap

1
이 예에서 노출된 메트릭 수는 지정된 조건에 따라 계산됩니다.
2
cluster.prod.event.count 와 같은 사용자 정의 메트릭 이름을 지정할 수 있습니다.
작은 정보

조건을 올바르게 작성하고 속성 일치 또는 원격 측정 필드 조건에 필요한 구문을 따르세요. 잘못 정의된 조건은 오류가 발생할 가능성이 가장 높습니다.

Count Connector는 spans , spanevents , metrics , datapoints 또는 log 와 같은 필드를 사용하여 구성된 경우 정의된 속성에 따라 원격 측정 데이터를 계산할 수 있습니다. 다음 예를 보세요. 속성 키는 원격 측정 데이터에 삽입됩니다. 누락된 속성의 default_value 필드 값을 정의해야 합니다.

속성별로 로그를 계산하기 위한 Count Connector에 대한 OpenTelemetry Collector CR 예시

# ...
  config:
    connectors:
      count:
        logs:
1 

          <custom_metric_name>:
2 

            description: "<custom_metric_description>"
            attributes:
              - key: env
                default_value: unknown
3 

# ...
Copy to Clipboard Toggle word wrap

1
로그에 대한 속성을 지정합니다.
2
my.log.count 와 같이 사용자 정의 메트릭 이름을 지정할 수 있습니다.
3
속성이 설정되지 않은 경우 기본값을 정의합니다.

4.5.2. 라우팅 커넥터
링크 복사

라우팅 커넥터는 리소스 속성과 라우팅 조건에 따라 로그, 메트릭 및 추적을 지정된 파이프라인으로 라우팅합니다. 이러한 리소스 속성과 라우팅 조건은 OTTL(OpenTelemetry Transformation Language) 문으로 작성됩니다.

중요

라우팅 커넥터는 기술 미리 보기 기능에 불과합니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

라우팅 커넥터가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    connectors:
      routing:
        table:
1 

          - statement: route() where attributes["X-Tenant"] == "dev"
2 

            pipelines: [traces/dev]
3 

          - statement: route() where attributes["X-Tenant"] == "prod"
            pipelines: [traces/prod]
        default_pipelines: [traces/dev]
4 

        error_mode: ignore
5 

        match_once: false
6 

    service:
      pipelines:
        traces/in:
          receivers: [otlp]
          exporters: [routing]
        traces/dev:
          receivers: [routing]
          exporters: [otlp/dev]
        traces/prod:
          receivers: [routing]
          exporters: [otlp/prod]
# ...
Copy to Clipboard Toggle word wrap

1
커넥터 라우팅 테이블.
2
OTTL 문으로 작성된 라우팅 조건입니다.
3
일치하는 원격 측정 데이터를 라우팅하기 위한 대상 파이프라인입니다.
4
라우팅 조건이 충족되지 않은 원격 측정 데이터를 라우팅하기 위한 대상 파이프라인입니다.
5
오류 처리 모드: 전파 값은 오류를 기록하고 페이로드를 삭제하기 위한 것입니다. 무시 값은 조건을 무시하고 다음 조건과 일치를 시도하기 위한 것입니다. silent 값은 ignore 와 동일하지만 오류를 기록하지 않습니다. 기본값은 전파 입니다.
6
true 로 설정하면, 페이로드는 라우팅 조건이 충족되는 첫 번째 파이프라인에만 라우팅됩니다. 기본값은 false입니다.

4.5.3. 포워드 커넥터
링크 복사

포워드 커넥터는 동일한 유형의 두 파이프라인을 병합합니다.

중요

포워드 커넥터는 기술 미리보기 기능일 뿐입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

활성화된 Forward Connector가 있는 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    receivers:
      otlp:
        protocols:
          grpc:
      jaeger:
        protocols:
          grpc:
    processors:
      batch:
    exporters:
      otlp:
        endpoint: tempo-simplest-distributor:4317
        tls:
          insecure: true
    connectors:
      forward: {}
    service:
      pipelines:
        traces/regiona:
          receivers: [otlp]
          processors: []
          exporters: [forward]
        traces/regionb:
          receivers: [jaeger]
          processors: []
          exporters: [forward]
        traces:
          receivers: [forward]
          processors: [batch]
          exporters: [otlp]
# ...
Copy to Clipboard Toggle word wrap

4.5.4. 스팬메트릭스 커넥터
링크 복사

Spanmetrics 커넥터는 스팬 데이터에서 요청, 오류, 기간(RED) OpenTelemetry 메트릭을 집계합니다.

Spanmetrics 커넥터가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    connectors:
      spanmetrics:
        metrics_flush_interval: 15s
1 

    service:
      pipelines:
        traces:
          exporters: [spanmetrics]
        metrics:
          receivers: [spanmetrics]
# ...
Copy to Clipboard Toggle word wrap

1
생성된 메트릭의 플러시 간격을 정의합니다. 기본값은 15초 입니다.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat