v1.1.1

Diagnóstico de cluster
um arquivo.

groot é um coletor read-only de logs e contexto Kubernetes — contrato estável v1.0 com config e arquivos versionados. Preflight com validate, collect num .tar.gz, inspect sem acesso ao cluster.

GROOT — Kubernetes log collector 
$ groot validate --config groot.yml
$ groot collect --config groot.yml --summary
$ groot inspect ./groot-*.tar.gz
curl -fsSL https://get.groot.hermesrodriguez.com/install.sh | sh
Todos os métodos de instalação Releases

Verificações preflight

groot validate verifica config, API, RBAC e espaço em disco antes de um collect longo — menos surpresas em plantão.

Bundle pronto para incidentes

Um .tar.gz reprodutível com manifest, TSVs de RCA, run_id estável e archive_layout_version — anexe a tickets ou retenha para compliance.

Nível operador

Plugin kubectl, completion shell, perfis de config, releases assinados; deploy agendado em groot-selfhosted; collect sob demanda via groot-trigger; catálogo VPS via groot-share (gfs).

Fluxo de resposta a incidentes

Do alerta ao arquivo offline: valide RBAC antes do collect, empacote evidências num .tar.gz, inspect sem acesso ao cluster.

Fluxo de resposta a incidentes Kubernetes com GROOT: validate, collect, inspect e partilha de um arquivo

Releases recentes

v1.1.1 2026-08-11

Correções
  • kubeconfig expande ~ e ${VAR} (YAML, KUBECONFIG, --kubeconfig); também caminhos SFTP
  • sessionBase único por collect — collects concorrentes no mesmo segundo não colidem
  • Credenciais S3 removem espaços (evita SignatureDoesNotMatch Contabo/S3-compatible)

v1.1.0 2026-08-10

Analyze
  • groot analyze offline — dicas heurísticas a partir de um .tar.gz (sem acesso ao cluster)
  • Markdown executivo, JSON estruturado ou pack pronto para LLM
  • Corpus de fixtures douradas em testing/fixtures/archives/ com locks no CI

Changelog completo no GitHub

Estável 1.1.1

Contrato estável em v1.0

config_version: 1

Declare a versão do esquema YAML em groot.yml; configs legacy sem ela continuam a carregar sem alterações.

archive_layout_version

Cada novo arquivo regista a versão de layout em extras/manifest.json para ferramentas downstream e automação.

collect --output json

Summary JSON estruturado após collect bem-sucedido — validate e inspect já suportam JSON desde 0.9.x.

validate · collect · inspect

Ciclo de incidente em três comandos: preflight RBAC, collect .tar.gz com --summary, revisão offline do arquivo.

run_id + checksum

run_id estável e archive_sha256 em manifest.json; webhooks notify e metadados de upload podem referenciar {{run_id}}.

Governança

CODEOWNERS, modelos issue/PR, golden inspect fixture em CI — contrato testado em cada release. Ver SPECIFICATIONS.md.

Início rápido

Deploy CronJob Helm: groot-selfhosted/run/deploy

Família Groot

Repo Papel
hrodrig/groot CLI, SPEC, releases, imagem container
hrodrig/groot-selfhosted Helm CronJob, bastion, Docker — deploy de operador (imagem pin 1.1.1)
hrodrig/groot-trigger HTTP in-cluster → Job groot collect (sob demanda)
hrodrig/groot-share (gfs) gfs — porta web/API em VPS para arquivos .tar.gz (auth, ingest, lista, retenção)
hrodrig/groot-share-selfhosted Compose, systemd, Helm para gfs (vps / vps-s3)