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

4.4. 내보내기

내보내기 프로그램은 하나 이상의 백엔드나 목적지로 데이터를 보냅니다. 내보내기는 푸시 또는 풀 기반일 수 있습니다. 기본적으로 내보내기는 구성되지 않습니다. 하나 이상의 내보내기를 구성해야 합니다. 내보내기는 하나 이상의 데이터 소스를 지원할 수 있습니다. 내보내기는 기본 설정과 함께 사용할 수 있지만 대상 및 보안 설정을 지정하려면 많은 내보내기 구성이 필요합니다.

현재 OpenTelemetry의 Red Hat 빌드에 사용할 수 있는 일반 공급 및 기술 미리 보기 내보내기 프로그램은 다음과 같습니다.

4.4.1. OTLP 내보내기
링크 복사

OTLP gRPC Exporter는 OpenTelemetry 프로토콜(OTLP)을 사용하여 추적 및 메트릭을 내보냅니다.

OTLP Exporter가 활성화된 OpenTelemetry Collector 사용자 정의 리소스

# ...
  config:
    exporters:
      otlp:
        endpoint: tempo-ingester:4317
1 

        tls:
2 

          ca_file: ca.pem
          cert_file: cert.pem
          key_file: key.pem
          insecure: false
3 

          insecure_skip_verify: false #
4 

          reload_interval: 1h
5 

          server_name_override: <name>
6 

        headers:
7 

          X-Scope-OrgID: "dev"
    service:
      pipelines:
        traces:
          exporters: [otlp]
        metrics:
          exporters: [otlp]
# ...
Copy to Clipboard Toggle word wrap

1
OTLP gRPC 끝점입니다. https:// 스키마를 사용하는 경우 클라이언트 전송 보안이 활성화되고 tls의 insecure 설정을 덮어씁니다.
2
클라이언트 측 TLS 구성. TLS 인증서의 경로를 정의합니다.
3
true로 설정된 경우 클라이언트 전송 보안을 비활성화합니다. 기본값은 기본적으로 false 입니다.
4
true로 설정된 경우 인증서 확인을 건너뜁니다. 기본값은 false입니다.
5
인증서를 다시 로드하는 시간 간격을 지정합니다. 값을 설정하지 않으면 인증서가 다시 로드되지 않습니다. reload_interval은 ns, us (또는 µs), ms, s, m, h 와 같은 유효한 시간 단위를 포함하는 문자열을 허용합니다.
6
요청의 권한 헤더 필드와 같은 권한의 가상 호스트 이름을 재정의합니다. 테스트에 이 값을 사용할 수 있습니다.
7
설정된 연결 중에 수행되는 모든 요청에 대해 헤더가 전송됩니다.

4.4.2. OTLP HTTP 내보내기
링크 복사

OTLP HTTP Exporter는 OpenTelemetry 프로토콜(OTLP)을 사용하여 추적 및 메트릭을 내보냅니다.

OTLP Exporter가 활성화된 OpenTelemetry Collector 사용자 정의 리소스

# ...
  config:
    exporters:
      otlphttp:
        endpoint: http://tempo-ingester:4318
1 

        tls:
2 

        headers:
3 

          X-Scope-OrgID: "dev"
        disable_keep_alives: false
4 


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

1
OTLP HTTP 끝점입니다. https:// 스키마를 사용하는 경우 클라이언트 전송 보안이 활성화되고 tls의 insecure 설정을 덮어씁니다.
2
클라이언트 측 TLS 구성입니다. TLS 인증서의 경로를 정의합니다.
3
헤더는 모든 HTTP 요청에 전송됩니다.
4
true이면 HTTP keep-alives가 비활성화됩니다. 단일 HTTP 요청에 대해서만 서버 연결을 사용합니다.

4.4.3. 디버그 내보내기
링크 복사

디버그 내보내기 기능은 추적 및 측정 항목을 표준 출력으로 인쇄합니다.

디버그 내보내기가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    exporters:
      debug:
        verbosity: detailed
1 

        sampling_initial: 5
2 

        sampling_thereafter: 200
3 

        use_internal_logger: true
4 

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

1
디버그 내보내기의 자세한 정도: 상세 , 일반 또는 기본 . 자세히 설정하면 파이프라인 데이터가 자세하게 기록됩니다. 기본값은 normal입니다.
2
초당 기록되는 초기 메시지 수입니다. 기본값은 초당 2개의 메시지입니다.
3
최초 메시지 수 이후의 샘플링 속도( sampling_initial 의 값)가 기록되었습니다. 기본적으로 비활성화되어 있으며 기본값은 1입니다 . 샘플링은 1 보다 큰 값으로 활성화됩니다. 자세한 내용은 Go 프로젝트 웹사이트의 zapcore 패키지에 있는 샘플러 함수 페이지를 참조하세요.
4
true 로 설정하면 Exporter의 Collector 내부 로거에서 출력이 활성화됩니다.

4.4.4. 로드 밸런싱 내보내기
링크 복사

로드 밸런싱 내보내기는 routing_key 구성에 따라 스팬, 메트릭 및 로그를 지속적으로 내보냅니다.

중요

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

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

로드 밸런싱 내보내기가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    exporters:
      loadbalancing:
        routing_key: "service"
1 

        protocol:
          otlp:
2 

            timeout: 1s
        resolver:
3 

          static:
4 

            hostnames:
            - backend-1:4317
            - backend-2:4317
          dns:
5 

            hostname: otelcol-headless.observability.svc.cluster.local
          k8s:
6 

            service: lb-svc.kube-public
            ports:
              - 15317
              - 16317
# ...
Copy to Clipboard Toggle word wrap

1
routing_key: 서비스는 정확한 집계를 제공하기 위해 동일한 서비스 이름에 대한 스팬을 동일한 Collector 인스턴스로 내보냅니다. routing_key: traceID 는 traceID 를 기반으로 span을 내보냅니다. 암묵적인 기본값은 traceID 기반 라우팅입니다.
2
OTLP는 유일하게 지원되는 부하 분산 프로토콜입니다. OTLP 내보내기의 모든 옵션이 지원됩니다.
3
하나의 리졸버만 구성할 수 있습니다.
4
정적 리졸버는 나열된 엔드포인트에 부하를 분산합니다.
5
DNS 리졸버는 Kubernetes 헤드리스 서비스에서만 사용할 수 있습니다.
6
Kubernetes 리졸버를 권장합니다.

4.4.5. 프로메테우스 수출업체
링크 복사

Prometheus Exporter는 Prometheus 또는 OpenMetrics 형식으로 메트릭을 내보냅니다.

중요

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

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

Prometheus Exporter가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    exporters:
      prometheus:
        endpoint: 0.0.0.0:8889
1 

        tls:
2 

          ca_file: ca.pem
          cert_file: cert.pem
          key_file: key.pem
        namespace: prefix
3 

        const_labels:
4 

          label1: value1
        enable_open_metrics: true
5 

        resource_to_telemetry_conversion:
6 

          enabled: true
        metric_expiration: 180m
7 

        add_metric_suffixes: false
8 

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

1
메트릭이 노출되는 네트워크 끝점입니다. OpenTelemetry Operator의 Red Hat 빌드는 엔드포인트 필드에 지정된 포트를 <instance_name>-collector 서비스에 자동으로 노출합니다.
2
서버 측 TLS 구성입니다. TLS 인증서의 경로를 정의합니다.
3
설정된 경우 제공된 값 아래에 메트릭을 내보냅니다.
4
내보낸 모든 메트릭에 적용되는 키-값 쌍 레이블입니다.
5
true 인 경우 메트릭은 OpenMetrics 형식을 사용하여 내보내집니다. 예시는 OpenMetrics 형식으로만 내보내지며 히스토그램 및 단조적 합계 메트릭 (예: counter )에만 사용할 수 있습니다. 기본적으로 비활성되어 있습니다.
6
활성화 가 true 인 경우 모든 리소스 속성이 메트릭 레이블로 변환됩니다. 기본적으로 비활성되어 있습니다.
7
업데이트 없이 메트릭이 노출되는 기간을 정의합니다. 기본값은 5m 입니다.
8
메트릭 유형과 단위 접미사를 추가합니다. Jaeger 콘솔의 모니터 탭이 활성화된 경우 비활성화해야 합니다. 기본값은 true입니다.
참고

OpenTelemetryCollector 사용자 지정 리소스(CR)의 spec.observability.metrics.enableMetrics 필드가 true 로 설정된 경우 OpenTelemetryCollector CR은 Prometheus가 메트릭을 스크래핑할 수 있도록 Prometheus ServiceMonitor 또는 PodMonitor CR을 자동으로 생성합니다.

4.4.6. Prometheus 원격 쓰기 내보내기
링크 복사

Prometheus Remote Write Exporter는 호환 가능한 백엔드로 메트릭을 내보냅니다.

중요

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

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

Prometheus Remote Write Exporter가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    exporters:
      prometheusremotewrite:
        endpoint: "https://my-prometheus:7900/api/v1/push"
1 

        tls:
2 

          ca_file: ca.pem
          cert_file: cert.pem
          key_file: key.pem
        target_info: true
3 

        export_created_metric: true
4 

        max_batch_size_bytes: 3000000
5 

    service:
      pipelines:
        metrics:
          exporters: [prometheusremotewrite]
# ...
Copy to Clipboard Toggle word wrap

1
메트릭을 전송하기 위한 엔드포인트입니다.
2
서버 측 TLS 구성. TLS 인증서의 경로를 정의합니다.
3
true 로 설정하면 각 리소스 지표에 대한 target_info 지표를 생성합니다.
4
true 로 설정하면 요약, 히스토그램, 단조 합계 메트릭 포인트에 대한 _created 메트릭을 내보냅니다.
5
원격 쓰기 엔드포인트로 전송되는 샘플 배치의 최대 크기입니다. 이 값을 초과하면 배치 분할이 발생합니다. 기본값은 3000000으로 약 2.861메가바이트입니다.
주의
  • 이 내보내기 기능은 누적되지 않는 단조적, 히스토그램, 요약 OTLP 메트릭을 삭제합니다.
  • 원격 Prometheus 인스턴스에서 --web.enable-remote-write-receiver 기능 플래그를 활성화해야 합니다. 이것이 없으면 이 내보내기 도구를 사용하여 인스턴스에 메트릭을 푸시하는 작업이 실패합니다.

4.4.7. 카프카 익스포터
링크 복사

Kafka Exporter는 로그, 메트릭, 추적을 Kafka로 내보냅니다. 이 내보내기 프로그램은 메시지를 차단하고 일괄 처리하지 않는 동기식 프로듀서를 사용합니다. 더 높은 처리량과 복원력을 얻으려면 배치 및 대기열 재시도 프로세서와 함께 사용해야 합니다.

Kafka Exporter가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    exporters:
      kafka:
        brokers: ["localhost:9092"]
1 

        protocol_version: 2.0.0
2 

        topic: otlp_spans
3 

        auth:
          plain_text:
4 

            username: example
            password: example
          tls:
5 

            ca_file: ca.pem
            cert_file: cert.pem
            key_file: key.pem
            insecure: false
6 

            server_name_override: kafka.example.corp
7 

    service:
      pipelines:
        traces:
          exporters: [kafka]
# ...
Copy to Clipboard Toggle word wrap

1
카프카 브로커 목록 기본값은 localhost:9092 입니다.
2
카프카 프로토콜 버전. 예를 들면 2.0.0 입니다. 이 필드는 필수 항목입니다.
3
읽을 Kafka 토픽의 이름입니다. 기본값은 다음과 같습니다. 추적의 경우 otlp_spans , 메트릭의 경우 otlp_metrics , 로그의 경우 otlp_logs입니다 .
4
일반 텍스트 인증 구성. 생략하면 일반 텍스트 인증이 비활성화됩니다.
5
클라이언트 측 TLS 구성. TLS 인증서에 대한 경로를 정의합니다. 생략하면 TLS 인증이 비활성화됩니다.
6
서버의 인증서 체인과 호스트 이름 확인을 비활성화합니다. 기본값은 false입니다.
7
ServerName은 가상 호스팅을 지원하기 위해 클라이언트가 요청한 서버의 이름을 나타냅니다.

4.4.8. AWS CloudWatch 로그 내보내기
링크 복사

AWS CloudWatch Logs Exporter는 로그 데이터를 Amazon CloudWatch Logs 서비스로 보내고 AWS SDK for Go와 기본 자격 증명 공급자 체인을 사용하여 요청에 서명합니다.

중요

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

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

AWS CloudWatch Logs Exporter가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    exporters:
      awscloudwatchlogs:
        log_group_name: "<group_name_of_amazon_cloudwatch_logs>"
1 

        log_stream_name: "<log_stream_of_amazon_cloudwatch_logs>"
2 

        region: <aws_region_of_log_stream>
3 

        endpoint: <protocol><service_endpoint_of_amazon_cloudwatch_logs>
4 

        log_retention: <supported_value_in_days>
5 

# ...
Copy to Clipboard Toggle word wrap

1
필수 항목입니다. 로그 그룹이 아직 존재하지 않으면 자동으로 생성됩니다.
2
필수 항목입니다. 로그 스트림이 아직 존재하지 않으면 자동으로 생성됩니다.
3
선택 사항입니다. AWS 지역이 기본 자격 증명 체인에 아직 설정되지 않은 경우 지정해야 합니다.
4
선택 사항입니다. 요청이 전달되는 기본 Amazon CloudWatch Logs 서비스 엔드포인트를 재정의할 수 있습니다. 엔드포인트 값의 일부로 https:// 와 같은 프로토콜을 포함해야 합니다. 지역별 서비스 엔드포인트 목록은 Amazon CloudWatch Logs 엔드포인트 및 할당량 (AWS 일반 참조)을 참조하세요.
5
선택 사항입니다. 이 매개변수를 사용하면 새로운 Amazon CloudWatch 로그 그룹에 대한 로그 보존 정책을 설정할 수 있습니다. 이 매개변수를 생략하거나 0 으로 설정하면 기본적으로 로그가 만료되지 않습니다. 보존 기간(일)에 지원되는 값은 1 , 3 , 5 , 7 , 14 , 30 , 60 , 90 , 120 , 150 , 180 , 365 , 400 , 545 , 731 , 1827 , 2192 , 2557 , 2922 , 3288 또는 3653 입니다.

4.4.9. AWS EMF 내보내기
링크 복사

AWS EMF Exporter는 다음 OpenTelemetry 메트릭 데이터 포인트를 AWS CloudWatch Embedded Metric Format(EMF)으로 변환합니다.

  • Int64DataPoints
  • DoubleDataPoints
  • SummaryDataPoints

그런 다음 EMF 메트릭은 PutLogEvents API를 사용하여 Amazon CloudWatch Logs 서비스로 직접 전송됩니다.

이 내보내기 기능을 사용하면 얻을 수 있는 이점 중 하나는 https://console.aws.amazon.com/cloudwatch/ 에서 Amazon CloudWatch 콘솔에서 로그와 지표를 볼 수 있다는 것입니다.

중요

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

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

활성화된 AWS EMF Exporter가 있는 OpenTelemetry Collector 사용자 정의 리소스

# ...
  config:
    exporters:
      awsemf:
        log_group_name: "<group_name_of_amazon_cloudwatch_logs>"
1 

        log_stream_name: "<log_stream_of_amazon_cloudwatch_logs>"
2 

        resource_to_telemetry_conversion:
3 

          enabled: true
        region: <region>
4 

        endpoint: <protocol><endpoint>
5 

        log_retention: <supported_value_in_days>
6 

        namespace: <custom_namespace>
7 

# ...
Copy to Clipboard Toggle word wrap

1
사용자 정의된 로그 그룹 이름입니다.
2
사용자 정의된 로그 스트림 이름입니다.
3
선택 사항입니다. 리소스 속성을 메트릭 레이블과 같은 원격 측정 속성으로 변환합니다. 기본적으로 비활성되어 있습니다.
4
로그 스트림의 AWS 지역입니다. 기본 자격 증명 공급자 체인에 지역이 아직 설정되지 않은 경우 지역을 지정해야 합니다.
5
선택 사항입니다. 요청이 전달되는 기본 Amazon CloudWatch Logs 서비스 엔드포인트를 재정의할 수 있습니다. 엔드포인트 값의 일부로 https:// 와 같은 프로토콜을 포함해야 합니다. 지역별 서비스 엔드포인트 목록은 Amazon CloudWatch Logs 엔드포인트 및 할당량 (AWS 일반 참조)을 참조하세요.
6
선택 사항입니다. 이 매개변수를 사용하면 새로운 Amazon CloudWatch 로그 그룹에 대한 로그 보존 정책을 설정할 수 있습니다. 이 매개변수를 생략하거나 0 으로 설정하면 기본적으로 로그가 만료되지 않습니다. 보존 기간(일)에 지원되는 값은 1 , 3 , 5 , 7 , 14 , 30 , 60 , 90 , 120 , 150 , 180 , 365 , 400 , 545 , 731 , 1827 , 2192 , 2557 , 2922 , 3288 또는 3653 입니다.
7
선택 사항입니다. Amazon CloudWatch 메트릭에 대한 사용자 정의 네임스페이스입니다.
로그 그룹 이름

log_group_name 매개변수를 사용하면 로그 그룹 이름을 사용자 정의할 수 있으며 기본 /metrics/default 값 또는 다음 플레이스홀더를 지원합니다.

/aws/metrics/{ClusterName}
이 플레이스홀더는 메트릭 데이터에서 ClusterName 또는 aws.ecs.cluster.name 리소스 속성을 검색하여 실제 클러스터 이름으로 바꾸는 데 사용됩니다.
{NodeName}
이 플레이스홀더는 NodeName 또는 k8s.node.name 리소스 속성을 검색하는 데 사용됩니다.
{TaskId}
이 플레이스홀더는 TaskId 또는 aws.ecs.task.id 리소스 속성을 검색하는 데 사용됩니다.

리소스 속성 맵에서 리소스 속성을 찾을 수 없는 경우 플레이스홀더는 정의되지 않은 값으로 대체됩니다.

로그 스트림 이름

log_stream_name 매개변수를 사용하면 로그 스트림 이름을 사용자 정의할 수 있으며 기본 otel-stream 값이나 다음 플레이스홀더를 지원합니다.

{ClusterName}
이 플레이스홀더는 ClusterName 또는 aws.ecs.cluster.name 리소스 속성을 검색하는 데 사용됩니다.
{ContainerInstanceId}
이 플레이스홀더는 ContainerInstanceId 또는 aws.ecs.container.instance.id 리소스 속성을 검색하는 데 사용됩니다. 이 리소스 속성은 AWS ECS EC2 시작 유형에만 유효합니다.
{NodeName}
이 플레이스홀더는 NodeName 또는 k8s.node.name 리소스 속성을 검색하는 데 사용됩니다.
{TaskDefinitionFamily}
이 플레이스홀더는 TaskDefinitionFamily 또는 aws.ecs.task.family 리소스 속성을 검색하는 데 사용됩니다.
{TaskId}
이 플레이스홀더는 메트릭 데이터에서 TaskId 또는 aws.ecs.task.id 리소스 속성을 검색하여 실제 작업 ID로 대체하는 데 사용됩니다.

리소스 속성 맵에서 리소스 속성을 찾을 수 없는 경우 플레이스홀더는 정의되지 않은 값으로 대체됩니다.

4.4.10. AWS X-Ray Exporter
링크 복사

AWS X-Ray Exporter는 OpenTelemetry 스팬을 AWS X-Ray 세그먼트 문서로 변환한 다음 이를 AWS X-Ray 서비스로 직접 전송합니다. AWS X-Ray Exporter는 PutTraceSegments API를 사용하고 AWS SDK for Go와 기본 자격 증명 공급자 체인을 사용하여 요청에 서명합니다.

중요

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

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

AWS X-Ray Exporter가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config:
    exporters:
      awsxray:
        region: "<region>"
1 

        endpoint: <protocol><endpoint>
2 

        resource_arn: "<aws_resource_arn>"
3 

        role_arn: "<iam_role>"
4 

        indexed_attributes: [ "<indexed_attr_0>", "<indexed_attr_1>" ]
5 

        aws_log_groups: ["<group1>", "<group2>"]
6 

        request_timeout_seconds: 120
7 

# ...
Copy to Clipboard Toggle word wrap

1
AWS X-Ray 서비스로 전송되는 X-Ray 세그먼트의 대상 지역입니다. 예를 들어, eu-west-1 .
2
선택 사항입니다. 요청이 전달되는 기본 Amazon CloudWatch Logs 서비스 엔드포인트를 재정의할 수 있습니다. 엔드포인트 값의 일부로 https:// 와 같은 프로토콜을 포함해야 합니다. 지역별 서비스 엔드포인트 목록은 Amazon CloudWatch Logs 엔드포인트 및 할당량 (AWS 일반 참조)을 참조하세요.
3
수집기를 실행하는 AWS 리소스의 Amazon 리소스 이름(ARN)입니다.
4
X-Ray 세그먼트를 다른 계정에 업로드하기 위한 AWS Identity and Access Management(IAM) 역할입니다.
5
X-Ray 주석으로 변환할 속성 이름 목록입니다.
6
Amazon CloudWatch Logs의 로그 그룹 이름 목록입니다.
7
요청 시간이 초과되기 전까지의 시간(초)입니다. 생략하면 기본값은 30 입니다.

4.4.11. 파일 내보내기
링크 복사

파일 내보내기는 원격 측정 데이터를 영구 저장소의 파일에 쓰고 회전, 압축, 여러 파일에 쓰기 등의 파일 작업을 지원합니다. 이 내보내기 기능을 사용하면 리소스 속성을 사용하여 파일 이름을 제어할 수도 있습니다. 유일하게 필요한 설정은 path 입니다. 이 설정은 영구 볼륨 파일 시스템의 원격 측정 파일에 대한 대상 경로를 지정합니다.

중요

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

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

파일 내보내기가 활성화된 OpenTelemetry Collector 사용자 지정 리소스

# ...
  config: |
    exporters:
      file:
        path: /data/metrics.json
1 

        rotation:
2 

          max_megabytes: 10
3 

          max_days: 3
4 

          max_backups: 3
5 

          localtime: true
6 

        format: proto
7 

        compression: zstd
8 

        flush_interval: 5
9 

# ...
Copy to Clipboard Toggle word wrap

1
데이터가 기록될 파일 시스템 경로입니다. 기본값은 없습니다.
2
파일 순환은 이 내보내기의 선택적 기능입니다. 기본적으로 원격 측정 데이터는 단일 파일로 내보내집니다. 파일 회전을 활성화하려면 회전 설정을 추가합니다.
3
max_megabytes 설정은 파일이 회전될 때까지 허용되는 최대 크기입니다. 기본값은 100입니다.
4
max_days 설정은 파일 이름의 타임스탬프를 기준으로 파일을 보관할 일수를 설정합니다. 기본값은 없습니다.
5
max_backups 설정은 여러 개의 오래된 파일을 보존하기 위한 것입니다. 기본값은 100 입니다.
6
localtime 설정은 파일이 회전될 때 파일 이름의 모든 확장자 앞에 추가되는 타임스탬프의 로컬 시간 형식을 지정합니다. 기본값은 협정 세계시(UTC)입니다.
7
원격 측정 데이터를 파일에 쓰기 전에 인코딩하는 형식입니다. 기본 형식은 json 입니다. proto 형식도 지원됩니다.
8
파일 압축은 선택 사항이며 기본적으로 설정되지 않습니다. 이 설정은 파일로 내보내지는 데이터의 압축 알고리즘을 정의합니다. 현재는 zstd 압축 알고리즘만 지원됩니다. 기본값은 없습니다.
9
플러시 사이의 시간 간격. 단위가 없는 값은 나노초 단위로 설정됩니다. 파일 회전이 회전 설정을 통해 활성화된 경우 이 설정은 무시됩니다.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat