2.29. Jaeger 설정 참조
Service Mesh Operator가 ServiceMeshControlPlane
리소스를 생성할 때 분산 추적을 위한 리소스도 배포할 수 있습니다. 서비스 메시는 분산 추적을 위해 Jaeger를 사용합니다.
- Jaeger는 FIPS 검증 암호화 모듈을 사용하지 않습니다.
- Red Hat OpenShift Service Mesh 2.5부터 Red Hat OpenShift distributed tracing Platform (Jaeger)은 더 이상 사용되지 않으며 향후 릴리스에서 제거됩니다. Red Hat은 현재 릴리스 라이프사이클 동안 이 기능에 대한 버그 수정 및 지원을 제공하지만 이 기능은 더 이상 개선 사항을 받지 않으며 제거됩니다. Red Hat OpenShift distributed tracing Platform (Jaeger) 대신 Red Hat OpenShift distributed tracing Platform (Tempo)을 대신 사용할 수 있습니다.
2.29.1. 추적 활성화 및 비활성화
ServiceMeshControlPlane
리소스에 추적 유형 및 샘플링 비율을 지정하여 분산 추적을 활성화합니다.
기본 all-in-one
Jaeger 매개변수
apiVersion: maistra.io/v2 kind: ServiceMeshControlPlane metadata: name: basic spec: version: v2.6 tracing: sampling: 100 type: Jaeger
Red Hat OpenShift Service Mesh 2.6에서 Jaeger
는 기본적으로 더 이상 사용되지 않으며 비활성화되어 있습니다.
Red Hat OpenShift Service Mesh 2.5 및 이전 버전에서는 추적 유형 Jaeger
가 기본적으로 활성화되어 있습니다. Jaeger
추적을 비활성화하려면 ServiceMeshControlPlane
리소스의 spec.tracing.type
매개변수를 None
으로 설정합니다.
샘플링 비율은 Envoy 프록시가 추적을 생성하는 빈도를 결정합니다. 샘플링 비율 옵션을 사용하여 추적 시스템에 보고되는 요청의 백분율을 제어할 수 있습니다. 메시의 트래픽 및 수집하려는 추적 데이터 양을 기반으로 이 설정을 구성할 수 있습니다. 0.01% 증분을 나타내는 스케일링된 정수로 sampling
을 구성합니다. 예를 들어, 값을 10
로 설정하면 추적의 0.1%를 샘플링하고, 500
으로 설정하면 추적의 5%를 샘플링하며, 10000
으로 설정하면 추적의 100%를 샘플링합니다.
SMCP 샘플링 구성 옵션은 Envoy 샘플링 비율을 제어합니다. Jaeger 사용자 정의 리소스에서 Jaeger 추적 샘플링 비율을 구성합니다.
2.29.2. SMCP에서 Jaeger 설정 지정
ServiceMeshControlPlane
리소스의 addons
섹션에서 Jaeger를 구성합니다. 그러나 SMCP에서 구성할 수 있는 몇 가지 제한 사항이 있습니다.
SMCP가 구성 정보를 Red Hat OpenShift distributed tracing Platform (Jaeger) Operator에 전달할 때 allInOne
,production
또는 streaming
의 세 가지 배포 전략 중 하나를 트리거합니다.
2.29.3. 분산 추적 플랫폼 배포
분산 추적 플랫폼(Jaeger)에는 사전 정의된 배포 전략이 있습니다. Jaeger 사용자 정의 리소스 (CR) 파일에 배포 전략을 지정합니다. 분산 추적 플랫폼(Jaeger)의 인스턴스를 생성할 때 Red Hat OpenShift distributed tracing Platform(Jaeger) Operator는 이 구성 파일을 사용하여 배포에 필요한 오브젝트를 생성합니다.
Red Hat OpenShift 분산 추적 플랫폼 (Jaeger) Operator는 현재 다음과 같은 배포 전략을 지원합니다.
allInOne(기본값) - 이 전략은 개발, 테스트 및 데모 목적으로 설계되었으며 이는 프로덕션 사용을 목적으로 하지 않습니다. 기본 백엔드 구성 요소, 에이전트, 수집기 및 쿼리 서비스는 모두 메모리 내 스토리지를 사용하도록 (기본적으로) 구성된 단일 실행 파일로 패키지됩니다. SMCP에서 이 배포 전략을 구성할 수 있습니다.
참고메모리 내 스토리지는 영구적이지 않습니다. 즉, Jaeger 인스턴스가 종료, 재시작 또는 교체되면 추적 데이터가 손실됩니다. 각 Pod에 자체 메모리가 있으므로 메모리 내 스토리지를 확장할 수 없습니다. 영구 스토리지의 경우 Elasticsearch를 기본 스토리지로 사용하는
production
또는streaming
전략을 사용해야 합니다.- 프로덕션 - 프로덕션 전략은 장기적인 추적 데이터 저장과 더 확장 가능하고 가용성이 높은 아키텍처가 필요한 프로덕션 환경을 위한 것입니다. 따라서 각 백엔드 구성 요소는 별도로 배포됩니다. 에이전트는 조정된 애플리케이션에서 사이드카로 삽입될 수 있습니다. 쿼리 및 수집기 서비스는 지원되는 스토리지 유형(현재 Elasticsearch)으로 구성됩니다. 이러한 각 구성 요소의 여러 인스턴스는 성능 및 복원에 필요한 대로 프로비저닝할 수 있습니다. SMCP에서 이 배포 전략을 구성할 수 있지만 완전히 사용자 정의하려면 Jaeger CR에 구성을 지정하고 SMCP에 링크를 연결해야 합니다.
- 스트리밍 - 스트리밍 전략은 Collector와 Elasticsearch 백엔드 스토리지 간에 적용되는 스트리밍 기능을 제공하여 프로덕션 전략을 보강하도록 설계되었습니다. 이를 통해 높은 로드 상황에서 백엔드 스토리지의 부담을 줄이고 다른 추적 후 처리 기능을 통해 스트리밍 플랫폼 (AMQ Streams/ Kafka)에서 직접 실시간 데이터를 가져올 수 있습니다. SMCP에서 이 배포 전략을 구성할 수 없습니다. Jaeger CR을 구성하고 이를 SMCP에 연결해야 합니다.
스트리밍 전략에는 AMQ Streams에 대한 추가 Red Hat 서브스크립션이 필요합니다.
2.29.3.1. 기본 분산 추적 플랫폼(Jaeger) 배포
Jaeger 구성 옵션을 지정하지 않으면 ServiceMeshControlPlane
리소스는 기본적으로 allInOne
Jaeger 배포 전략을 사용합니다. 기본 allInOne
배포 전략을 사용하려면 spec.addons.jaeger.install.storage.type
을 Memory
로 설정합니다. 기본값을 허용하거나 install
에서 추가 구성 옵션을 지정할 수 있습니다.
컨트롤 플레인 기본 Jaeger 매개변수 (메모리)
apiVersion: maistra.io/v2 kind: ServiceMeshControlPlane metadata: name: basic spec: version: v2.6 tracing: sampling: 10000 type: Jaeger addons: jaeger: name: jaeger install: storage: type: Memory
2.29.3.2. 프로덕션 분산 추적 플랫폼(Jaeger) 배포(최소)
production
배포 전략의 기본 설정을 사용하려면 spec.addons.jaeger.install.storage.type
을 Elasticsearch
로 설정하고 install
에서 추가 구성 옵션을 지정합니다. SMCP는 Elasticsearch 리소스 및 이미지 이름 설정만 지원한다는 점에 유의하십시오.
컨트롤 플레인 기본 Jaeger 매개변수(Elasticsearch)
apiVersion: maistra.io/v2 kind: ServiceMeshControlPlane metadata: name: basic spec: version: v2.6 tracing: sampling: 10000 type: Jaeger addons: jaeger: name: jaeger #name of Jaeger CR install: storage: type: Elasticsearch ingress: enabled: true runtime: components: tracing.jaeger.elasticsearch: # only supports resources and image name container: resources: {}
2.29.3.3. 프로덕션 분산 추적 플랫폼(Jaeger) 배포(완전 사용자 지정)
SMCP는 최소한의 Elasticsearch 매개변수만 지원합니다. 프로덕션 환경을 완전히 사용자 지정하고 모든 Elasticsearch 구성 매개변수에 액세스하려면 Jaeger 사용자 정의 리소스(CR)를 사용하여 Jaeger를 구성합니다.
Jaeger 인스턴스를 생성 및 구성하고 spec.addons.jaeger.name
을 Jaeger 인스턴스의 이름으로 설정합니다(예: MyJaegerInstance
).
연결된 Jaeger 프로덕션 CR이 있는 컨트롤 플레인
apiVersion: maistra.io/v2 kind: ServiceMeshControlPlane metadata: name: basic spec: version: v2.6 tracing: sampling: 1000 type: Jaeger addons: jaeger: name: MyJaegerInstance #name of Jaeger CR install: storage: type: Elasticsearch ingress: enabled: true
2.29.3.4. 스트리밍 Jaeger 배포
streaming
배포 전략을 사용하려면 먼저 Jaeger 인스턴스를 생성하고 구성한 다음 spec.addons.jaeger.name
을 Jaeger 인스턴스의 이름으로 설정합니다(예: MyJaegerInstance
).
연결된 Jaeger 스트리밍 CR이 있는 컨트롤 플레인
apiVersion: maistra.io/v2 kind: ServiceMeshControlPlane metadata: name: basic spec: version: v2.6 tracing: sampling: 1000 type: Jaeger addons: jaeger: name: MyJaegerInstance #name of Jaeger CR
2.29.4. Jaeger 사용자 정의 리소스에서 Jaeger 구성 지정
ServiceMeshControlPlane
(SMCP) 리소스가 아닌 Jaeger CR(사용자 정의 리소스)에서 Jaeger를 구성하여 Jaeger 배포를 완전히 사용자 지정할 수 있습니다. 구성이 SMCP 외부에 지정되므로 이 구성을 "외부 Jaeger"라고도 합니다.
동일한 네임스페이스에 SMCP 및 Jaeger CR을 배포해야 합니다. 예를 들면 istio-system
입니다.
독립형 Jaeger 인스턴스를 구성하고 배포한 다음 SMCP 리소스의 spec.addons.jaeger.name
값으로 Jaeger 리소스의 name
을 지정할 수 있습니다. name
값과 일치하는 Jaeger CR이 존재하는 경우 Service Mesh Control Plane에서 기존 설치를 사용합니다. 이 방법을 사용하면 Jaeger 설정을 완전히 사용자 지정할 수 있습니다.
2.29.4.1. 배포 모범 사례
- Red Hat OpenShift 분산 추적 플랫폼 인스턴스 이름은 고유해야 합니다. Red Hat OpenShift 분산 추적 플랫폼 (Jaeger) 인스턴스를 여러 개 보유하고 있고 사이드카 삽입 에이전트를 사용하고자 하는 경우 Red Hat OpenShift 분산 추적 플랫폼(Jaeger) 인스턴스에 고유한 이름이 있어야 하며 injection 주석은 추적 데이터를 보고해야 하는 Red Hat OpenShift 분산 추적 플랫폼(Jaeger) 인스턴스 이름을 명시적으로 지정해야 합니다.
- 다중 테넌트 구현과 테넌트가 네임스페이스로 구분된 경우 Red Hat OpenShift 분산 추적 플랫폼(Jaeger) 인스턴스를 각 테넌트 네임스페이스에 배포합니다.
영구 스토리지 구성에 대한 자세한 내용은 영구 스토리지 및 선택한 스토리지 옵션에 대한 적절한 구성 주제 이해 를 참조하십시오.
2.29.4.2. 서비스 메시에 대한 분산 추적 보안 구성
분산 추적 플랫폼(Jaeger)은 기본 인증에 OAuth를 사용합니다. 그러나 Red Hat OpenShift Service Mesh는 htpasswd
라는 시크릿을 사용하여 Grafana, Kiali 및 분산 추적 플랫폼(Jaeger)과 같은 종속 서비스 간의 통신을 용이하게 합니다. ServiceMeshControlPlane
에서 분산 추적 플랫폼(Jaeger)을 구성할 때 서비스 메시는 htpasswd
를 사용하도록 보안 설정을 자동으로 구성합니다.
Jaeger 사용자 정의 리소스에서 분산 추적 플랫폼(Jaeger) 구성을 지정하는 경우 htpasswd
설정을 수동으로 구성하고 Kiali와 통신할 수 있도록 htpasswd
시크릿이 Jaeger 인스턴스에 마운트되었는지 확인해야 합니다.
2.29.4.2.1. 웹 콘솔에서 서비스 메시에 대한 분산 추적 보안 구성
웹 콘솔에서 Service Mesh와 함께 사용할 Jaeger 리소스를 수정하여 분산 추적 플랫폼(Jaeger) 보안을 구성할 수 있습니다.
사전 요구 사항
-
cluster-admin
역할의 사용자로 클러스터에 액세스할 수 있어야 합니다. Red Hat OpenShift Dedicated를 사용하는 경우dedicated-admin
역할의 계정이 있어야 합니다. - Red Hat OpenShift Service Mesh Operator가 설치되어 있어야 합니다.
-
ServiceMeshControlPlane
이 클러스터에 배포되었습니다. - OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.
프로세스
-
cluster-admin
역할의 사용자로 OpenShift Container Platform 웹 콘솔에 로그인합니다. -
Operators
설치된 Operator로 이동합니다. -
프로젝트 메뉴를 클릭하고 목록에서
ServiceMeshControlPlane
리소스가 배포되는 프로젝트를 선택합니다(예:istio-system
). - Red Hat OpenShift distributed tracing Platform (Jaeger) Operator 를 클릭합니다.
- Operator 세부 정보 페이지에서 Jaeger 탭을 클릭합니다.
- Jaeger 인스턴스의 이름을 클릭합니다.
- Jaeger 세부 정보 페이지에서 YAML 탭을 클릭하여 구성을 수정합니다.
다음 예와 같이
Jaeger
사용자 정의 리소스 파일을 편집하여htpasswd
구성을 추가합니다.-
spec.ingress.openshift.htpasswdFile
-
spec.volumes
spec.volumeMounts
htpasswd
구성을 표시하는 Jaeger 리소스의 예apiVersion: jaegertracing.io/v1 kind: Jaeger spec: ingress: enabled: true openshift: htpasswdFile: /etc/proxy/htpasswd/auth sar: '{"namespace": "istio-system", "resource": "pods", "verb": "get"}' options: {} resources: {} security: oauth-proxy volumes: - name: secret-htpasswd secret: secretName: htpasswd - configMap: defaultMode: 420 items: - key: ca-bundle.crt path: tls-ca-bundle.pem name: trusted-ca-bundle optional: true name: trusted-ca-bundle volumeMounts: - mountPath: /etc/proxy/htpasswd name: secret-htpasswd - mountPath: /etc/pki/ca-trust/extracted/pem/ name: trusted-ca-bundle readOnly: true # ...
-
- 저장을 클릭합니다.
2.29.4.2.2. 명령줄에서 서비스 메시에 대한 분산 추적 보안 구성
OpenShift CLI(oc
)를 실행하여 명령줄에서 Service Mesh와 함께 사용할 Jaeger 리소스를 수정하여 분산 추적 플랫폼(Jaeger) 보안을 구성할 수 있습니다.
사전 요구 사항
-
cluster-admin
역할의 사용자로 클러스터에 액세스할 수 있어야 합니다. Red Hat OpenShift Dedicated를 사용하는 경우dedicated-admin
역할의 계정이 있어야 합니다. - Red Hat OpenShift Service Mesh Operator가 설치되어 있어야 합니다.
-
ServiceMeshControlPlane
이 클러스터에 배포되었습니다. -
OpenShift Container Platform 버전과 일치하는 OpenShift CLI(
oc
)에 액세스할 수 있습니다.
프로세스
다음 명령을 실행하여
cluster-admin
역할의 사용자로 OpenShift CLI(oc
)에 로그인합니다. Red Hat OpenShift Dedicated를 사용하는 경우dedicated-admin
역할의 계정이 있어야 합니다.$ oc login https://<HOSTNAME>:6443
다음 명령을 입력하여 컨트롤 플레인을 설치한 프로젝트(예:
istio-system
)로 변경합니다.$ oc project istio-system
다음 명령을 실행하여 Jaeger 사용자 정의 리소스 파일을 편집합니다.
$ oc edit -n openshift-distributed-tracing -f jaeger.yaml
다음 예와 같이
Jaeger
사용자 정의 리소스 파일을 편집하여htpasswd
구성을 추가합니다.-
spec.ingress.openshift.htpasswdFile
-
spec.volumes
spec.volumeMounts
htpasswd
구성을 표시하는 Jaeger 리소스의 예apiVersion: jaegertracing.io/v1 kind: Jaeger spec: ingress: enabled: true openshift: htpasswdFile: /etc/proxy/htpasswd/auth sar: '{"namespace": "istio-system", "resource": "pods", "verb": "get"}' options: {} resources: {} security: oauth-proxy volumes: - name: secret-htpasswd secret: secretName: htpasswd - configMap: defaultMode: 420 items: - key: ca-bundle.crt path: tls-ca-bundle.pem name: trusted-ca-bundle optional: true name: trusted-ca-bundle volumeMounts: - mountPath: /etc/proxy/htpasswd name: secret-htpasswd - mountPath: /etc/pki/ca-trust/extracted/pem/ name: trusted-ca-bundle readOnly: true
-
다음 명령을 실행하여 Pod 배포의 진행 상황을 확인합니다.
$ oc get pods -n openshift-distributed-tracing
2.29.4.3. 분산 추적 기본 구성 옵션
Jaeger CR(사용자 정의 리소스)은 분산 추적 플랫폼(Jaeger) 리소스를 생성할 때 사용할 아키텍처 및 설정을 정의합니다. 이러한 매개변수를 수정하여 비즈니스 요구에 맞게 분산 추적 플랫폼(Jaeger) 구현을 사용자 지정할 수 있습니다.
Jaeger CR의 일반 YAML 예
apiVersion: jaegertracing.io/v1 kind: Jaeger metadata: name: name spec: strategy: <deployment_strategy> allInOne: options: {} resources: {} agent: options: {} resources: {} collector: options: {} resources: {} sampling: options: {} storage: type: options: {} query: options: {} resources: {} ingester: options: {} resources: {} options: {}
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
| 오브젝트를 생성할 때 사용할 API 버전입니다. |
|
|
| 생성할 Kubernetes 오브젝트를 정의합니다. |
| |
|
|
OpenShift Container Platform은 | |
| 오브젝트의 이름입니다. | 분산 추적 플랫폼(Jaeger) 인스턴스의 이름입니다. |
|
| 생성할 오브젝트의 사양입니다. |
분산 추적 플랫폼(Jaeger) 인스턴스에 대한 모든 구성 매개변수를 포함합니다. 모든 Jaeger 구성 요소에 대한 공통 정의가 필요한 경우 | 해당 없음 |
| Jaeger 배포 전략 |
|
|
|
| ||
| 에이전트를 정의하는 구성 옵션입니다. | ||
| Jaeger 수집기를 정의하는 구성 옵션입니다. | ||
| 추적을 위한 샘플링 전략을 정의하는 구성 옵션입니다. | ||
|
스토리지를 정의하는 구성 옵션입니다. 모든 스토리지 관련 옵션은 | ||
| 쿼리 서비스를 정의하는 구성 옵션입니다. | ||
| Ingester 서비스를 정의하는 구성 옵션입니다. |
다음 예제 YAML은 기본 설정을 사용하여 Red Hat OpenShift 분산 추적 플랫폼(Jaeger) 배포를 생성하는 데 필요한 최소값입니다.
예: 최소 필수 dist-tracing-all-in-one.yaml
apiVersion: jaegertracing.io/v1 kind: Jaeger metadata: name: jaeger-all-in-one-inmemory
2.29.4.4. Jaeger 수집기 구성 옵션
Jaeger 수집기는 추적기에서 캡처한 기간을 수신하여 production
전략을 사용할 때 영구 Elasticsearch 스토리지에 기록하거나 streaming
전략을 사용할 때 AMQ Streams에 쓰는 구성 요소입니다.
수집기는 상태 비저장이므로 Jaeger 수집기의 많은 인스턴스를 병렬로 실행할 수 있습니다. 수집기는 Elasticsearch 클러스터의 위치를 제외하고 거의 구성이 필요하지 않습니다.
매개변수 | 설명 | 값 |
---|---|---|
collector: replicas: | 생성할 수집기 복제본 수를 지정합니다. |
정수(예: |
매개변수 | 설명 | 값 |
---|---|---|
spec: collector: options: {} | Jaeger 수집기를 정의하는 구성 옵션입니다. | |
options: collector: num-workers: | 큐에서 가져온 작업자 수입니다. |
정수(예: |
options: collector: queue-size: | 수집기 큐의 크기입니다. |
정수(예: |
options: kafka: producer: topic: jaeger-spans |
| 프로듀서의 레이블입니다. |
options: kafka: producer: brokers: my-cluster-kafka-brokers.kafka:9092 | 메시지를 생성하기 위해 수집기에서 사용하는 Kafka 구성을 식별합니다. 브로커를 지정하지 않고 AMQ Streams 1.4.0 이상이 설치된 경우 Red Hat OpenShift 분산 추적 플랫폼 (Jaeger) Operator는 Kafka를 자체 프로비저닝합니다. | |
options: log-level: | 수집기의 로깅 수준입니다. |
가능한 값: |
options: otlp: enabled: true grpc: host-port: 4317 max-connection-age: 0s max-connection-age-grace: 0s max-message-size: 4194304 tls: enabled: false cert: /path/to/cert.crt cipher-suites: "TLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256" client-ca: /path/to/cert.ca reload-interval: 0s min-version: 1.2 max-version: 1.3 |
OTLP/gRPC를 수락하려면 | |
options: otlp: enabled: true http: cors: allowed-headers: [<header-name>[, <header-name>]*] allowed-origins: * host-port: 4318 max-connection-age: 0s max-connection-age-grace: 0s max-message-size: 4194304 read-timeout: 0s read-header-timeout: 2s idle-timeout: 0s tls: enabled: false cert: /path/to/cert.crt cipher-suites: "TLS_AES_256_GCM_SHA384,TLS_CHACHA20_POLY1305_SHA256" client-ca: /path/to/cert.ca reload-interval: 0s min-version: 1.2 max-version: 1.3 |
OTLP/HTTP를 수락하려면 |
2.29.4.5. 분산 추적 샘플링 구성 옵션
Red Hat OpenShift 분산 추적 플랫폼(Jaeger) Operator는 원격 샘플러를 사용하도록 구성된 추적기에 제공할 샘플링 전략을 정의하는 데 사용할 수 있습니다.
모든 추적이 생성되지만 소수만 샘플링됩니다. 추적 샘플링은 추가 처리 및 스토리지의 추적을 나타냅니다.
이는 샘플링 결정에 따라 Envoy 프록시에서 추적을 시작한 경우와 관련이 없습니다. Jaeger 샘플링 결정은 클라이언트를 사용하는 애플리케이션에서 추적을 시작할 때만 관련이 있습니다.
서비스에서 추적 컨텍스트가 없는 요청을 수신하면 클라이언트는 새 추적을 시작하고 임의의 추적 ID를 할당하고 현재 설치된 샘플링 전략에 따라 샘플링 결정을 내립니다. 샘플링 결정은 다른 서비스가 샘플링 결정을 다시 하지 않도록 추적의 모든 후속 요청으로 전파됩니다.
분산 추적 플랫폼(Jaeger) 라이브러리는 다음 샘플을 지원합니다.
-
확률론 - 샘플러는 샘플링(
sampling.param
) 속성의 값과 동일한 샘플링의 확률로 임의 샘플링 결정을 내립니다. 예를 들어,sampling.param=0.1
샘플을 사용하여 10개의 추적 중 약 1개를 샘플링합니다. -
속도 제한 - 샘플러는 누수된 버킷 속도 제한기를 사용하여 추적을 특정한 일정 속도로 샘플링합니다. 예를 들어,
sampling.param=2.0
샘플 요청을 초당 2개 추적 속도로 사용합니다.
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
spec: sampling: options: {} default_strategy: service_strategy: | 추적을 위한 샘플링 전략을 정의하는 구성 옵션입니다. | 구성을 제공하지 않으면 수집기는 모든 서비스에 대해 0.001(0.1%)인 기본 확률 샘플링 정책을 반환합니다. | |
default_strategy: type: service_strategy: type: | 사용할 샘플링 전략입니다. 위의 설명을 참조하십시오. |
유효한 값은 |
|
default_strategy: param: service_strategy: param: | 선택한 샘플링 전략에 대한 매개변수입니다. | 10진수 및 정수 값(0, .1, 1, 10) | 1 |
이 예에서는 추적 인스턴스가 샘플링될 가능성이 50%인 비율로 확률적인 기본 샘플링 전략을 정의합니다.
확률 샘플링 예
apiVersion: jaegertracing.io/v1 kind: Jaeger metadata: name: with-sampling spec: sampling: options: default_strategy: type: probabilistic param: 0.5 service_strategies: - service: alpha type: probabilistic param: 0.8 operation_strategies: - operation: op1 type: probabilistic param: 0.2 - operation: op2 type: probabilistic param: 0.4 - service: beta type: ratelimiting param: 5
사용자가 제공하는 구성이 없는 경우 분산 추적 플랫폼(Jaeger)은 다음 설정을 사용합니다.
기본 샘플링
spec: sampling: options: default_strategy: type: probabilistic param: 1
2.29.4.6. 분산 추적 스토리지 구성 옵션
spec:storage
에서 Collector, Ingester 및 쿼리 서비스에 대한 스토리지를 구성합니다. 이러한 각 구성 요소의 여러 인스턴스는 성능 및 복원에 필요한 대로 프로비저닝할 수 있습니다.
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
spec: storage: type: | 배포에 사용할 스토리지 유형입니다. |
|
|
storage: secretname: |
시크릿 이름(예: | 해당 없음 | |
storage: options: {} | 스토리지를 정의하는 구성 옵션입니다. |
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
storage: esIndexCleaner: enabled: | Elasticsearch 스토리지를 사용하는 경우 기본적으로 인덱스에서 오래된 추적을 정리하는 작업이 생성됩니다. 이 매개변수는 인덱스 정리 작업을 활성화하거나 비활성화합니다. |
|
|
storage: esIndexCleaner: numberOfDays: | 인덱스를 삭제하기 전에 대기하는 날의 수입니다. | 정수 값 |
|
storage: esIndexCleaner: schedule: | Elasticsearch 인덱스를 정리하는 빈도에 대한 일정을 정의합니다. | Cron 표현식 | "55 23 * * *" |
2.29.4.6.1. Elasticsearch 인스턴스 자동 프로비저닝
Jaeger 사용자 정의 리소스를 배포할 때 Red Hat OpenShift distributed tracing Platform (Jaeger) Operator는 OpenShift Elasticsearch Operator를 사용하여 사용자 정의 리소스 파일의 storage
섹션에 제공된 구성을 기반으로 Elasticsearch 클러스터를 생성합니다. 다음 구성이 설정된 경우 Red Hat OpenShift 분산 추적 플랫폼 (Jaeger) Operator는 Elasticsearch를 프로비저닝합니다.
-
spec.storage:type
이elasticsearch
로 설정됨 -
spec.storage.elasticsearch.doNotProvision
을false
로 설정 -
spec.storage.options.es.server-urls
는 정의되지 않았습니다. 즉 OpenShift Elasticsearch Operator에서 프로비저닝하지 않은 Elasticsearch 인스턴스에 대한 연결이 없습니다.
Elasticsearch를 프로비저닝할 때 Red Hat OpenShift distributed tracing Platform (Jaeger) Operator는 Jaeger 사용자 정의 리소스에서 Elasticsearch 사용자 정의 리소스 name
을 spec.storage.elasticsearch.name
값으로 설정합니다. spec.storage.elasticsearch.name
의 값을 지정하지 않으면 Operator에서 elasticsearch
를 사용합니다.
제한 사항
- 네임스페이스당 자체 프로비저닝 Elasticsearch 인스턴스가 있는 하나의 분산 추적 플랫폼(Jaeger)만 있을 수 있습니다. Elasticsearch 클러스터는 단일 분산 추적 플랫폼(Jaeger) 인스턴스 전용입니다.
- 네임스페이스당 Elasticsearch가 하나만 있을 수 있습니다.
Elasticsearch를 OpenShift Logging의 일부로 이미 설치한 경우 Red Hat OpenShift 분산 추적 플랫폼 (Jaeger) Operator에서 설치된 OpenShift Elasticsearch Operator를 사용하여 스토리지를 프로비저닝할 수 있습니다.
다음 구성 매개변수는 OpenShift Elasticsearch Operator를 사용하여 Red Hat OpenShift 분산 추적 플랫폼(Jaeger) Operator가 생성한 인스턴스인 자체 프로비저닝 Elasticsearch 인스턴스에 대한 것입니다. 구성 파일의 spec:storage:elasticsearch
에서 자체 프로비저닝 Elasticsearch에 대한 구성 옵션을 지정합니다.
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
elasticsearch: properties: doNotProvision: | 을 사용하여 Red Hat OpenShift 분산 추적 플랫폼(Jaeger) Operator에서 Elasticsearch 인스턴스를 프로비저닝해야 하는지 여부를 지정합니다. |
|
|
elasticsearch: properties: name: | Elasticsearch 인스턴스의 이름입니다. Red Hat OpenShift 분산 추적 플랫폼(Jaeger) Operator는 이 매개변수에 지정된 Elasticsearch 인스턴스를 사용하여 Elasticsearch에 연결합니다. | string |
|
elasticsearch: nodeCount: | Elasticsearch 노드 수입니다. 고가용성의 경우 최소 3개의 노드를 사용합니다. “스플릿 브레인” 문제가 발생할 수 있으므로 2개의 노드를 사용하지 마십시오. | 정수 값입니다. 예를 들면 개념 증명 = 1, 최소 배포 =3입니다. | 3 |
elasticsearch: resources: requests: cpu: | 사용자 환경 구성에 따른 요청에 대한 중앙 처리 단위 수입니다. | 코어 또는 밀리코어(예: 200m, 0.5, 1)에 지정됩니다. 예를 들면 개념 증명 = 500m, 최소 배포 =1입니다. | 1 |
elasticsearch: resources: requests: memory: | 환경 구성에 따른 요청에 사용 가능한 메모리입니다. | 바이트로 지정됩니다(예: 200Ki, 50Mi, 5Gi). 예를 들면 개념 증명 = 1Gi, 최소 배포 = 16Gi*입니다. | 16Gi |
elasticsearch: resources: limits: cpu: | 사용자 환경 구성에 따른 중앙 처리 장치 수에 대한 제한입니다. | 코어 또는 밀리코어(예: 200m, 0.5, 1)에 지정됩니다. 예를 들면 개념 증명 = 500m, 최소 배포 =1입니다. | |
elasticsearch: resources: limits: memory: | 사용자 환경 구성에 따라 사용 가능한 메모리 제한입니다. | 바이트로 지정됩니다(예: 200Ki, 50Mi, 5Gi). 예를 들면 개념 증명 = 1Gi, 최소 배포 = 16Gi*입니다. | |
elasticsearch: redundancyPolicy: | 데이터 복제 정책은 Elasticsearch shard가 클러스터의 데이터 노드에 복제되는 방법을 정의합니다. 지정하지 않으면 Red Hat OpenShift 분산 추적 플랫폼 (Jaeger) Operator가 노드 수에 따라 가장 적절한 복제를 자동으로 결정합니다. |
| |
elasticsearch: useCertManagement: | 을 사용하여 분산 추적 플랫폼(Jaeger)에서 OpenShift Elasticsearch Operator의 인증서 관리 기능을 사용해야 하는지 여부를 지정합니다. 이 기능은 OpenShift Container Platform 4.7의 {logging-title} 5.2에 추가되었으며 새 Jaeger 배포의 기본 설정입니다. |
|
|
각 Elasticsearch 노드는 더 낮은 메모리 설정으로 작동할 수 있지만 프로덕션 배포에는 권장되지 않습니다. 프로덕션 용도의 경우 기본적으로 각 Pod에 할당된 16Gi 미만이 있어야 하지만 Pod당 최대 64Gi를 할당하는 것이 좋습니다.
프로덕션 스토리지 예
apiVersion: jaegertracing.io/v1 kind: Jaeger metadata: name: simple-prod spec: strategy: production storage: type: elasticsearch elasticsearch: nodeCount: 3 resources: requests: cpu: 1 memory: 16Gi limits: memory: 16Gi
영구 스토리지가 있는 스토리지 예:
apiVersion: jaegertracing.io/v1
kind: Jaeger
metadata:
name: simple-prod
spec:
strategy: production
storage:
type: elasticsearch
elasticsearch:
nodeCount: 1
storage: 1
storageClassName: gp2
size: 5Gi
resources:
requests:
cpu: 200m
memory: 4Gi
limits:
memory: 4Gi
redundancyPolicy: ZeroRedundancy
- 1
- 영구 스토리지 구성. 이 경우 AWS
gp2
에5Gi
크기가 있습니다. 값을 지정하지 않으면 분산 추적 플랫폼(Jaeger)에서emptyDir
을 사용합니다. OpenShift Elasticsearch Operator는 분산 추적 플랫폼(Jaeger) 인스턴스에서 제거되지 않는PersistentVolumeClaim
및PersistentVolume
을 프로비저닝합니다. 동일한 이름과 네임스페이스로 분산 추적 플랫폼(Jaeger) 인스턴스를 생성하면 동일한 볼륨을 마운트할 수 있습니다.
2.29.4.6.2. 기존 Elasticsearch 인스턴스에 연결
분산 추적 플랫폼이 있는 스토리지에 기존 Elasticsearch 클러스터를 사용할 수 있습니다. 외부 Elasticsearch 인스턴스라고도 하는 기존 Elasticsearch 클러스터는 Red Hat OpenShift distributed tracing Platform (Jaeger) Operator 또는 OpenShift Elasticsearch Operator에서 설치하지 않은 인스턴스입니다.
Jaeger 사용자 정의 리소스를 배포할 때 다음 구성이 설정된 경우 Red Hat OpenShift 분산 추적 플랫폼 (Jaeger) Operator는 Elasticsearch를 프로비저닝하지 않습니다.
-
spec.storage.elasticsearch.doNotProvision
을true
로 설정 -
spec.storage.options.es.server-urls
에는 값이 있습니다. -
spec.storage.elasticsearch.name
에는 값이 있거나 Elasticsearch 인스턴스 이름이elasticsearch
인 경우입니다.
Red Hat OpenShift 분산 추적 플랫폼(Jaeger) Operator는 spec.storage.elasticsearch.name
에 지정된 Elasticsearch 인스턴스를 사용하여 Elasticsearch에 연결합니다.
제한 사항
- 분산 추적 플랫폼(Jaeger)과 OpenShift Container Platform 로깅 Elasticsearch 인스턴스를 공유하거나 재사용할 수 없습니다. Elasticsearch 클러스터는 단일 분산 추적 플랫폼(Jaeger) 인스턴스 전용입니다.
다음 구성 매개변수는 외부 Elasticsearch 인스턴스 라고도 하는 기존 Elasticsearch 인스턴스에 대한 것입니다. 이 경우 spec:storage:options:es
사용자 지정 리소스 파일에서 Elasticsearch에 대한 구성 옵션을 지정합니다.
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
es: server-urls: | Elasticsearch 인스턴스의 URL입니다. | Elasticsearch 서버의 정규화된 도메인 이름입니다. | |
es: max-doc-count: |
Elasticsearch 쿼리에서 반환하는 최대 문서 수입니다. 이는 집계에도 적용됩니다. | 10000 | |
es: max-num-spans: |
[더 이상 사용되지 않음 - 향후 릴리스에서 제거되며 대신 | 10000 | |
es: max-span-age: | Elasticsearch에서 기간에 대한 최대 조회 수입니다. | 72h0m0s | |
es: sniffer: | Elasticsearch의 스니퍼 구성입니다. 클라이언트는 스니핑 프로세스를 사용하여 모든 노드를 자동으로 찾습니다. 기본적으로 비활성되어 있습니다. |
|
|
es: sniffer-tls-enabled: | Elasticsearch 클러스터를 스니핑할 때 TLS를 활성화하는 옵션입니다. 클라이언트는 스니핑 프로세스를 사용하여 모든 노드를 자동으로 찾습니다. 기본적으로 비활성화되어 있습니다. |
|
|
es: timeout: | 쿼리에 사용되는 시간 제한입니다. 0으로 설정하면 시간 제한이 없습니다. | 0s | |
es: username: |
Elasticsearch에 필요한 사용자 이름입니다. 기본 인증은 지정된 경우 CA도 로드합니다. | ||
es: password: |
Elasticsearch에 필요한 암호입니다. | ||
es: version: | 주요 Elasticsearch 버전입니다. 지정하지 않으면 Elasticsearch에서 값을 자동으로 탐지합니다. | 0 |
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
es: num-replicas: | Elasticsearch의 인덱스당 복제본 수입니다. | 1 | |
es: num-shards: | Elasticsearch의 인덱스당 shard 수입니다. | 5 |
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
es: create-index-templates: |
|
|
|
es: index-prefix: | 분산 추적 플랫폼(Jaeger) 인덱스의 선택적 접두사입니다. 예를 들어 이 값을 "production"으로 설정하면 "production-tracing-*"이라는 인덱스가 생성됩니다. |
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
es: bulk: actions: | 대규모 프로세서가 디스크에 업데이트를 커밋하기 전에 큐에 추가할 수 있는 요청 수입니다. | 1000 | |
es: bulk: flush-interval: |
다른 임계값에 관계없이 대규모 요청이 커밋된 후 | 200ms | |
es: bulk: size: | 대규모 프로세서가 디스크에 업데이트를 커밋하기 전에 대규모 요청이 수행할 수 있는 바이트 수입니다. | 5000000 | |
es: bulk: workers: | Elasticsearch에 대규모 요청을 수신하고 커밋할 수 있는 작업자 수입니다. | 1 |
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
es: tls: ca: | 원격 서버를 확인하는 데 사용되는 TLS 인증 기관(CA) 파일의 경로입니다. | 기본적으로 시스템 신뢰 저장소를 사용합니다. | |
es: tls: cert: | 이 프로세스를 원격 서버에 식별하는 데 사용되는 TLS 인증서 파일의 경로입니다. | ||
es: tls: enabled: | 원격 서버와 통신할 때 TLS(Transport Layer Security)를 활성화합니다. 기본적으로 비활성되어 있습니다. |
|
|
es: tls: key: | 이 프로세스를 원격 서버에 식별하는 데 사용되는 TLS 개인 키 파일의 경로입니다. | ||
es: tls: server-name: | 원격 서버의 인증서에서 예상되는 TLS 서버 이름을 재정의합니다. | ||
es: token-file: | 전달자 토큰이 포함된 파일의 경로입니다. 이 플래그는 지정된 경우 CA(인증 기관) 파일도 로드합니다. |
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
es-archive: bulk: actions: | 대규모 프로세서가 디스크에 업데이트를 커밋하기 전에 큐에 추가할 수 있는 요청 수입니다. | 0 | |
es-archive: bulk: flush-interval: |
다른 임계값에 관계없이 대규모 요청이 커밋된 후 | 0s | |
es-archive: bulk: size: | 대규모 프로세서가 디스크에 업데이트를 커밋하기 전에 대규모 요청이 수행할 수 있는 바이트 수입니다. | 0 | |
es-archive: bulk: workers: | Elasticsearch에 대규모 요청을 수신하고 커밋할 수 있는 작업자 수입니다. | 0 | |
es-archive: create-index-templates: |
|
|
|
es-archive: enabled: | 추가 스토리지를 활성화합니다. |
|
|
es-archive: index-prefix: | 분산 추적 플랫폼(Jaeger) 인덱스의 선택적 접두사입니다. 예를 들어 이 값을 "production"으로 설정하면 "production-tracing-*"이라는 인덱스가 생성됩니다. | ||
es-archive: max-doc-count: | Elasticsearch 쿼리에서 반환하는 최대 문서 수입니다. 이는 집계에도 적용됩니다. | 0 | |
es-archive: max-num-spans: |
[더 이상 사용되지 않음 - 향후 릴리스에서 제거되며 대신 | 0 | |
es-archive: max-span-age: | Elasticsearch에서 기간에 대한 최대 조회 수입니다. | 0s | |
es-archive: num-replicas: | Elasticsearch의 인덱스당 복제본 수입니다. | 0 | |
es-archive: num-shards: | Elasticsearch의 인덱스당 shard 수입니다. | 0 | |
es-archive: password: |
Elasticsearch에 필요한 암호입니다. | ||
es-archive: server-urls: |
Elasticsearch 서버의 쉼표로 구분된 목록입니다. 정규화된 URL로 지정해야 합니다(예: http://localhost:9200 | ||
es-archive: sniffer: | Elasticsearch의 스니퍼 구성입니다. 클라이언트는 스니핑 프로세스를 사용하여 모든 노드를 자동으로 찾습니다. 기본적으로 비활성되어 있습니다. |
|
|
es-archive: sniffer-tls-enabled: | Elasticsearch 클러스터를 스니핑할 때 TLS를 활성화하는 옵션입니다. 클라이언트는 스니핑 프로세스를 사용하여 모든 노드를 자동으로 찾습니다. 기본적으로 비활성되어 있습니다. |
|
|
es-archive: timeout: | 쿼리에 사용되는 시간 제한입니다. 0으로 설정하면 시간 제한이 없습니다. | 0s | |
es-archive: tls: ca: | 원격 서버를 확인하는 데 사용되는 TLS 인증 기관(CA) 파일의 경로입니다. | 기본적으로 시스템 신뢰 저장소를 사용합니다. | |
es-archive: tls: cert: | 이 프로세스를 원격 서버에 식별하는 데 사용되는 TLS 인증서 파일의 경로입니다. | ||
es-archive: tls: enabled: | 원격 서버와 통신할 때 TLS(Transport Layer Security)를 활성화합니다. 기본적으로 비활성되어 있습니다. |
|
|
es-archive: tls: key: | 이 프로세스를 원격 서버에 식별하는 데 사용되는 TLS 개인 키 파일의 경로입니다. | ||
es-archive: tls: server-name: | 원격 서버의 인증서에서 예상되는 TLS 서버 이름을 재정의합니다. | ||
es-archive: token-file: | 전달자 토큰이 포함된 파일의 경로입니다. 이 플래그는 지정된 경우 CA(인증 기관) 파일도 로드합니다. | ||
es-archive: username: |
Elasticsearch에 필요한 사용자 이름입니다. 기본 인증은 지정된 경우 CA도 로드합니다. | ||
es-archive: version: | 주요 Elasticsearch 버전입니다. 지정하지 않으면 Elasticsearch에서 값을 자동으로 탐지합니다. | 0 |
볼륨 마운트가 있는 스토리지 예
apiVersion: jaegertracing.io/v1 kind: Jaeger metadata: name: simple-prod spec: strategy: production storage: type: elasticsearch options: es: server-urls: https://quickstart-es-http.default.svc:9200 index-prefix: my-prefix tls: ca: /es/certificates/ca.crt secretName: tracing-secret volumeMounts: - name: certificates mountPath: /es/certificates/ readOnly: true volumes: - name: certificates secret: secretName: quickstart-es-http-certs-public
다음 예는 시크릿에 저장된 볼륨 및 사용자/암호에서 마운트된 TLS CA 인증서가 포함된 외부 Elasticsearch 클러스터를 사용하는 Jaeger CR을 보여줍니다.
외부 Elasticsearch 예
apiVersion: jaegertracing.io/v1 kind: Jaeger metadata: name: simple-prod spec: strategy: production storage: type: elasticsearch options: es: server-urls: https://quickstart-es-http.default.svc:9200 1 index-prefix: my-prefix tls: 2 ca: /es/certificates/ca.crt secretName: tracing-secret 3 volumeMounts: 4 - name: certificates mountPath: /es/certificates/ readOnly: true volumes: - name: certificates secret: secretName: quickstart-es-http-certs-public
- 1
- 기본 네임스페이스에서 실행되는 Elasticsearch 서비스에 대한 URL입니다.
- 2
- TLS 구성입니다. 이 경우 CA 인증서만 해당하지만 상호 TLS를 사용하는 경우 es.tls.key 및 es.tls.cert를 포함할 수 있습니다.
- 3
- 환경 변수 ES_PASSWORD 및 ES_USERNAME을 정의하는 시크릿입니다. kubectl create secret generic tracing-secret --from-literal=ES_PASSWORD=changeme --from-literal=ES_USERNAME=elastic에 의해 생성
- 4
- 모든 스토리지 구성 요소에 마운트되는 볼륨 마운트 및 볼륨입니다.
2.29.4.7. Elasticsearch로 인증서 관리
OpenShift Elasticsearch Operator를 사용하여 인증서를 생성하고 관리할 수 있습니다. OpenShift Elasticsearch Operator를 사용하여 인증서를 관리하면 여러 Jaeger 수집기가 있는 단일 Elasticsearch 클러스터도 사용할 수 있습니다.
Elasticsearch로 인증서를 관리하는 것은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
버전 2.4부터 Red Hat OpenShift distributed tracing Platform (Jaeger) Operator는 Elasticsearch 사용자 정의 리소스에서 다음 주석을 사용하여 인증서 생성을 OpenShift Elasticsearch Operator에 위임합니다.
-
logging.openshift.io/elasticsearch-cert-management: "true"
-
logging.openshift.io/elasticsearch-cert.jaeger-<shared-es-node-name>: "user.jaeger"
-
logging.openshift.io/elasticsearch-cert.curator-<shared-es-node-name>: "system.logging.curator"
여기서 <shared-es-node-name>
은 Elasticsearch 노드의 이름입니다. 예를 들어 custom-es
라는 Elasticsearch 노드를 생성하는 경우 사용자 정의 리소스는 다음 예와 같을 수 있습니다.
주석을 표시하는 Elasticsearch CR의 예
apiVersion: logging.openshift.io/v1 kind: Elasticsearch metadata: annotations: logging.openshift.io/elasticsearch-cert-management: "true" logging.openshift.io/elasticsearch-cert.jaeger-custom-es: "user.jaeger" logging.openshift.io/elasticsearch-cert.curator-custom-es: "system.logging.curator" name: custom-es spec: managementState: Managed nodeSpec: resources: limits: memory: 16Gi requests: cpu: 1 memory: 16Gi nodes: - nodeCount: 3 proxyResources: {} resources: {} roles: - master - client - data storage: {} redundancyPolicy: ZeroRedundancy
사전 요구 사항
- Red Hat OpenShift Service Mesh Operator가 설치되어 있습니다.
- {logging-title}은 클러스터에 기본 구성으로 설치됩니다.
-
Elasticsearch 노드와 Jaeger 인스턴스는 동일한 네임스페이스에 배포해야 합니다. 예를 들면
tracing-system
입니다.
Jaeger 사용자 정의 리소스에서 spec.storage.elasticsearch.useCertManagement
를 true
로 설정하여 인증서 관리를 활성화합니다.
useCertManagement
표시 예
apiVersion: jaegertracing.io/v1 kind: Jaeger metadata: name: jaeger-prod spec: strategy: production storage: type: elasticsearch elasticsearch: name: custom-es doNotProvision: true useCertManagement: true
Red Hat OpenShift 분산 추적 플랫폼 (Jaeger) Operator는 Elasticsearch를 프로비저닝할 때 Elasticsearch 사용자 정의 리소스 name
을 Jaeger 사용자 정의 리소스의 spec.storage.elasticsearch.name
값으로 설정합니다.
인증서는 OpenShift Elasticsearch Operator에 의해 프로비저닝되며 Red Hat OpenShift distributed tracing platform(Jaeger) Operator가 인증서를 삽입합니다.
OpenShift Container Platform을 사용하여 Elasticsearch를 구성하는 방법에 대한 자세한 내용은 Elasticsearch 로그 저장소 구성 또는 분산 추적 구성 및 배포를 참조하십시오.
2.29.4.8. 쿼리 구성 옵션
쿼리는 스토리지에서 추적을 검색하고 사용자 인터페이스에서 표시하도록 호스팅하는 서비스입니다.
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
spec: query: replicas: | 생성할 쿼리 복제본 수를 지정합니다. |
예: 정수 |
매개변수 | 설명 | 값 | 기본값 |
---|---|---|---|
spec: query: options: {} | 쿼리 서비스를 정의하는 구성 옵션입니다. | ||
options: log-level: | 쿼리의 로깅 수준입니다. |
가능한 값: | |
options: query: base-path: |
모든 jaeger-query HTTP 경로의 기본 경로는 root 값이 아닌 값으로 설정할 수 있습니다(예: | /<path> |
샘플 쿼리 구성
apiVersion: jaegertracing.io/v1 kind: "Jaeger" metadata: name: "my-jaeger" spec: strategy: allInOne allInOne: options: log-level: debug query: base-path: /jaeger
2.29.4.9. Ingester 구성 옵션
Ingester는 Kafka 항목에서 읽고 Elasticsearch 스토리지 백엔드에 쓰는 서비스입니다. allInOne
또는 production
배포 전략을 사용하는 경우 Ingester 서비스를 구성할 필요가 없습니다.
매개변수 | 설명 | 값 |
---|---|---|
spec: ingester: options: {} | Ingester 서비스를 정의하는 구성 옵션입니다. | |
options: deadlockInterval: |
Ingester가 종료되기 전에 메시지를 기다려야 하는 간격(초 또는 분)을 지정합니다. 교착 상태 간격은 시스템 초기화 중에 메시지가 없을 때 Ingester를 종료하지 않도록 기본적으로 ( |
분 및 초(예: |
options: kafka: consumer: topic: |
|
소비자의 레이블입니다. 예를 들면 |
options: kafka: consumer: brokers: | 메시지를 사용하려면 Ingester에서 사용하는 Kafka 구성을 식별합니다. |
브로커의 레이블은 예를 들면 |
options: log-level: | Ingester의 로깅 수준입니다. |
가능한 값: |
스트리밍 수집기 및 Ingester 예
apiVersion: jaegertracing.io/v1 kind: Jaeger metadata: name: simple-streaming spec: strategy: streaming collector: options: kafka: producer: topic: jaeger-spans brokers: my-cluster-kafka-brokers.kafka:9092 ingester: options: kafka: consumer: topic: jaeger-spans brokers: my-cluster-kafka-brokers.kafka:9092 ingester: deadlockInterval: 5 storage: type: elasticsearch options: es: server-urls: http://elasticsearch:9200