Tempo — servidor de rastreamento distribuído para Kubernetes
Este exemplo compila um stack pequeno e real — um servidor de rastreamento distribuído Grafana Tempo — a partir de um único Aggregate escrito pelo desenvolvedor para o Kubernetes por meio 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 pelo protocolo OpenTelemetry (e por outros formatos de transmissão de tracing), armazena-os em um repositório de objetos de traces e responde a consultas de busca e de recuperação de traces pela sua API HTTP. Na forma de binário único, cada subsistema do Tempo — distributor, ingester, querier, compactor — é executado dentro de um único processo apoiado em um repositório de traces local, então o servidor inteiro é uma única carga de trabalho com estado. Uma aplicação instrumentada envia spans para o receptor OTLP do Tempo; um servidor de dashboards os lê de volta pela API de consulta.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente tracing (core/observability/tempo) que mantém os traces por sete dias. |
manifest.yaml | Mapeia o tipo de componente para a Recipe do Tempo sintetizada (tempo). |
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 Tempo é; o Manifest diz como realizá-lo.
- Um backend de traces de binário único. A Recipe sintetizada renderiza o Tempo como um único
StatefulSetcom um volume de dados por réplica, umConfigMapque traz a configuração do Tempo, e umServiceClusterIPe outroHeadlessque expõem os receptores de traces e a API de consulta HTTP — uma única carga de trabalho autocontida. - Retenção definida pelo desenvolvedor. O
retention_perioddo desenvolvedor chega ao compactor interno do processo, que exclui os blocos de traces armazenados assim que eles ultrapassam essa idade. - 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 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
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 tempo-tracingEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd tempo-tracingBuild
Este workspace 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; --auto-pull escreve durante o build o lockfile que falta a um clone novo:
aggrega build --release release.yaml --auto-pullOs artefatos renderizados ficam em dist/. O destino sintetizado não precisa buscar nenhum chart externo — a Recipe renderiza a imagem oficial diretamente em um StatefulSet, Services e um volume de dados.
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 por conta própria. Se a pasta do espaço 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`: ela grava o exemplo em uma 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. Diga-me quais arquivos o build gravou; eles ficam em `tempo-tracing/dist/`.O que é renderizado
O build 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 em um volume persistente por réplica, - um
ConfigMap— a configuração do Tempo, - um
ClusterIP Service— que expõe o receptor OTLP gRPC na 4317, o receptor 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, para que a carga de trabalho referencie uma tag de imagem fixada.