Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Jaeger — backend de trazas de un solo nodo para Kubernetes

Este ejemplo compila un stack pequeño y real — un backend de trazado distribuido Jaeger en su estructura de un solo nodo — a partir de un único Aggregate escrito por el desarrollador para Kubernetes, sintetizado directamente a partir de la imagen oficial de Jaeger sin ningún chart upstream.

Jaeger es un backend de trazas: recibe spans mediante el protocolo OpenTelemetry, los almacena en un almacén clave-valor local integrado y responde a las consultas de búsqueda y recuperación de trazas mediante su UI de consulta. En la estructura de un solo nodo, el receptor OTLP, el escritor de almacenamiento y el servicio de consultas se ejecutan todos dentro de un único proceso respaldado por un almacén local en disco, así que todo el servidor es una única carga de trabajo con estado. Una aplicación instrumentada envía spans al receptor OTLP de Jaeger; un operador los vuelve a leer desde la UI.

Archivos

ArchivoRol
aggregate.yamlIntención del desarrollador: un único componente tracing (core/observability/jaeger).
manifest.yamlAsigna el tipo de componente a la Recipe de síntesis de Jaeger (jaeger).
release.yamlDocumento del operador para el destino Kubernetes: el cómputo del servidor y el tamaño del volumen del almacén de trazas.

Lo que demuestra

  • Una única superficie de autoría. Un único Aggregate es la fuente de verdad sobre qué es Jaeger; el Manifest dice cómo realizarlo.
  • Un backend de trazas de un solo nodo. La Recipe de síntesis renderiza Jaeger como un único StatefulSet con un volumen de datos, un ConfigMap que lleva la configuración de Jaeger v2 y dos objetos Service — un ClusterIP que expone los receptores y la UI, y un Service headless de gobierno para el StatefulSet.
  • Configuración entregada como archivo. Jaeger v2 es una distribución de OpenTelemetry Collector configurada mediante un archivo YAML. La Recipe emite esa configuración como un ConfigMap y la monta en el contenedor en /etc/jaeger, y el contenedor la lee con --config /etc/jaeger/config.yaml.
  • Trazas persistentes. El almacén clave-valor integrado escribe en el volumen persistente en /badger, así que los datos de trazas sobreviven a los reinicios.
  • Un contrato de ingesta exportado. El componente exporta el host y el puerto de su receptor OTLP gRPC mediante la topología uses, así que un productor de trazas se conecta a él y le envía spans.
  • Imágenes reproducibles. La Recipe fija la imagen del servidor Jaeger a una etiqueta resoluble, así que la carga de trabajo renderizada hace referencia a una versión fijada.

Generar el ejemplo

Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

Terminal window
aggrega scaffold --example jaeger-tracing

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd jaeger-tracing

Compilación

Este espacio de trabajo no contiene ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no hace falta ningún flag de catálogo:

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

Los artefactos renderizados quedan en dist/. El destino Kubernetes renderiza manifiestos simples sin conexión — no se requiere ningún pull de chart.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees tú ninguna carpeta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `jaeger-tracing`, llama una vez a la herramienta `scaffold` con `example` establecido en `jaeger-tracing` y sin `dir`: escribe el ejemplo en una nueva carpeta `jaeger-tracing`. Después llama a la herramienta `build` con `workspace_root` establecido en `jaeger-tracing`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `jaeger-tracing/dist/`.

Qué se renderiza

La compilación emite el servidor Jaeger como cuatro objetos de Kubernetes:

  • un StatefulSet — el proceso de Jaeger de un solo nodo, con su almacén de trazas integrado en un volumen persistente montado en /badger y la configuración montada en /etc/jaeger,
  • un ConfigMap — la configuración de Jaeger v2 (los receptores OTLP, el procesador batch y el almacén clave-valor integrado que escribe en /badger/key y /badger/data),
  • un Service ClusterIP — que expone el receptor OTLP gRPC en el 4317, el receptor OTLP HTTP en el 4318 y la UI de consulta en el 16686,
  • un Service headless — el Service de gobierno que el StatefulSet requiere para una identidad estable por réplica.

La imagen de Jaeger está fijada a su etiqueta de release, así que la carga de trabajo hace referencia a una etiqueta de imagen fijada.