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

Tempo — servidor de rastreio distribuído para Kubernetes

Este exemplo compila uma stack pequena e real — um servidor de rastreio distribuído Grafana Tempo — a partir de um único Aggregate escrito pelo programador para o Kubernetes através da síntese de Workload sobre a imagem oficial grafana/tempo, na sua forma de binário único.

O Tempo é um backend de traces: recebe spans através do protocolo OpenTelemetry (e de outros formatos de transmissão de tracing), armazena-os num repositório de objetos de traces e responde a consultas de pesquisa e de obtenção de traces através da sua API HTTP. Na forma de binário único, cada subsistema do Tempo — distributor, ingester, querier, compactor — é executado dentro de um único processo apoiado num repositório de traces local, pelo que todo o servidor é uma única carga de trabalho com estado. Uma aplicação instrumentada envia spans para o recetor OTLP do Tempo; um servidor de dashboards lê-os de volta através da API de consulta.

Ficheiros

FicheiroPapel
aggregate.yamlIntenção do programador: um único componente tracing (core/observability/tempo) que mantém os traces durante sete dias.
manifest.yamlMapeia o tipo de componente para a Recipe do Tempo sintetizada (tempo).
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 Tempo é; o Manifest diz como realizá-lo.
  • Um backend de traces de binário único. A Recipe sintetizada renderiza o Tempo como um único StatefulSet com um volume de dados por réplica, um ConfigMap que contém a configuração do Tempo, e um Service ClusterIP e outro Headless que expõem os recetores de traces e a API de consulta HTTP — uma única carga de trabalho autónoma.
  • Retenção definida pelo programador. O retention_period do programador chega ao compactor interno do processo, que elimina os blocos de traces armazenados assim que ultrapassam essa idade.
  • 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 tag da imagem do servidor Tempo a partir de infra.engine_version, 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 tempo-tracing

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

Terminal window
cd tempo-tracing

Compilação

Este workspace não contém 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; --auto-pull escreve durante a compilação o lockfile que falta a um clone acabado de criar:

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

Os artefactos renderizados ficam em dist/. O destino sintetizado não precisa de obter nenhum chart externo — a Recipe renderiza a imagem oficial diretamente num StatefulSet, em Services e num volume de dados.

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 iniciativa própria. Se a pasta da área de trabalho ainda não contiver uma pasta `tempo-tracing`, chame uma vez a ferramenta `scaffold` com `example` definido como `tempo-tracing` e sem `dir`: esta escreve o exemplo numa nova pasta `tempo-tracing`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `tempo-tracing`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Indique-me que ficheiros a compilação escreveu; encontram-se em `tempo-tracing/dist/`.

O que é renderizado

A compilação emite o servidor Tempo como quatro objetos do Kubernetes:

  • um StatefulSet — o processo do Tempo de binário único, com o seu repositório de traces num volume persistente por réplica,
  • um ConfigMap — a configuração do Tempo,
  • um ClusterIP Service — que expõe o recetor OTLP gRPC na 4317, o recetor OTLP HTTP na 4318 e a API de consulta HTTP na 3200,
  • um Headless Service — a identidade de rede estável do StatefulSet, que expõe as mesmas portas.

A tag da imagem do Tempo é fixada a partir de infra.engine_version, pelo que a carga de trabalho referencia uma tag de imagem fixada.