Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

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

FichierRôle
aggregate.yamlIntention du développeur : un seul composant tracing (core/observability/tempo) conservant les traces pendant sept jours.
manifest.yamlMappe le type de composant vers la Recipe Tempo synthétisée (tempo).
release.yamlDocument 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 StatefulSet avec un volume de données par réplica, d’une ConfigMap portant la configuration de Tempo, et d’un Service ClusterIP et d’un Headless exposant 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_period du 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 :

Terminal window
aggrega scaffold --example tempo-tracing

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd tempo-tracing

Build

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 :

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

Les 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é.