Loki — servidor de agregación de logs para Kubernetes
Este ejemplo compila un stack pequeño y real — un servidor de agregación de logs Grafana Loki — a partir de un único Aggregate escrito por el desarrollador para Kubernetes, respaldado por el chart de Helm oficial de Grafana Loki en su estructura de binario único.
Loki es un backend de logs: recibe flujos de logs mediante su API HTTP de push, los indexa por etiqueta en lugar de por contenido de texto completo, los almacena en un almacén de objetos de chunks y responde a las solicitudes de consulta de logs y de rango mediante la misma API HTTP. En la estructura de binario único, cada subsistema de Loki — distributor, ingester, querier, compactor — se ejecuta dentro de un único proceso respaldado por un almacén local de chunks, así que todo el servidor es una única carga de trabajo con estado. Un enviador de logs envía flujos a Loki; un servidor de paneles los vuelve a leer mediante la API de consulta.
Archivos
| Archivo | Rol |
|---|---|
aggregate.yaml | Intención del desarrollador: un único componente logging (core/observability/loki) que conserva los logs durante siete días. |
manifest.yaml | Asigna el tipo de componente a la Recipe de Loki con origen (loki). |
release.yaml | Documento del operador para el destino Kubernetes: el cómputo del servidor y el tamaño del volumen del almacén de chunks. |
Lo que demuestra
- Una única superficie de autoría. Un único Aggregate es la fuente de verdad sobre qué es Loki; el Manifest dice cómo realizarlo.
- Un backend de logs de binario único. La Recipe con origen renderiza Loki como un único
StatefulSetcon un volumen de datos, su configuración enConfigMaps,Services que exponen el endpoint HTTP de push y de consulta, y unServiceAccount— una única carga de trabajo autónoma, con las rutas de escalado distribuido y los servicios auxiliares incluidos desactivados. - Retención establecida por el desarrollador. El
retention_perioddel desarrollador llega al compactor interno del proceso, que elimina los flujos de logs almacenados en cuanto superan esa antigüedad. - Un contrato de ingesta exportado. El componente exporta el host y el puerto de su servicio interno del clúster mediante la topología
uses, así que un enviador de logs se conecta a él y le envía flujos. - Imágenes reproducibles. La Recipe fija la imagen del servidor Loki y la imagen del sidecar de recarga de configuración a etiquetas resolubles, así que la carga de trabajo renderizada hace referencia a versiones fijadas.
Generar el ejemplo
Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example loki-loggingDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd loki-loggingCompilación
Este espacio de trabajo no contiene ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no hace falta ningún flag de catálogo:
aggrega pull --release release.yamlaggrega build --release release.yamlLos artefactos renderizados quedan bajo dist/. La compilación resuelve el chart upstream por referencia OCI en aggrega pull y lo fija en un lockfile.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees tú ninguna carpeta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `loki-logging`, llama una vez a la herramienta `scaffold` con `example` establecido en `loki-logging` y sin `dir`: escribe el ejemplo en una nueva carpeta `loki-logging`. Después llama a la herramienta `build` con `workspace_root` establecido en `loki-logging`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `loki-logging/dist/`.Qué se renderiza
La compilación emite el servidor Loki como un único conjunto autónomo de objetos de Kubernetes:
- un
StatefulSet— el proceso de Loki de binario único, con su almacén de chunks en un volumen persistente, ConfigMaps — la configuración de Loki y la configuración de runtime,Services — que exponen el endpoint HTTP de push y de consulta en el puerto 3100,- un
ServiceAccountpara la carga de trabajo, con sus enlaces de acceso.
No se renderizan cargas de trabajo distribuidas de lectura/escritura/backend, ni subchart de almacén de objetos, ni caché, ni operador — el renderizado es una única carga de trabajo de Loki. Las imágenes del servidor Loki y del sidecar de recarga de configuración están fijadas a sus etiquetas de release, así que la carga de trabajo hace referencia a imágenes fijadas.