Loki — servidor de agregação de logs para Kubernetes
Este exemplo compila uma stack pequena e real — um servidor de agregação de logs Grafana Loki — a partir de um único Aggregate escrito pelo programador para o Kubernetes, baseada no chart Helm oficial do Grafana Loki na sua estrutura de binário único.
O Loki é um backend de logs: recebe fluxos de logs através da sua API HTTP de push, indexa-os por etiqueta em vez de por conteúdo de texto integral, armazena-os num armazenamento de objetos de chunks e responde a pedidos de consulta de logs e de intervalo através da mesma API HTTP. Na estrutura de binário único, cada subsistema do Loki — distributor, ingester, querier, compactor — é executado dentro de um único processo apoiado num repositório local de chunks, pelo que todo o servidor é uma única carga de trabalho com estado. Um expedidor de logs envia fluxos para o Loki; um servidor de dashboards lê-os de volta através da API de consulta.
Ficheiros
| Ficheiro | Papel |
|---|---|
aggregate.yaml | Intenção do programador: um único componente logging (core/observability/loki) que conserva os logs durante 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 demonstra
- Uma única superfície de autoria. Um único Aggregate é a fonte de 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 escalamento distribuído e os serviços auxiliares incluídos desativados. - Retenção definida pelo programador. O
retention_perioddo programador flui para o compactor interno ao processo, que elimina 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 através da topologia
uses, pelo que um expedidor de logs se liga a ele e lhe envia fluxos. - Imagens reproduzíveis. A Recipe fixa a imagem do servidor Loki e a imagem do sidecar de recarregamento da configuração em tags resolúveis, para que a carga de trabalho renderizada referencie versões fixadas.
Gerar o exemplo
É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.
Escreva o exemplo numa nova pasta com o nome dele:
aggrega scaffold --example loki-loggingDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd loki-loggingCompilação
Este espaço de trabalho não inclui nenhum .aggrega-config.yaml, pelo que as entidades da biblioteca standard são resolvidas a partir do registo do hub, hub.aggrega.ai, e não é necessária nenhuma flag de catálogo:
aggrega pull --release release.yamlaggrega build --release release.yamlOs artefactos renderizados ficam em dist/. A compilação resolve o chart upstream por referência OCI no aggrega pull e fixa-o num lockfile.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.
Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta da área de trabalho ainda não contiver uma pasta `loki-logging`, chame uma vez a ferramenta `scaffold` com `example` definido como `loki-logging` e sem `dir`: esta escreve o exemplo numa nova pasta `loki-logging`. Em seguida, 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. Indique quais os ficheiros que a compilação escreveu; encontram-se em `loki-logging/dist/`.O que é renderizado
A compilação 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 num 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 recarregamento da configuração estão fixadas nas suas tags de release, pelo que a carga de trabalho referencia imagens fixadas.