Tempo — Kubernetes 분산 트레이싱 서버
이 예제는 작지만 실제로 쓰이는 스택인 Grafana Tempo 분산 트레이싱
서버를, Developer가 작성한 하나의 Aggregate에서 공식 grafana/tempo 이미지 기반의 Workload
합성을 통해 단일 바이너리 형태로 Kubernetes에 컴파일합니다.
Tempo는 트레이스 백엔드입니다. OpenTelemetry 프로토콜(및 기타 트레이싱 와이어 형식)로 스팬을 수신하고, 이를 트레이스 객체 저장소에 저장하며, HTTP API를 통해 트레이스 조회 및 검색 쿼리에 응답합니다. 단일 바이너리 형태에서는 Tempo의 모든 하위 시스템(distributor, ingester, querier, compactor)이 로컬 트레이스 저장소를 기반으로 하나의 프로세스 안에서 실행되므로, 서버 전체가 하나의 상태 저장 워크로드가 됩니다. 계측된 애플리케이션은 Tempo의 OTLP 수신기로 스팬을 푸시하고, 대시보드 서버는 쿼리 API를 통해 이를 다시 읽어 옵니다.
파일
| 파일 | 역할 |
|---|---|
aggregate.yaml | Developer 의도: 트레이스를 7일 동안 보관하는 단일 tracing 컴포넌트(core/observability/tempo). |
manifest.yaml | 컴포넌트 유형을 합성된 Tempo Recipe(tempo)에 매핑합니다. |
release.yaml | Kubernetes 대상에 대한 운영자 레코드: 서버 컴퓨팅과 트레이스 저장소 볼륨 크기. |
보여 주는 내용
- 하나의 작성 표면. 단일 Aggregate가 Tempo가 무엇인지에 대한 단일 진실 공급원이며, Manifest는 이를 어떻게 실현할지를 기술합니다.
- 단일 바이너리 트레이스 백엔드. 합성된 Recipe는 Tempo를 레플리카별 데이터 볼륨을 갖는
하나의
StatefulSet, Tempo 구성을 담은 하나의ConfigMap, 그리고 트레이스 수신기와 HTTP 쿼리 API를 노출하는ClusterIP및HeadlessService로 렌더링합니다. 즉, 하나의 자체 완결적인 워크로드입니다. - 개발자가 설정하는 보존 기간. 개발자의
retention_period는 프로세스 내 compactor로 전달되며, compactor는 저장된 트레이스 블록이 이 기간을 넘기면 삭제합니다. - 내보낸 수집 계약. 컴포넌트는
uses토폴로지를 통해 OTLP gRPC 수신기의 호스트와 포트를 내보내므로, 트레이스 생산자가 여기에 연결하여 스팬을 푸시합니다. - 재현 가능한 이미지. Recipe는 Tempo 서버 이미지 태그를
infra.engine_version에서 고정하므로, 렌더링된 워크로드는 고정된 버전을 참조합니다.
예제 생성하기
아래 명령으로 이 예제를 빌드하거나, AI 어시스턴트에게 대신 빌드하게 할 수 있습니다.
예제 이름을 딴 새 폴더에 예제를 씁니다:
aggrega scaffold --example tempo-tracing그런 다음 이어서 실행할 명령을 출력합니다. 첫 번째 명령은 새 폴더로 이동합니다:
cd tempo-tracing빌드
이 워크스페이스에는 .aggrega-config.yaml이 없으므로 표준 라이브러리 엔터티는 허브 레지스트리 hub.aggrega.ai에서 해석되며 카탈로그 플래그가 필요하지 않습니다. --auto-pull은 새 클론에 없는 lockfile을 빌드 중에 기록합니다.
aggrega build --release release.yaml --auto-pull렌더링된 아티팩트는 dist/ 아래에 생성됩니다. 합성된 대상은 외부
차트를 가져올 필요가 없습니다. Recipe가 공식 이미지를 StatefulSet,
Service, 데이터 볼륨으로 직접 렌더링하기 때문입니다.
AI 어시스턴트 사용
Aggrega 도구로 설정한 AI 어시스턴트도 같은 작업을 할 수 있습니다. 다음 프롬프트를 붙여 넣으십시오.
Aggrega 도구만 사용하고, 폴더를 직접 만들지 마십시오. 작업 영역 폴더에 아직 `tempo-tracing` 폴더가 없으면 `example`을 `tempo-tracing` 값으로 설정하고 `dir` 없이 `scaffold` 도구를 한 번 호출하십시오. 그러면 새 `tempo-tracing` 폴더에 예제가 작성됩니다. 그런 다음 `workspace_root`를 `tempo-tracing` 값으로, `release`를 `release.yaml` 값으로, `auto_pull`을 true로, `write`를 true로 설정하여 `build` 도구를 호출하십시오. 빌드가 작성한 파일을 알려 주십시오. 파일은 `tempo-tracing/dist/` 아래에 있습니다.렌더링 결과
빌드는 Tempo 서버를 네 개의 Kubernetes 객체로 출력합니다.
StatefulSet— 단일 바이너리 Tempo 프로세스로, 트레이스 저장소는 레플리카별 영구 볼륨에 있습니다.ConfigMap— Tempo 구성입니다.ClusterIP Service— OTLP gRPC 수신기를 4317에, OTLP HTTP 수신기를 4318에, HTTP 쿼리 API를 3200에 노출합니다.Headless Service— StatefulSet의 안정적인 네트워크 ID로, 동일한 포트를 노출합니다.
Tempo 이미지 태그는 infra.engine_version에서 고정되므로, 워크로드는 고정된 이미지 태그를 참조합니다.