Loki — servidor de agregação de logs para Kubernetes
Este exemplo compila um stack pequeno e real — um servidor de agregação de logs Grafana Loki — a partir de um único Aggregate escrito pelo desenvolvedor para o Kubernetes, baseado no chart Helm oficial do Grafana Loki na sua estrutura de binário único.
O Loki é um backend de logs: recebe fluxos de logs pela sua API HTTP de push, indexa-os por rótulo em vez de por conteúdo de texto completo, armazena-os em um armazenamento de objetos de chunks e responde a requisições de consulta de logs e de intervalo pela mesma API HTTP. Na estrutura de binário único, cada subsistema do Loki — distributor, ingester, querier, compactor — é executado dentro de um único processo apoiado em um repositório local de chunks, então o servidor inteiro é uma única carga de trabalho com estado. Um enviador de logs envia fluxos para o Loki; um servidor de dashboards os lê de volta pela API de consulta.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um único componente logging (core/observability/loki) que mantém os logs por sete dias. |
manifest.yaml | Mapeia o tipo de componente para a Recipe do Loki com origem (loki). |
release.yaml | Documento do operador para o destino Kubernetes: a computação do servidor e o tamanho do volume do repositório de chunks. |
O que ele demonstra
- Uma única superfície de autoria. Um único Aggregate é a fonte da verdade sobre o que o Loki é; o Manifest diz como realizá-lo.
- Um backend de logs de binário único. A Recipe com origem renderiza o Loki como um único
StatefulSetcom um volume de dados, a sua configuração emConfigMaps,Services que expõem o endpoint HTTP de push e de consulta, e umServiceAccount— uma única carga de trabalho autônoma, com os caminhos de escalonamento distribuído e os serviços auxiliares incluídos desativados. - Retenção definida pelo desenvolvedor. O
retention_perioddo desenvolvedor flui para o compactor interno ao processo, que exclui os fluxos de logs armazenados assim que ultrapassam essa idade. - Um contrato de ingestão exportado. O componente exporta o host e a porta do seu serviço interno ao cluster por meio da topologia
uses, então um enviador de logs se conecta a ele e envia fluxos para lá. - Imagens reproduzíveis. A Recipe fixa a imagem do servidor Loki e a imagem do sidecar de recarga de configuração em tags resolvíveis, para que a carga de trabalho renderizada referencie versões fixadas.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example loki-loggingEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd loki-loggingBuild
Este espaço de trabalho não traz nenhum .aggrega-config.yaml, então as entidades da biblioteca padrão são resolvidas a partir do registro do hub, hub.aggrega.ai, e nenhuma flag de catálogo é necessária:
aggrega pull --release release.yamlaggrega build --release release.yamlOs artefatos renderizados ficam em dist/. O build resolve o chart upstream por referência OCI no aggrega pull e o fixa em um lockfile.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use somente as ferramentas do Aggrega e não crie nenhuma pasta você mesmo. Se a pasta do workspace ainda não contiver uma pasta `loki-logging`, chame a ferramenta `scaffold` uma vez com `example` definido como `loki-logging` e sem `dir`: ela grava o exemplo em uma nova pasta `loki-logging`. Depois chame a ferramenta `build` com `workspace_root` definido como `loki-logging`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `loki-logging/dist/`.O que é renderizado
O build emite o servidor Loki como um único conjunto autônomo de objetos do Kubernetes:
- um
StatefulSet— o processo do Loki de binário único, com o seu repositório de chunks em um volume persistente, ConfigMaps — a configuração do Loki e a configuração de runtime,Services — que expõem o endpoint HTTP de push e de consulta na porta 3100,- um
ServiceAccountpara a carga de trabalho, com as suas associações de acesso.
Não é renderizada nenhuma carga de trabalho distribuída de leitura/escrita/backend, nenhum subchart de armazenamento de objetos, cache ou operador — a renderização é uma única carga de trabalho do Loki. As imagens do servidor Loki e do sidecar de recarga de configuração são fixadas nas suas tags de release, para que a carga de trabalho referencie imagens fixadas.