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

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

FichierRôle
aggregate.yamlIntention du développeur : un seul composant logging (core/observability/loki) qui conserve les logs pendant sept jours.
manifest.yamlMappe le type de composant vers la Recipe Loki à source (loki).
release.yamlDocument 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 StatefulSet avec un volume de données, de sa configuration dans des ConfigMaps, de Services exposant l’endpoint HTTP de push et de requête, et d’un ServiceAccount — 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_period du 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 :

Terminal window
aggrega scaffold --example loki-logging

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

Terminal window
cd loki-logging

Build

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 :

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

Les 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 ServiceAccount pour 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.