Tempo — serveur de traçage distribué pour Kubernetes
Cet exemple compile une petite stack réelle — un serveur de traçage distribué Grafana Tempo — à partir d’un seul Aggregate écrit par le développeur vers Kubernetes par la synthèse de Workload sur l’image officielle grafana/tempo, dans sa forme à binaire unique.
Tempo est un backend de traces : il reçoit des spans via le protocole OpenTelemetry (et d’autres formats de transmission de traçage), les stocke dans un magasin d’objets de traces, et répond aux requêtes de consultation et de recherche de traces via son API HTTP. Dans la forme à binaire unique, chaque sous-système de Tempo — distributor, ingester, querier, compactor — s’exécute dans un seul processus adossé à un magasin de traces local, si bien que tout le serveur est une seule charge de travail avec état. Une application instrumentée pousse des spans vers le récepteur OTLP de Tempo ; un serveur de tableaux de bord les relit via l’API de requête.
Fichiers
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : un seul composant tracing (core/observability/tempo) conservant les traces pendant sept jours. |
manifest.yaml | Mappe le type de composant vers la Recipe Tempo synthétisée (tempo). |
release.yaml | Document de l’opérateur pour la cible Kubernetes : les ressources de calcul du serveur et la taille du volume du magasin de traces. |
Ce qu’il démontre
- Une seule surface de rédaction. Un seul Aggregate est la source de vérité sur ce qu’est Tempo ; le Manifest dit comment le réaliser.
- Un backend de traces à binaire unique. La Recipe synthétisée rend Tempo sous forme d’un seul
StatefulSetavec un volume de données par réplica, d’uneConfigMapportant la configuration de Tempo, et d’unServiceClusterIPet d’unHeadlessexposant les récepteurs de traces et l’API de requête HTTP — une seule charge de travail autonome. - Une rétention fixée par le développeur. La
retention_perioddu développeur est transmise au compactor interne au processus, qui supprime les blocs de traces stockés une fois qu’ils ont dépassé cet âge. - Un contrat d’ingestion exporté. Le composant exporte l’hôte et le port de son récepteur OTLP gRPC via la topologie
uses, si bien qu’un producteur de traces se connecte à lui et y pousse des spans. - Images reproductibles. La Recipe épingle le tag de l’image du serveur Tempo à partir de
infra.engine_version, si bien que la charge de travail rendue référence une version épinglée.
Générer l’exemple
Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example tempo-tracingElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd tempo-tracingBuild
Ce workspace ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard sont résolues depuis le registre du hub, hub.aggrega.ai, et aucune option de catalogue n’est nécessaire ; --auto-pull écrit pendant le build le lockfile qui manque à un clone récent :
aggrega build --release release.yaml --auto-pullLes artefacts rendus sont placés sous dist/. La cible synthétisée ne nécessite la récupération d’aucun chart externe — la Recipe rend l’image officielle directement en un StatefulSet, des Services et un volume de données.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `tempo-tracing`, appelez une fois l’outil `scaffold` avec `example` défini sur `tempo-tracing` et sans `dir` : il écrit l’exemple dans un nouveau dossier `tempo-tracing`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `tempo-tracing`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `tempo-tracing/dist/`.Ce qui est rendu
Le build émet le serveur Tempo sous forme de quatre objets Kubernetes :
- un
StatefulSet— le processus Tempo à binaire unique, avec son magasin de traces sur un volume persistant par réplica, - une
ConfigMap— la configuration de Tempo, - un
ClusterIP Service— exposant le récepteur OTLP gRPC sur 4317, le récepteur OTLP HTTP sur 4318 et l’API de requête HTTP sur 3200, - un
Headless Service— l’identité réseau stable du StatefulSet, exposant les mêmes ports.
Le tag de l’image Tempo est épinglé à partir de infra.engine_version, si bien que la charge de travail référence un tag d’image épinglé.