Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Loki — server di aggregazione dei log per Kubernetes

Questo esempio compila uno stack piccolo e reale — un server di aggregazione dei log Grafana Loki — a partire da un unico Aggregate scritto dallo sviluppatore per Kubernetes, basato sul chart Helm ufficiale di Grafana Loki nella sua struttura a binario singolo.

Loki è un backend di log: riceve flussi di log tramite la sua API HTTP di push, li indicizza per etichetta anziché per contenuto a testo completo, li archivia in un object store di chunk e risponde alle richieste di query dei log e di intervallo tramite la stessa API HTTP. Nella struttura a binario singolo ogni sottosistema di Loki — distributor, ingester, querier, compactor — viene eseguito all’interno di un unico processo supportato da uno store locale di chunk, quindi l’intero server è un unico carico di lavoro con stato. Un log shipper invia i flussi a Loki; un server di dashboard li rilegge tramite l’API di query.

File

FileRuolo
aggregate.yamlIntento dello sviluppatore: un unico componente logging (core/observability/loki) che conserva i log per sette giorni.
manifest.yamlMappa il tipo di componente sulla Recipe di Loki con sorgente (loki).
release.yamlDocumento dell’operatore per la destinazione Kubernetes: le risorse di calcolo del server e la dimensione del volume dello store dei chunk.

Che cosa dimostra

  • Un’unica superficie di authoring. Un unico Aggregate è la fonte di verità su che cosa è Loki; il Manifest dice come realizzarlo.
  • Un backend di log a binario singolo. La Recipe con sorgente renderizza Loki come un unico StatefulSet con un volume di dati, la sua configurazione in ConfigMaps, Services che espongono l’endpoint HTTP di push e di query e un ServiceAccount — un unico carico di lavoro autonomo, con i percorsi di scalabilità distribuita e i servizi ausiliari inclusi disattivati.
  • Conservazione impostata dallo sviluppatore. Il retention_period dello sviluppatore confluisce nel compactor interno al processo, che elimina i flussi di log archiviati una volta superata quell’età.
  • Un contratto di ingestione esportato. Il componente esporta l’host e la porta del suo servizio interno al cluster tramite la topologia uses, così un log shipper si connette a esso e vi invia i flussi.
  • Immagini riproducibili. La Recipe fissa l’immagine del server Loki e l’immagine del sidecar di ricaricamento della configurazione a tag risolvibili, così il carico di lavoro renderizzato fa riferimento a versioni fissate.

Generare l’esempio

Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.

Scrivi l’esempio in una nuova cartella che porta il suo nome:

Terminal window
aggrega scaffold --example loki-logging

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd loki-logging

Build

Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard si risolvono dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo:

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

Gli artefatti renderizzati finiscono sotto dist/. Il build risolve il chart upstream tramite riferimento OCI con aggrega pull e lo fissa in un lockfile.

Con un assistente AI

Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.

Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella del workspace non contiene ancora una cartella `loki-logging`, chiama una volta lo strumento `scaffold` con `example` impostato su `loki-logging` e senza `dir`: scrive l’esempio in una nuova cartella `loki-logging`. Poi chiama lo strumento `build` con `workspace_root` impostato su `loki-logging`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano in `loki-logging/dist/`.

Che cosa viene renderizzato

Il build emette il server Loki come un unico insieme autonomo di oggetti Kubernetes:

  • uno StatefulSet — il processo Loki a binario singolo, con il suo store dei chunk su un volume persistente,
  • ConfigMaps — la configurazione di Loki e la configurazione di runtime,
  • Services — che espongono l’endpoint HTTP di push e di query sulla porta 3100,
  • un ServiceAccount per il carico di lavoro, con i suoi binding di accesso.

Non vengono renderizzati carichi di lavoro distribuiti di lettura/scrittura/backend, subchart di object store, cache né operatore — il rendering è un unico carico di lavoro Loki. Le immagini del server Loki e del sidecar di ricaricamento della configurazione sono fissate ai loro tag di release, così il carico di lavoro fa riferimento a immagini fissate.