Jaeger — backend de tracing de nó único para Kubernetes
Este exemplo compila um stack pequeno e real — um backend de tracing distribuído Jaeger na sua estrutura de nó único — a partir de um único Aggregate escrito pelo desenvolvedor para o Kubernetes, sintetizado diretamente a partir da imagem oficial do Jaeger, sem nenhum chart upstream.
O Jaeger é um backend de traces: recebe spans pelo protocolo OpenTelemetry, armazena-os em um repositório chave-valor local embutido e responde a consultas de busca e de recuperação de traces pela sua UI de consulta. Na estrutura de nó único, o receptor OTLP, o gravador de armazenamento e o serviço de consulta são executados todos dentro de um único processo apoiado em um repositório local em disco, então o servidor inteiro é uma única carga de trabalho com estado. Uma aplicação instrumentada envia spans para o receptor OTLP do Jaeger; um operador os lê de volta pela UI.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente tracing (core/observability/jaeger). |
manifest.yaml | Mapeia o tipo de componente para a Recipe de síntese do Jaeger (jaeger). |
release.yaml | Documento do operador para o destino Kubernetes: a computação do servidor e o tamanho do volume do repositório de traces. |
O que ele demonstra
- Uma única superfície de autoria. Um único Aggregate é a fonte da verdade sobre o que o Jaeger é; o Manifest diz como realizá-lo.
- Um backend de traces de nó único. A Recipe de síntese renderiza o Jaeger como um único
StatefulSetcom um volume de dados, umConfigMapque traz a configuração do Jaeger v2 e dois objetosService— umClusterIPque expõe os receptores e a UI, e um Service headless de governo para o StatefulSet. - Configuração entregue como arquivo. O Jaeger v2 é uma distribuição do OpenTelemetry Collector configurada por um arquivo YAML. A Recipe emite essa configuração como um
ConfigMape a monta no contêiner em/etc/jaeger, e o contêiner a lê com--config /etc/jaeger/config.yaml. - Traces persistentes. O repositório chave-valor embutido grava no volume persistente em
/badger, então os dados de traces sobrevivem a reinicializações. - Um contrato de ingestão exportado. O componente exporta o host e a porta do seu receptor OTLP gRPC por meio da topologia
uses, então um produtor de traces se conecta a ele e envia spans para lá. - Imagens reproduzíveis. A Recipe fixa a imagem do servidor Jaeger em uma tag resolvível, para que a carga de trabalho renderizada referencie uma versão fixada.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example jaeger-tracingEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd jaeger-tracingBuild
Este espaço de trabalho não traz nenhum .aggrega-config.yaml, então as entidades da biblioteca padrão são resolvidas a partir do registro do hub, hub.aggrega.ai, e nenhuma flag de catálogo é necessária:
aggrega pull --release release.yamlaggrega build --release release.yamlOs artefatos renderizados ficam em dist/. O destino Kubernetes renderiza manifestos simples offline — nenhum pull de chart é necessário.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use somente as ferramentas do Aggrega e não crie nenhuma pasta você mesmo. Se a pasta do workspace ainda não contiver uma pasta `jaeger-tracing`, chame a ferramenta `scaffold` uma vez com `example` definido como `jaeger-tracing` e sem `dir`: ela grava o exemplo em uma nova pasta `jaeger-tracing`. Depois chame a ferramenta `build` com `workspace_root` definido como `jaeger-tracing`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `jaeger-tracing/dist/`.O que é renderizado
O build emite o servidor Jaeger como quatro objetos do Kubernetes:
- um
StatefulSet— o processo do Jaeger de nó único, com o seu repositório de traces embutido em um volume persistente montado em/badgere a configuração montada em/etc/jaeger, - um
ConfigMap— a configuração do Jaeger v2 (os receptores OTLP, o processador batch e o repositório chave-valor embutido que grava em/badger/keye/badger/data), - um
ServiceClusterIP— que expõe o receptor OTLP gRPC na 4317, o receptor OTLP HTTP na 4318 e a UI de consulta na 16686, - um
Serviceheadless — o Service de governo que o StatefulSet exige para uma identidade estável por réplica.
A imagem do Jaeger é fixada na sua tag de release, para que a carga de trabalho referencie uma tag de imagem fixada.