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
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un unico componente logging (core/observability/loki) che conserva i log per sette giorni. |
manifest.yaml | Mappa il tipo di componente sulla Recipe di Loki con sorgente (loki). |
release.yaml | Documento 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
StatefulSetcon un volume di dati, la sua configurazione inConfigMaps,Services che espongono l’endpoint HTTP di push e di query e unServiceAccount— un unico carico di lavoro autonomo, con i percorsi di scalabilità distribuita e i servizi ausiliari inclusi disattivati. - Conservazione impostata dallo sviluppatore. Il
retention_perioddello 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:
aggrega scaffold --example loki-loggingPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd loki-loggingBuild
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:
aggrega pull --release release.yamlaggrega build --release release.yamlGli 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
ServiceAccountper 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.