콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

Jaeger — Kubernetes 단일 노드 트레이싱 백엔드

이 예제는 작지만 실제적인 스택인 단일 노드 형태의 Jaeger 분산 트레이싱 백엔드를 Developer가 작성한 하나의 Aggregate에서 Kubernetes로 컴파일하며, 업스트림 차트 없이 공식 Jaeger 이미지에서 직접 합성합니다.

Jaeger는 트레이스 백엔드입니다. OpenTelemetry 프로토콜로 스팬을 수신하고, 로컬 임베디드 키-값 저장소에 저장하며, 쿼리 UI를 통해 트레이스 조회 및 검색 쿼리에 응답합니다. 단일 노드 형태에서는 OTLP 수신기, 스토리지 작성기, 쿼리 서비스가 모두 로컬 온디스크 저장소를 기반으로 하는 하나의 프로세스 안에서 실행되므로 서버 전체가 하나의 상태 저장 워크로드가 됩니다. 계측된 애플리케이션은 Jaeger의 OTLP 수신기로 스팬을 푸시하고, 운영자는 UI에서 이를 읽어 옵니다.

파일

파일역할
aggregate.yamlDeveloper 의도: 단일 tracing 컴포넌트(core/observability/jaeger).
manifest.yaml컴포넌트 유형을 Jaeger 합성 Recipe(jaeger)에 매핑합니다.
release.yamlKubernetes 대상에 대한 운영자 레코드: 서버 컴퓨팅과 트레이스 저장소 볼륨 크기.

보여 주는 내용

  • 하나의 작성 표면. 하나의 Aggregate가 Jaeger가 무엇인지에 대한 신뢰할 수 있는 원천이며, Manifest는 이를 어떻게 실현할지를 정합니다.
  • 단일 노드 트레이스 백엔드. 합성 Recipe는 Jaeger를 데이터 볼륨이 있는 StatefulSet 하나, Jaeger v2 구성을 담은 ConfigMap 하나, 그리고 두 개의 Service 객체로 렌더링합니다. 두 객체는 수신기와 UI를 노출하는 ClusterIP와 StatefulSet을 관리하는 헤드리스 Service입니다.
  • 파일로 전달되는 구성. Jaeger v2는 YAML 파일로 구성되는 OpenTelemetry Collector 배포판입니다. Recipe는 해당 구성을 ConfigMap으로 내보내 컨테이너의 /etc/jaeger에 마운트하고, 컨테이너는 --config /etc/jaeger/config.yaml로 이를 읽습니다.
  • 영구 트레이스. 임베디드 키-값 저장소가 /badger의 영구 볼륨에 기록하므로 트레이스 데이터가 재시작 후에도 유지됩니다.
  • 내보낸 수집 계약. 컴포넌트는 uses 토폴로지를 통해 OTLP gRPC 수신기의 호스트와 포트를 내보내므로, 트레이스 생산자가 여기에 연결하여 스팬을 푸시합니다.
  • 재현 가능한 이미지. Recipe는 Jaeger 서버 이미지를 확인 가능한 태그로 고정하므로 렌더링된 워크로드가 고정된 버전을 참조합니다.

예제 생성하기

아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.

예제 이름을 딴 새 폴더에 예제를 씁니다:

Terminal window
aggrega scaffold --example jaeger-tracing

그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:

Terminal window
cd jaeger-tracing

빌드

이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다.

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

렌더링된 아티팩트는 dist/ 아래에 생성됩니다. Kubernetes 대상은 오프라인으로 일반 매니페스트를 렌더링하므로 차트를 가져올 필요가 없습니다.

AI 어시스턴트 사용

Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.

Aggrega 도구만 사용하고 폴더를 직접 만들지 마십시오. 작업 공간 폴더에 아직 `jaeger-tracing` 폴더가 없으면 `example`에 `jaeger-tracing` 값을 지정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 예제가 새 `jaeger-tracing` 폴더에 작성됩니다. 그런 다음 `workspace_root` 값은 `jaeger-tracing`, `release` 값은 `release.yaml`, `auto_pull` 값은 true, `write` 값은 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `jaeger-tracing/dist/` 아래에 있습니다.

렌더링 결과

빌드는 Jaeger 서버를 네 개의 Kubernetes 객체로 생성합니다.

  • StatefulSet — 단일 노드 Jaeger 프로세스이며, 임베디드 트레이스 저장소는 /badger에 마운트된 영구 볼륨에 있고 구성은 /etc/jaeger에 마운트됩니다.
  • ConfigMap — Jaeger v2 구성(OTLP 수신기, 배치 프로세서, 그리고 /badger/key와 /badger/data에 기록하는 임베디드 키-값 저장소).
  • ClusterIP Service — OTLP gRPC 수신기를 4317에, OTLP HTTP 수신기를 4318에, 쿼리 UI를 16686에 노출합니다.
  • 헤드리스 Service — StatefulSet이 복제본별 안정적인 식별을 위해 필요로 하는 관리 Service입니다.

Jaeger 이미지는 릴리스 태그로 고정되어 있으므로 워크로드는 고정된 이미지 태그를 참조합니다.