Jaeger — backend de tracing de nó único para Kubernetes
Este exemplo compila uma stack pequena e real — um backend de tracing distribuído Jaeger na sua estrutura de nó único — a partir de um único Aggregate escrito pelo programador para o Kubernetes, sintetizada diretamente a partir da imagem oficial do Jaeger, sem nenhum chart upstream.
O Jaeger é um backend de traces: recebe spans através do protocolo OpenTelemetry, armazena-os num repositório chave-valor local incorporado e responde a consultas de pesquisa e de obtenção de traces através da sua UI de consulta. Na estrutura de nó único, o recetor OTLP, o escritor de armazenamento e o serviço de consulta são executados todos dentro de um único processo apoiado num repositório local em disco, pelo que todo o servidor é uma única carga de trabalho com estado. Uma aplicação instrumentada envia spans para o recetor OTLP do Jaeger; um operador lê-os de volta a partir da UI.
Ficheiros
| Ficheiro | Papel |
|---|---|
aggregate.yaml | Intenção do programador: 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 demonstra
- Uma única superfície de autoria. Um único Aggregate é a fonte de 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 contém a configuração do Jaeger v2 e dois objetosService— umClusterIPque expõe os recetores e a UI, e um Service headless de governo para o StatefulSet. - Configuração entregue como ficheiro. O Jaeger v2 é uma distribuição do OpenTelemetry Collector configurada por um ficheiro YAML. A Recipe emite essa configuração como um
ConfigMape monta-a no contentor em/etc/jaeger, e o contentor lê-a com--config /etc/jaeger/config.yaml. - Traces persistentes. O repositório chave-valor incorporado escreve no volume persistente em
/badger, pelo que os dados de traces sobrevivem a reinícios. - Um contrato de ingestão exportado. O componente exporta o host e a porta do seu recetor OTLP gRPC através da topologia
uses, pelo que um produtor de traces se liga a ele e lhe envia spans. - Imagens reproduzíveis. A Recipe fixa a imagem do servidor Jaeger numa tag resolúvel, para que a carga de trabalho renderizada referencie uma versão fixada.
Gerar o exemplo
É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.
Escreva o exemplo numa nova pasta com o nome dele:
aggrega scaffold --example jaeger-tracingDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd jaeger-tracingCompilação
Este espaço de trabalho não inclui nenhum .aggrega-config.yaml, pelo que as entidades da biblioteca standard são resolvidas a partir do registo do hub, hub.aggrega.ai, e não é necessária nenhuma flag de catálogo:
aggrega pull --release release.yamlaggrega build --release release.yamlOs artefactos renderizados ficam em dist/. O destino Kubernetes renderiza manifestos simples offline — não é necessário nenhum pull de chart.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.
Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta da área de trabalho ainda não contiver uma pasta `jaeger-tracing`, chame uma vez a ferramenta `scaffold` com `example` definido como `jaeger-tracing` e sem `dir`: esta escreve o exemplo numa nova pasta `jaeger-tracing`. Em seguida, 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. Indique quais os ficheiros que a compilação escreveu; encontram-se em `jaeger-tracing/dist/`.O que é renderizado
A compilação 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 incorporado num volume persistente montado em/badgere a configuração montada em/etc/jaeger, - um
ConfigMap— a configuração do Jaeger v2 (os recetores OTLP, o processador batch e o repositório chave-valor incorporado que escreve em/badger/keye/badger/data), - um
ServiceClusterIP— que expõe o recetor OTLP gRPC na 4317, o recetor OTLP HTTP na 4318 e a UI de consulta na 16686, - um
Serviceheadless — o Service de governo de que o StatefulSet necessita para uma identidade estável por réplica.
A imagem do Jaeger está fixada na sua tag de release, pelo que a carga de trabalho referencia uma tag de imagem fixada.