Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

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

FicheiroPapel
aggregate.yamlIntenção do programador: um único componente logging (core/observability/loki) que conserva os logs durante sete dias.
manifest.yamlMapeia o tipo de componente para a Recipe do Loki com origem (loki).
release.yamlDocumento 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 StatefulSet com um volume de dados, a sua configuração em ConfigMaps, Services que expõem o endpoint HTTP de push e de consulta, e um ServiceAccount — 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_period do 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:

Terminal window
aggrega scaffold --example loki-logging

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd loki-logging

Compilaçã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:

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

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