Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

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

ArchivoRol
aggregate.yamlIntención del desarrollador: un único componente logging (core/observability/loki) que conserva los logs durante siete días.
manifest.yamlAsigna el tipo de componente a la Recipe de Loki con origen (loki).
release.yamlDocumento 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 StatefulSet con un volumen de datos, su configuración en ConfigMaps, Services que exponen el endpoint HTTP de push y de consulta, y un ServiceAccount — 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_period del 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:

Terminal window
aggrega scaffold --example loki-logging

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd loki-logging

Compilació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:

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

Los 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 ServiceAccount para 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.