3.4. 내보내기
내보내기는 데이터를 하나 이상의 백엔드 또는 대상에 보냅니다. 내보내기는 푸시 또는 풀 기반일 수 있습니다. 기본적으로 내보내기는 구성되지 않습니다. 하나 이상의 내보내기를 구성해야 합니다. 내보내기는 하나 이상의 데이터 소스를 지원할 수 있습니다. 내보내기는 기본 설정과 함께 사용할 수 있지만 대상 및 보안 설정을 지정하려면 많은 내보내기 구성이 필요합니다.
현재 OpenTelemetry의 Red Hat 빌드에서 다음 일반 가용성 및 기술 프리뷰 내보내기를 사용할 수 있습니다.
3.4.1. OTLP Exporter
OTLP gRPC Exporter는 OTLP(OpenTelemetry 프로토콜)를 사용하여 추적 및 메트릭을 내보냅니다.
활성화된 OTLP Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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] # ...
- 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
- 설정된 연결 중에 수행되는 모든 요청에 대해 헤더가 전송됩니다.
3.4.2. OTLP HTTP Exporter
OTLP HTTP Exporter는 OTLP(OpenTelemetry 프로토콜)를 사용하여 추적 및 메트릭을 내보냅니다.
활성화된 OTLP Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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] # ...
3.4.3. 디버그 내보내기
디버그 내보내기는 추적 및 메트릭을 표준 출력에 출력합니다.
활성화된 디버그 내보내기가 활성화된 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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] # ...
- 1
- 디버그 내보내기의 상세 정보 표시:
세부
정보 ,일반
또는기본
.세부
정보로 설정하면 파이프라인 데이터가 세부적으로 기록됩니다. 기본값은normal
입니다. - 2
- 초당 기록되는 초기 메시지 수입니다. 기본값은 초당
2
개의 메시지입니다. - 3
- 초기 메시지 수 이후 샘플링 속도는
sampling_initial
의 값이 기록되었습니다. 기본적으로 기본1
값으로 비활성화되어 있습니다. 샘플링은1
보다 큰 값으로 활성화됩니다. 자세한 내용은 Go 프로젝트의 웹 사이트의zapcore
패키지에서 샘플러 기능에 대한 페이지를 참조하십시오. - 4
true
로 설정하면 내보내기에 대한 수집기의 내부 로거에서 출력을 활성화합니다.
3.4.4. Load Balancing Exporter
Load Balancing Exporter는 routing_key
구성에 따라 범위, 메트릭 및 로그를 일관되게 내보냅니다.
Load Balancing Exporter는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
활성화된 Load Balancing Exporter를 사용하는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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 # ...
- 1
routing_key: 서비스는
정확한 집계를 제공하기 위해 동일한 서비스 이름에 대한 기간을 동일한 수집기 인스턴스로 내보냅니다.routing_key: traceID
내보내기는traceID
를 기반으로 합니다. 암시적 기본값은traceID
기반 라우팅입니다.- 2
- OTLP는 지원되는 유일한 로드 밸런싱 프로토콜입니다. OTLP 내보내기의 모든 옵션이 지원됩니다.
- 3
- 하나의 해결자만 구성할 수 있습니다.
- 4
- 정적 해결 프로그램은 나열된 엔드포인트에 부하를 배포합니다.
- 5
- Kubernetes 헤드리스 서비스에서만 DNS 확인자를 사용할 수 있습니다.
- 6
- Kubernetes 확인기가 권장됩니다.
3.4.5. Prometheus Exporter
Prometheus Exporter는 Prometheus 또는 OpenMetrics 형식으로 지표를 내보냅니다.
Prometheus Exporter는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
활성화된 Prometheus Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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] # ...
- 1
- 메트릭이 노출되는 네트워크 끝점입니다. Red Hat build of OpenTelemetry Operator는
엔드포인트
필드에 지정된 포트를 <instance_name>-collector
서비스에 자동으로 노출합니다. - 2
- 서버 측 TLS 구성입니다. TLS 인증서의 경로를 정의합니다.
- 3
- 설정된 경우 제공된 값 아래에 메트릭을 내보냅니다.
- 4
- 내보낸 모든 메트릭에 적용되는 키-값 쌍 레이블입니다.
- 5
true
인 경우 OpenMetrics 형식을 사용하여 메트릭을 내보냅니다. 예시는 OpenMetrics 형식으로만 내보내지며 히스토그램 및 단조적 합계 메트릭 (예:counter
)에만 사용할 수 있습니다. 기본적으로 비활성되어 있습니다.- 6
enabled
가true
이면 모든 리소스 속성이 지표 레이블로 변환됩니다. 기본적으로 비활성되어 있습니다.- 7
- 업데이트 없이 메트릭이 노출되는 기간을 정의합니다. 기본값은
5m
입니다. - 8
- 지표 유형 및 단위 접미사를 추가합니다. Jaeger 콘솔의 모니터 탭이 활성화된 경우 비활성화해야 합니다. 기본값은
true
입니다.
OpenTelemetryCollector
CR(사용자 정의 리소스)의 spec.observability.metrics.enableMetrics
필드가 true
로 설정된 경우 OpenTelemetryCollector
CR은 Prometheus ServiceMonitor
또는 PodMonitor
CR을 자동으로 생성하여 메트릭을 스크랩할 수 있습니다.
3.4.6. Prometheus 원격 쓰기 내보내기
Prometheus Remote Write Exporter는 호환되는 백엔드에 지표를 내보냅니다.
Prometheus 원격 쓰기 내보내기는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
활성화된 Prometheus Remote Write Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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] # ...
- 이 내보내기에서는 비 누적 monotonic, 히스토그램 및 요약 OTLP 메트릭을 삭제합니다.
-
원격 Prometheus 인스턴스에서
--web.enable-remote-write-receiver
기능 플래그를 활성화해야 합니다. 그러지 않으면 이 내보내기를 사용하여 인스턴스로 메트릭을 푸시할 수 없습니다.
3.4.7. Kafka Exporter
Kafka 내보내기는 로그, 메트릭 및 추적을 Kafka로 내보냅니다. 이 내보내기에서는 메시지를 차단하고 배치하지 않는 동기 생산자를 사용합니다. 처리량과 복원력이 높기 위해 일괄 처리 및 대기열에 있는 재시도 프로세서와 함께 사용해야 합니다.
Kafka 내보내기는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
활성화된 Kafka Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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] # ...
- 1
- Kafka 브로커 목록입니다. 기본값은
localhost:9092
입니다. - 2
- Kafka 프로토콜 버전입니다. 예를 들면
2.0.0
입니다. 이 필드는 필수 항목입니다. - 3
- 읽을 Kafka 주제의 이름입니다. 다음은 추적의 경우
otlp_spans
이며 지표의 경우otlp_metrics
, 로그의 경우otlp_logs
입니다. - 4
- 일반 텍스트 인증 구성입니다. 생략하면 일반 텍스트 인증이 비활성화됩니다.
- 5
- 클라이언트 측 TLS 구성입니다. TLS 인증서의 경로를 정의합니다. 생략하면 TLS 인증이 비활성화됩니다.
- 6
- 서버의 인증서 체인과 호스트 이름을 확인하지 않습니다. 기본값은
false
입니다. - 7
- ServerName은 가상 호스팅을 지원하기 위해 클라이언트에서 요청한 서버의 이름을 나타냅니다.
3.4.8. AWS CloudWatch Logs Exporter
AWS CloudWatch Logs Exporter는 Amazon CloudMonitor Logs 서비스로 로그 데이터를 전송하고 AWS SDK for Go 및 기본 인증 정보 공급자 체인을 사용하여 요청에 서명합니다.
AWS CloudWatch Logs Exporter는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
활성화된 AWS CloudMonitor Logs Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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: <service_endpoint_of_amazon_cloudwatch_logs> 4 log_retention: <supported_value_in_days> 5 # ...
- 1
- 필수 항목입니다. 로그 그룹이 아직 존재하지 않으면 자동으로 생성됩니다.
- 2
- 필수 항목입니다. 로그 스트림이 아직 존재하지 않으면 자동으로 생성됩니다.
- 3
- 선택 사항: AWS 리전이 기본 인증 정보 체인에 설정되지 않은 경우 이를 지정해야 합니다.
- 4
- 선택 사항: 요청이 전달되는 기본 Amazon CloudMonitor Logs 서비스 끝점을 덮어쓸 수 있습니다. 리전별 서비스 끝점 목록은 Amazon CloudMonitor Logs 엔드포인트 및 할당량 (AWS 일반 참조)을 참조하십시오.
- 5
- 선택 사항: 이 매개변수를 사용하면 새 Amazon CloudMonitor 로그 그룹에 대한 로그 보존 정책을 설정할 수 있습니다. 이 매개변수를 생략하거나
0
으로 설정하면 로그가 기본적으로 만료되지 않습니다. 일 이내에 보존을 위해 지원되는 값은1
,3
,5
,7
,14
,30
,60
,90
,120
,150
,180
,365
,400
,545
,731
입니다.1827
,2192
,2557
,2922
,3288
또는3653
.
추가 리소스
- Amazon CloudMonitor 로그란 무엇입니까? (Amazon CloudMonitor 로그 사용자 가이드)
- 인증 정보 지정 (AWS SDK for Go 개발자 가이드)
- Amazon CloudMonitor 로그 끝점 및 할당량 (AWS 일반 참조)
3.4.9. AWS EMF Exporter
AWS EMF Exporter는 다음 OpenTelemetry 메트릭 데이터 포인트를 AWS CloudWatch Cryostat Metric Format(EMF)으로 변환합니다.
-
Int64DataPoints
-
doubleDataPoints
-
SummaryDataPoints
그런 다음 EMF 메트릭은 PutLogEvents
API를 사용하여 Amazon CloudMonitor Logs 서비스로 직접 전송됩니다.
이 내보내기를 사용하면 얻을 수 있는 이점 중 하나는 https://console.aws.amazon.com/cloudwatch/ 의 Amazon CloudMonitor 콘솔에서 로그 및 메트릭을 볼 수 있다는 것입니다.
AWS EMF Exporter는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
활성화된 AWS EMF Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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: <endpoint> 5 log_retention: <supported_value_in_days> 6 namespace: <custom_namespace> 7 # ...
- 1
- 사용자 지정 로그 그룹 이름입니다.
- 2
- 사용자 지정 로그 스트림 이름입니다.
- 3
- 선택 사항: 리소스 속성을 지표 레이블과 같은 Telemetry 속성으로 변환합니다. 기본적으로 비활성되어 있습니다.
- 4
- 로그 스트림의 AWS 리전입니다. 기본 인증 정보 공급자 체인에 리전이 설정되지 않은 경우 해당 리전을 지정해야 합니다.
- 5
- 선택 사항: 요청이 전달되는 기본 Amazon CloudMonitor Logs 서비스 끝점을 덮어쓸 수 있습니다. 리전별 서비스 끝점 목록은 Amazon CloudMonitor Logs 엔드포인트 및 할당량 (AWS 일반 참조)을 참조하십시오.
- 6
- 선택 사항: 이 매개변수를 사용하면 새 Amazon CloudMonitor 로그 그룹에 대한 로그 보존 정책을 설정할 수 있습니다. 이 매개변수를 생략하거나
0
으로 설정하면 로그가 기본적으로 만료되지 않습니다. 일 이내에 보존을 위해 지원되는 값은1
,3
,5
,7
,14
,30
,60
,90
,120
,150
,180
,365
,400
,545
,731
입니다.1827
,2192
,2557
,2922
,3288
또는3653
. - 7
- 선택 사항: Amazon CloudMonitor 지표의 사용자 정의 네임스페이스입니다.
로그 그룹 이름
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로 교체하는 데 사용됩니다.
리소스 특성 맵에 리소스 속성이 없는 경우 자리 표시자는 정의되지 않은
값으로 교체됩니다.
추가 리소스
- 사양: Cryostat 메트릭 형식 (Amazon CloudMonitor 사용자 가이드)
- PutLogEvents (Amazon Cloud Logs API 참조)
- Amazon CloudMonitor 로그 끝점 및 할당량 (AWS 일반 참조)
3.4.10. AWS X- Cryostat Exporter
AWS X- Cryostat Exporter는 OpenTelemetry 기간을 AWS X- Cryostat Segment Documents로 변환한 다음 AWS X- Cryostat 서비스로 직접 전송합니다. AWS X- Cryostat Exporter는 PutTraceSegments
API를 사용하고 AWS SDK for Go 및 기본 인증 정보 공급자 체인을 사용하여 요청에 서명합니다.
AWS X- Cryostat Exporter는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
활성화된 AWS X- Cryostat Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... config: exporters: awsxray: region: "<region>" 1 endpoint: <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 # ...
- 1
- AWS X- Cryostat 서비스로 전송된 X- Cryostat 세그먼트의 대상 리전입니다. 예를 들면
eu-west-1
입니다. - 2
- 선택 사항: 요청이 전달되는 기본 Amazon CloudMonitor Logs 서비스 끝점을 덮어쓸 수 있습니다. 리전별 서비스 끝점 목록은 Amazon CloudMonitor Logs 엔드포인트 및 할당량 (AWS 일반 참조)을 참조하십시오.
- 3
- 수집기를 실행 중인 AWS 리소스의 Amazon 리소스 이름(ARN)입니다.
- 4
- X- Cryostat 세그먼트를 다른 계정에 업로드하는 AWS Identity and Access Management(IAM) 역할.
- 5
- X- Cryostat 주석으로 변환할 속성 이름 목록입니다.
- 6
- Amazon CloudMonitor Logs의 로그 그룹 이름 목록입니다.
- 7
- 요청을 시간 초과하기 전의 시간(초)입니다. 생략하면 기본값은
30
입니다.
추가 리소스
- AWS X- Cryostat란 무엇입니까? (AWS X- Cryostat 개발자 가이드)
- AWS SDK for Go API Reference (AWS 문서)
- 인증 정보 지정 (AWS SDK for Go 개발자 가이드)
- IAM 역할 (AWS ID 및 액세스 관리 사용자 가이드)
3.4.11. 파일 내보내기
File Exporter는 Telemetry 데이터를 영구 스토리지의 파일에 작성하고 순환, 압축 및 여러 파일에 쓰기와 같은 파일 작업을 지원합니다. 이 내보내기를 사용하면 리소스 속성을 사용하여 파일 이름을 제어할 수도 있습니다. 유일한 필수 설정은 persistent-volume 파일 시스템에 있는 Telemetry 파일의 대상 경로를 지정하는 path
입니다.
파일 내보내기는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
활성화된 File Exporter가 있는 OpenTelemetry 수집기 사용자 정의 리소스
# ... 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 # ...
- 1
- 데이터를 쓸 파일 시스템 경로입니다. 기본값이 없습니다.
- 2
- 파일 순환은 이 내보내기의 선택적 기능입니다. 기본적으로 Telemetry 데이터는 단일 파일로 내보냅니다.
회전
설정을 추가하여 파일 교체를 활성화합니다. - 3
max_megabytes
설정은 파일이 순환될 때까지 도달할 수 있는 최대 크기입니다. 기본값은100
입니다.- 4
max_days
설정은 파일을 보존할 일수로 파일 이름의 타임스탬프를 계산합니다. 기본값이 없습니다.- 5
max_backups
설정은 여러 이전 파일을 유지하기 위한 것입니다. defalt 는100
입니다.- 6
localtime
설정은 파일이 순환될 때 확장자 앞에 있는 파일 이름에 추가되는 타임스탬프의 로컬 시간 형식을 지정합니다. 기본값은 UTC(Coordinated Universal Time)입니다.- 7
- Telemetry 데이터를 파일에 쓰기 전에 인코딩하는 형식입니다. 기본 형식은
json
입니다.proto
형식도 지원됩니다. - 8
- 파일 압축은 선택 사항이며 기본적으로 설정되지 않습니다. 이 설정은 파일로 내보낸 데이터의 압축 알고리즘을 정의합니다. 현재는
zstd
압축 알고리즘만 지원됩니다. 기본값이 없습니다. - 9
- 플러시 사이의 시간 간격입니다. 단위가 없는 값은 나노초 단위로 설정됩니다. 이 설정은
회전
설정을 통해 파일 순환을 활성화할 때 무시됩니다.
3.4.12. 추가 리소스
- OpenTelemetry Protocol (OTLP) (OpenTelemetry 문서)