Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

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

FicheiroPapel
aggregate.yamlIntenção do programador: um único componente tracing (core/observability/jaeger).
manifest.yamlMapeia o tipo de componente para a Recipe de síntese do Jaeger (jaeger).
release.yamlDocumento 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 StatefulSet com um volume de dados, um ConfigMap que contém a configuração do Jaeger v2 e dois objetos Service — um ClusterIP que 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 ConfigMap e 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:

Terminal window
aggrega scaffold --example jaeger-tracing

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd jaeger-tracing

Compilaçã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:

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

Os 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 /badger e 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/key e /badger/data),
  • um Service ClusterIP — que expõe o recetor OTLP gRPC na 4317, o recetor OTLP HTTP na 4318 e a UI de consulta na 16686,
  • um Service headless — 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.