Loki — serveur d’agrégation de logs pour Kubernetes
Cet exemple compile une petite stack réelle — un serveur d’agrégation de logs Grafana Loki — à partir d’un seul Aggregate écrit par le développeur vers Kubernetes, adossée au chart Helm officiel de Grafana Loki dans sa structure à binaire unique.
Loki est un backend de logs : il reçoit des flux de logs via son API HTTP de push, les indexe par étiquette plutôt que par contenu en texte intégral, les stocke dans un magasin d’objets de chunks et répond aux requêtes de logs et aux requêtes par plage via la même API HTTP. Dans la structure à binaire unique, chaque sous-système de Loki — distributor, ingester, querier, compactor — s’exécute dans un seul processus adossé à un magasin local de chunks, si bien que tout le serveur est une seule charge de travail avec état. Un expéditeur de logs pousse des flux vers Loki ; 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 logging (core/observability/loki) qui conserve les logs pendant sept jours. |
manifest.yaml | Mappe le type de composant vers la Recipe Loki à source (loki). |
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 chunks. |
Ce qu’il démontre
- Une seule surface de rédaction. Un seul Aggregate est la source de vérité sur ce qu’est Loki ; le Manifest dit comment le réaliser.
- Un backend de logs à binaire unique. La Recipe à source rend Loki sous forme d’un seul
StatefulSetavec un volume de données, de sa configuration dans desConfigMaps, deServices exposant l’endpoint HTTP de push et de requête, et d’unServiceAccount— une seule charge de travail autonome, les chemins de mise à l’échelle distribuée et les services auxiliaires fournis avec étant désactivés. - Une rétention définie par le développeur. Le
retention_perioddu développeur alimente le compactor intégré au processus, qui supprime les flux de logs stockés dès qu’ils dépassent cette durée. - Un contrat d’ingestion exporté. Le composant exporte l’hôte et le port de son service interne au cluster via la topologie
uses, si bien qu’un expéditeur de logs se connecte à lui et y pousse des flux. - Images reproductibles. La Recipe épingle l’image du serveur Loki et l’image du sidecar de rechargement de configuration sur des tags résolvables, si bien que la charge de travail rendue référence des versions épinglées.
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 loki-loggingElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd loki-loggingBuild
Cet espace de travail ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard se résolvent depuis le registre du hub, hub.aggrega.ai, et qu’aucun flag de catalogue n’est nécessaire :
aggrega pull --release release.yamlaggrega build --release release.yamlLes artefacts rendus se trouvent sous dist/. Le build résout le chart upstream par référence OCI lors de aggrega pull et l’épingle dans un lockfile.
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 `loki-logging`, appelez une fois l’outil `scaffold` avec `example` défini sur `loki-logging` et sans `dir` : il écrit l’exemple dans un nouveau dossier `loki-logging`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `loki-logging`, `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 `loki-logging/dist/`.Ce qui est rendu
Le build émet le serveur Loki sous forme d’un seul ensemble autonome d’objets Kubernetes :
- un
StatefulSet— le processus Loki à binaire unique, avec son magasin de chunks sur un volume persistant, - des
ConfigMaps — la configuration de Loki et la configuration d’exécution, - des
Services — exposant l’endpoint HTTP de push et de requête sur le port 3100, - un
ServiceAccountpour la charge de travail, avec ses liaisons d’accès.
Aucune charge de travail distribuée de lecture/écriture/backend, aucun sous-chart de magasin d’objets, aucun cache ni aucun opérateur n’est rendu — le rendu est une seule charge de travail Loki. Les images du serveur Loki et du sidecar de rechargement de configuration sont épinglées sur leurs tags de release, si bien que la charge de travail référence des images épinglées.