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

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

ArquivoPapel
aggregate.yamlIntenção do desenvolvedor: um único componente logging (core/observability/loki) que mantém os logs por 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 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 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 escalonamento distribuído e os serviços auxiliares incluídos desativados.
  • Retenção definida pelo desenvolvedor. O retention_period do 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:

Terminal window
aggrega scaffold --example loki-logging

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd loki-logging

Build

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:

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

Os 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 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 recarga de configuração são fixadas nas suas tags de release, para que a carga de trabalho referencie imagens fixadas.