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

4.5. 커넥터

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

현재 OpenTelemetry의 Red Hat 빌드에서 다음 일반 가용성 및 기술 프리뷰 커넥터를 사용할 수 있습니다.

4.5.1. count Connector
링크 복사

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]
# ...

1
Count Connector를 파이프라인의 내보내기 또는 수신자로 올바르게 구성하고 생성된 메트릭을 올바른 내보내기로 내보내는 것이 중요합니다.
2
Count Connector는 범위를 내보내기로 수신하도록 구성되어 있습니다.
3
Count Connector는 생성된 메트릭을 수신자로 내보내도록 구성되어 있습니다.
작은 정보

Count Connector가 예상된 메트릭을 생성하지 않는 경우 OpenTelemetry 수집기가 예상 기간, 메트릭 및 로그를 수신하고 있는지 여부와 Telemetry 데이터 흐름이 예상대로 표시되는지 여부를 확인할 수 있습니다. Debug Exporter를 사용하여 들어오는 Telemetry 데이터를 검사할 수도 있습니다.

Count Connector는 정의된 조건에 따라 Telemetry 데이터를 계산하고범위, 범위, 메트릭, 데이터포인트 또는 로그 로 이러한 필드를 사용하여 구성할 때 해당 데이터를 메트릭 으로 표시할 수 있습니다. 다음 예제를 참조하십시오.

조건별 기간을 계산할 Count Connector의 OpenTelemetry Collector CR의 예

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

          <custom_metric_name>:
2 

            description: "<custom_metric_description>"
            conditions:
              - 'attributes["env"] == "dev"'
              - 'name == "devevent"'
# ...

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

조건을 올바르게 작성하고 일치하는 속성 또는 Telemetry 필드 조건에 필요한 구문을 따릅니다. 부적절하게 정의된 조건은 가장 가능성 있는 오류 소스입니다.

Count Connector는범위, 범위,메트릭, 데이터지점 또는 로그 와 같은 필드를 사용하여 구성된 경우 정의된 특성에 따라 Telemetry 데이터를 계산할 수 있습니다. 다음 예제를 참조하십시오. 속성 키는 원격 분석 데이터에 삽입됩니다. 누락된 속성의 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 

# ...

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

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

Routing Connector는 리소스 속성 및 라우팅 조건에 따라 지정된 파이프라인에 로그, 메트릭 및 추적을 라우팅하며, 이는 OpenTelemetry Language(OTTL) 문으로 작성됩니다.

중요

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

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

활성화된 라우팅 커넥터가 있는 OpenTelemetry 수집기 사용자 정의 리소스

# ...
  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]
# ...

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

4.5.3. Forward Connector
링크 복사

Forward Connector는 동일한 유형의 두 파이프라인을 병합합니다.

중요

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

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

활성화된 Forward Connector가 있는 OpenTelemetry 수집기 사용자 정의 리소스

# ...
  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]
# ...

4.5.4. Spanmetrics Connector
링크 복사

Spanmetrics Connector는 범위 데이터에서 요청, 오류 및 기간(R.E.D) OpenTelemetry 메트릭을 집계합니다.

활성화된 Spanmetrics 커넥터가 있는 OpenTelemetry 수집기 사용자 정의 리소스

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

    service:
      pipelines:
        traces:
          exporters: [spanmetrics]
        metrics:
          receivers: [spanmetrics]
# ...

1
생성된 지표의 플러시 간격을 정의합니다. 기본값은 15s 입니다.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2026 Red Hat맨 위로 이동