Pular para o conteúdo

Operação

Changelog

Versionado contra as revisões do próprio CONTRACT.md, não contra um calendário de releases. Este conjunto de documentação não imprime uma data que não consiga verificar a partir do próprio repositório. Onde "em andamento" aparece abaixo no lugar de uma data, o repositório não guarda data verificável, e a lacuna é deliberada. Versão atual: 0.1.0 (.env.example → VERSION; também o appVersion do Chart.yaml).

Análises de logs que medem (não lançado)

Adicionado

  • As análises de logs medem, além de contar: a contagem única de um campo, a média, o mínimo, o máximo, a soma, o p50, p90, p95 ou p99 de um número que a linha traz (um atributo ou uma chave da própria mensagem JSON, como duration_ms), ou a taxa de erros, por qualquer campo, do maior para o menor, na sua unidade, com uma linha de todas as linhas na tabela. Veja logs.md.
  • @status:503 encontra o status HTTP de uma linha onde quer que ela o escreva: um atributo, uma chave JSON ou uma linha de acesso. A faceta de status lista o mesmo, com 4xx e 5xx em cor. Uma chave sem ponto também lê a chave da própria mensagem JSON (@route:...).
  • shape:"<pattern>" encontra exatamente as linhas de um padrão. O mais, o menos e as linhas de um padrão, o erro mais frequente da faixa de erros e os painéis de logs dos dashboards o usam.

Alterado

  • Um padrão guarda as chaves de uma linha JSON só quando a requisição falhou, então as rotas 2xx dividem uma linha e as falhas continuam na primeira tela, e os padrões FATAL, ERROR e WARN vêm primeiro.

Corrigido

  • O menos de um padrão não esconde mais as requisições que falharam com a mesma mensagem, e o mais não as conta.
  • As linhas guardadas antes de o engine ler os níveis do texto têm o nível lido quando você as consulta, então o histograma, as facetas, os padrões e a faixa de erros de uma janela usam uma só fonte de nível.
  • Uma lista dos maiores ou uma pizza medida mostra cada valor na sua unidade (111 ms) e uma parcela só para contagem ou soma. A série temporal medida agrupa em um terço dos pontos, traz a unidade no eixo e na legenda, e deixa os valores finais para a legenda. As tendências da tabela medida deixam um intervalo vazio como lacuna, e as medidas extras vêm da mesma leitura, então as linhas Outros e Todas as linhas ficam preenchidas. Uma divisão aninhada desempata a medida pelas linhas e chama uma linha sem nível de "Sem nível". @status:ok volta a achar o status da própria aplicação.
  • Os padrões de erro e de aviso continuam na lista quando padrões INFO mais movimentados enchem os 50 primeiros, e uma linha de padrão mostra o formato das datas e a faixa dos números das linhas mais recentes antes de você abri-la.

Padrões de logs que dizem por quê (não lançado)

Adicionado

  • Um padrão de logs guarda, ao lado da mensagem, o status HTTP, o método, a rota ou o modelo do caminho e a classe do erro de uma linha JSON, e o status HTTP de uma linha de acesso, então um 503 é uma linha separada de um 200: http request status=503 route=GET /api/.... O erro mais frequente da faixa de erros aparece do mesmo jeito, e o clique nele e o mais de um padrão encontram exatamente essas linhas. Veja logs.md.
  • Uma linha da lista mostra as chaves de status e de erro logo depois da mensagem, com um status 4xx ou 5xx em cor e as chaves esmaecidas para os valores serem lidos primeiro. Uma linha aberta mostra a requisição em etiquetas: método, rota, status e duração.
  • O painel de facetas tem "Buscar facetas", nos nomes e nos valores, com "Mostrando N de M", e contagens a partir de 10.000 aparecem abreviadas. O ao vivo diz que parte das linhas mostra quando chegam mais do que uma leitura retorna.
  • A primeira tela mostra mais linhas: as visões salvas ficam na linha da consulta, a dica de uso foi para a ajuda, o histograma ficou mais baixo com a faixa de erros na linha da legenda, e as abas de visualização encabeçam os resultados.

Corrigido

  • Um surto de erros começa no primeiro intervalo cheio: uns poucos erros soltos antes dele não fazem parte dele.
  • A taxa ao vivo é a média dos 4 últimos intervalos inteiros. Uma linha de erro mantém a barra do nível sem o fundo rosa. service:a, vale service:a, como o engine lê.

Facetas de logs como as do Datadog, padrões por nível e serviço (não lançado)

Adicionado

  • As facetas de logs contam cada uma pela consulta sem os seus próprios termos, então um valor marcado deixa os outros listados. Um clique junta um valor aos marcados (service:cart,checkout, qualquer um deles), "Só" deixa apenas um, o sinal de menos exclui um, e uma faceta com mais de 10 valores tem uma caixa de busca. Facetas novas: workload, contêiner, nó, tag da imagem, versão e status HTTP. A linguagem de consulta aceita key:a,b para qualquer um dos valores. Veja logs.md.
  • Os padrões são uma linha por forma, nível e serviço, como o Datadog os separa; o mais de uma linha acrescenta o nível e o serviço dela, e uma linha aberta lista o que cada * guardava nas suas linhas mais recentes.
  • A faixa de erros nomeia um surto que já passou e desde quando os erros voltaram à taxa anterior.
  • Um nível lido da marca do Valkey e do Redis, e de failed:.

Corrigido

  • As regras de ingestão agem sobre o nível que a linha traz, nunca sobre um lido do texto dela, então uma regra que descarta um nível guarda as linhas que já guardava.
  • A faixa de erros não chama mais de subida um surto que já passou, e as leituras dela correm junto com as da página, e não depois.
  • A contagem por nível dos dashboards empilha os erros em cima, como o histograma do explorador. O eixo do histograma conta linhas inteiras. A fatia de um padrão tem uma casa decimal.

Nível dos logs lido da linha (não lançado)

Adicionado

  • Uma linha de log que chega sem nível recebe o que o próprio texto indica: prefixos klog, linhas de acesso HTTP pelo status, level= e níveis em JSON (também os números do pino), [WARN], ERROR: (entre eles o UTC [pid] ERROR: do Postgres), o fail: do .NET e o ] INFO [ do Kafka. Uma linha recuada ou o STATEMENT: do Postgres recebe o nível da linha anterior do mesmo contêiner. O engine armazena esse nível, então o histograma, as facetas, severity:, a faixa de erros, os padrões, a análise e as regras de ingestão o contam, e a lista o marca com um anel. As linhas armazenadas antes continuam sem nível. Veja logs.md.
  • Um padrão nomeia o seu pior nível e o serviço que mais escreveu as linhas dele na janela inteira, e se abre nas suas 20 linhas mais recentes, com horário e nível.

Corrigido

  • A faixa de erros encontra uma subida depois de um pico no começo: a taxa anterior é a média interquartil dos intervalos anteriores, e a subida é o primeiro intervalo a partir do qual a média se mantém em 3 vezes essa taxa.
  • Uma visão salva de logs guarda o campo e o top da análise. O histograma empilha os erros no topo. Uma consulta nova não mostra mais os serviços e o erro principal da anterior na faixa de erros. As fatias têm uma casa decimal, a pizza oferece top 5 ou 8 e, no celular, a tabela da análise tira a coluna de tendência antes das contagens.

Análise de logs e erros num relance (não lançado)

Adicionado

  • O explorador de logs conta todas as linhas que a consulta encontra por um campo, como série temporal, ranking, tabela com a tendência de cada valor ou pizza, ao lado de Linhas e Padrões. É uma leitura GET /api/v1/logs/aggregate, a mesma que os painéis de logs dos dashboards fazem. Veja logs.md.
  • Abaixo do histograma, as linhas de erro da janela: quantas, desde quando subiram, os 3 serviços que mais as escreveram e a forma mais frequente delas, cada um com um clique para essas linhas.
  • Uma linha de log traz a cor do seu nível na borda esquerda, e uma linha de erro um tom vermelho. Um padrão nomeia o serviço que mais escreveu as suas linhas. Uma linha aberta passa para a próxima com as setas e dá o horário completo com há quanto tempo foi escrita. Ao vivo mostra as linhas por segundo.

Mapa de workloads (unreleased)

Adicionado

  • A lista de workloads abre como mapa (Mapa ao lado de Tabela, ou ?view=map): um quadrado por pod, agrupado por namespace, node ou workload, colorido por status, por CPU ou memória contra o request ou o limit, ou por restarts. O grupo com mais pods falhando vem primeiro, e o pior pod dele também. Os facets e a busca filtram o mapa como filtram a tabela, a legenda conta cada cor e fixa uma com um clique, e ?group= e ?fill= guardam a escolha no link. Apontar para um pod mostra status, node, restarts com o motivo da última saída e o uso contra request e limit; um clique o fixa ali, com links para o pod, os logs dele e o painel do workload.
  • A aba YAML de um workload, na página dele e no painel da lista de workloads, mostra o controller como o API server o guarda, sem managedFields e sem a cópia do last-applied, com todo valor que seria de uma credencial mascarado como um diff o mascara. Ela exige config.read e lê GET /api/v1/clusters/{id}/workloads/{ns}/{kind}/{name}/manifest só quando a aba abre; cada leitura é auditada como workload.manifest.view.

https atrás de uma CDN (não lançado)

Corrigido

  • Um ingress sem TLS atrás de uma CDN sobrescreve o X-Forwarded-Proto com http, então o web definia os cookies sem Secure nem __Host- e imprimia http:// no snippet do MCP e nos redirect URIs de SSO. O publicUrl agora chega ao web, e um endereço https nele prevalece sobre o header. Vazio, nada muda. Veja configuration.md.

Notas de upgrade

  • Uma instalação com publicUrl https cujo ingress diz http faz todo mundo entrar mais uma vez no upgrade, e de novo num rollback: o web não lê uma sessão sob orbit_session no https.

O que a página de um serviço conta (não lançado)

Corrigido

  • Workers e crons que informam o service.name de uma API não se passam mais pela API. Tempo por dependência conta só o que as dependências levaram dentro das requisições, em vez de pôr quase tudo no Redis. Serviços chamados e o painel e o texto das arestas do mapa de serviços mostram primeiro as chamadas feitas dentro de uma requisição e nomeiam o resto como segundo plano. Os traces recentes, os erros recentes e os tipos de erro listam os traces que uma requisição iniciou. GET /api/v1/apm/servicemap adiciona backgroundRate à aresta, e três séries entram no grafo de serviços (apm.md).
  • A contagem de pods da página do serviço agora é Pods enviando spans: conta os pods cujos spans levam o nome, não as réplicas do workload citado acima.

O que conta como segredo (não lançado)

Corrigido

  • A aba Configuração mostrava em claro um valor cujo nome dizia segredo com palavras que a regra não conhecia: uma passphrase, DB_PASS, API_SIGNATURE. Mais nomes agora mascaram, ali e nas ferramentas do Nocturne, num diff, na linha de comando do terminal e numa coluna de banco: passphrase, passcode, *_PASS, um nome que termina em SIGNATURE ou _SIG, chaves de assinatura e de criptografia, HMACKEY, MASTERKEY, PRIVKEY, KEY_PEM e parecidos, PASS_1, SSHPASS, o -storepass do keytool, o --requirepass do Redis, *_CREDS, BEARER, BASIC_AUTH, *_SALT, *_PEPPER, SENHA, SEGREDO, CHAVE. Cada um mantém o Revelar auditado.
  • Uma senha dentro de um valor também mascara: redis://:x@host, um DSN MySQL do Go, uma URL JDBC da Oracle, o AccountKey= da Azure, a assinatura de uma URL assinada, dbPassword: x, --db-password=x, um *_KEY=x em maiúsculas num texto.
  • Um vetor de inicialização, KEY_ID e SIGNATURE_VERSION seguem em claro: nenhum é segredo. PUBLIC_KEY e TOKEN_TTL seguem mascarados, como antes: um clique para ler.
  • Um patch que o Nocturne confere não mostra mais um segredo no diff quando o patch remove ou adiciona uma lista ou um objeto inteiro, como uma lista env removida com o contêiner ou o data de um ConfigMap, ou altera args que levam --password x. Um host ou uma imagem com nome de credencial (auth-token:8080, registry.example/team/app-token:1.2.3) e o matchLabelKeys de uma regra de agendamento seguem legíveis.

Um Deck mais leve no navegador (não lançado)

Alterado

  • Pelo web, uma resposta JSON de 1 KiB ou mais trafega com gzip quando a requisição aceita. Um trace de 2.000 spans passa de 845 para 80 KB.
  • Uma primeira carga busca quatro arquivos de fonte, não seis: o itálico e o peso 500 da mono carregam na primeira tela que os desenha.
  • As páginas de logs carregam o motor de regex com o primeiro termo /regex/. Até ele chegar, cerca de uma ida e volta, esse termo não é marcado nas linhas.
  • Um dashboard carrega os editores, as configurações e o código dos painéis de log quando precisa deles, e a lista de economias o formulário de escala quando uma gaveta abre.

Visões de trace (não lançado)

Adicionado

  • O flame graph aproxima com a rolagem, desloca ao arrastar e é percorrido pelo teclado. Spans que rodaram ao mesmo tempo se empilham em vez de se esconderem, e ele desenha só o que está na tela, então um trace com milhares de spans de profundidade não ultrapassa mais o limite do canvas.
  • Operações, uma terceira visão do trace: chamadas, tempo próprio e caminho crítico por serviço e operação, e uma comparação com outro trace ou com um típico (?compare=<id>). Veja apm.md.
  • Cores por tempo próprio, Erros raiz, um recolhimento até os saltos entre serviços e os termos do explorador na busca do trace.
  • Os atributos de um span se agrupam por namespace, e cada um copia o valor, encontra os spans dele no trace e busca no explorador com ou sem ele.

Corrigido

  • Percorrer spans com o painel aberto levava o teclado para o painel, então só a primeira seta funcionava. Também disparava as leituras do painel no servidor a cada passo; agora elas esperam o cursor parar por 250 ms.
  • Um serviço na legenda do trace encontrava todo span cujos atributos o citassem. Agora encontra esse serviço.

Arquivos de log das aplicações (não lançado)

Adicionado

  • telemetry.logs.files: o orbit-node lê arquivos de log que as aplicações escrevem num hostPath, como o storage/logs/laravel.log do Laravel e o diário laravel-YYYY-MM-DD.log, e junta cada entrada ao seu stack trace. O diretório de cada fonte é montado somente leitura; / e os diretórios do sistema são recusados. Veja logs.md, "Arquivos de log das aplicações".

Corrigido

  • O orbit-collector não dá mais a um recurso de log que nomeia um arquivo no node (log.file.path) o pod da conexão que o enviou.

Notificações de alertas (não lançado)

Adicionado

  • Alertas → Notificações: um admin publica os alertas do Deck no Slack, no Microsoft Teams (Workflows) ou no Google Chat por webhooks de entrada, com roteamento por severidade, cluster e namespace, uma espera antes da primeira mensagem, repetições, mensagens de resolução, emoji por severidade, um modelo de título, uma menção no Slack e um link de volta para o Deck. Alertas reconhecidos e silenciados não acionam ninguém. Veja alert-notifications.md.
  • alerting.notifications.enabled, alerting.interval, alerting.allowedHosts e publicUrl no chart; orbit_api_alert_notifications_total{kind,result} nas métricas do orbit-api.

Métricas do CloudWatch (não lançado)

Adicionado

  • cloudwatch.enabled: o orbit-agent lê métricas do AWS CloudWatch (oito métricas do RDS por padrão) para o orbit-stack, com os nomes do prometheus/cloudwatch_exporter, então os dashboards do Grafana feitos para ele funcionam sem mudança. Ele lê a cada cloudwatch.interval (3m por padrão) com resolução de 1 minuto; só as séries ativas recentemente são pedidas. Veja em cloudwatch.md o custo por intervalo.
  • A role somente leitura ganha cloudwatch:GetMetricData e cloudwatch:ListMetrics, e o deploy/aws/setup-pod-identity.sh também associa <release>-orbit-agent a ela.

FinOps: alocação, economia, custo por request, orçamentos (não lançado)

Adicionado

  • O FinOps tem quatro abas: Visão geral, Economia, Custo por request e Orçamentos. Veja finops.md.
  • O explorador de alocação divide o custo por namespace, workload, time, node group, arquitetura ou tipo de capacidade em 24h, 7d ou 30d, com custo ocioso, eficiência e uma tendência de 14 dias por linha.
  • O custo diário dos últimos 30 dias, o acumulado do mês e a previsão de fechamento com a sua faixa.
  • A central de economia ordena cada forma de gastar menos: rightsize, downscale, autoscale, ocioso, Spot, Graviton, consolidação e volumes órfãos. Cada item traz as suas evidências e o seu patch; mudanças de recursos e de réplicas são aplicadas pelas rotas de escrita existentes.
  • Custo por request: o custo de cada serviço do APM por mil requisições, com o p95 e a taxa de erro.
  • Orçamentos por cluster, namespace ou time, com os status ok, warn e over. As escritas exigem settings.manage e são auditadas.
  • Anomalias de custo, com severidade e a causa mais provável.
  • Oito rotas sob /api/v1/clusters/{id}/finops/, controladas pela chave de recurso de FinOps.

Adendo v0.20: o backend é Rust (não lançado)

Alterado

  • Toda imagem de backend é construída a partir de services/rust/<name>: orbit-api, nocturne, orbit-stack e os engines orbit-*, sobre gcr.io/distroless/cc-debian12:nonroot. Os mesmos nomes, portas, variáveis, rotas e diretórios de dados de antes. Os originais em Go vivem na tag git go-oracle, só como oráculo diferencial.
  • Os engines padrão do chart passam a ser orbit: telemetry.agent.engine, telemetry.nodeExporter.engine, telemetry.kubeStateMetrics.engine e apm.collector.engine. Um upgrade troca esses workloads num único rolling update; defina prometheus / upstream para manter as imagens upstream. Com o orbit-agent não há o job kubelet; nada o consultava.
  • O orbit-stack não tem coletor de lixo: GOGC, GOMEMLIMIT e ORBIT_STACK_MEMORY_LIMIT são ignorados. Veja orbit-stack.md → "Memória".
  • Os harnesses de benchmark e diferenciais foram para services/rust/orbit-stack/bench/ e medem o engine em Rust por padrão; ENGINE=go roda o em Go a partir da tag dele.

Adendo v0.5: identidade, auditoria, dashboards e APM (não lançado, 2026-09-24)

Adicionado

  • Usuários, sessões e papéis no orbit-api: contas locais com senhas em PBKDF2; sessões assinadas e revogáveis de 12 horas, carregadas pelo cookie orbit_session (HttpOnly); três papéis embutidos e papéis personalizados sobre onze permissões, checadas em toda rota. O primeiro administrador vem de ORBIT_ADMIN_USER e ORBIT_ADMIN_PASSWORD_VERIFIER, de três contas de demonstração quando os dados são de demonstração, ou de um código de configuração de uso único registrado no log. Páginas novas: /login, /deck/account, /deck/admin/users, /deck/admin/roles. Veja identity.md.
  • A trilha de auditoria: todo login, toda mudança e toda recusa como um evento com ator, alvo, resultado, endereço do cliente e id da requisição, consultável em /deck/admin/audit e em GET /api/v1/audit, exportável como CSV e retido pelo prazo de ORBIT_AUDIT_RETENTION. Veja audit.md.
  • Dashboards: cinco dashboards nativos e somente leitura, um editor, variáveis, um modelo JSON, importação do Grafana e salvamentos versionados, todos guardados pelo orbit-api. Veja dashboards.md.
  • Traces e APM: o orbit-stack recebe OTLP/HTTP em POST /v1/traces, guarda os spans pelo prazo de ORBIT_STACK_TRACE_RETENTION e deriva métricas de span e séries de service graph com os nomes do Tempo; o Deck ganhou as páginas de serviços, de mapa de serviços, de busca de traces e de trace. A loja de demonstração, orbit-shop, roda no compose e atrás de demo.shop.enabled. Veja apm.md.
  • Reconhecimentos e silenciamentos de alertas, guardados pelo orbit-api, liberados por workloads.write e auditados; uma seção de runbook para cada regra derivada. Veja alerts.md.
  • Leads de contato (Adendo v0.7): gravados antes de o formulário receber a resposta, listados em /deck/admin/leads e em GET /api/v1/leads e, opcionalmente, enviados por POST para ORBIT_CONTACT_WEBHOOK_URL.
  • Variáveis novas: ORBIT_DATA_DIR, ORBIT_SESSION_SECRET, ORBIT_ADMIN_USER, ORBIT_ADMIN_PASSWORD_VERIFIER, ORBIT_AUDIT_RETENTION, ORBIT_CONTACT_WEBHOOK_URL, WEB_TRUST_PROXY, ORBIT_STACK_TRACE_RETENTION, ORBIT_STACK_TRACE_HEAD_BYTES e as ORBIT_SHOP_* da loja. Veja configuration.md.
  • Um décimo segundo código de erro, forbidden (403): uma sessão válida cujo papel não tem a permissão exigida pela rota.

Alterado / quebras de compatibilidade

  • Toda rota do orbit-api, exceto as probes, as rotas de login e o contact, exige uma sessão, além do bearer. Um script que chamava GET /api/v1/version ou GET /api/v1/clusters só com o bearer agora recebe 401: faça login antes (identity.md → "Entrar pelo shell"). O GET /api/v1/auth/state responde só com o bearer e é a nova forma de conferir isso.
  • O orbit-api roda uma única réplica em todos os caminhos de instalação, sobre um armazenamento de escritor único em ORBIT_DATA_DIR. O chart força replicas: 1, recusa autoscaling para ele, deixa de criar o PodDisruptionBudget dele e, com components.orbit-api.persistence.enabled, monta um claim com rollout Recreate. O values-prod.yaml e o values-eks.yaml ligam a persistência.
  • O ORBIT_TRUSTED_PROXIES não nomeia mais o web: o web ganha confiança pelo bearer dele e repassa o endereço do cliente apenas do jeito que o ingress o escreveu (WEB_TRUST_PROXY). Volte-o para vazio; um CIDR de pods ali pularia o endereço do próprio ingress.
  • O PromQL ad hoc, e portanto todo painel de dashboard, roda no engine também com dados de demonstração, quando ORBIT_STACK_URL está definida.
  • Os segmentos de trace estão na versão 2 do formato. Um engine recusa pelo nome, na inicialização, um segmento da versão 1, gravado pela primeira release de traces, pula esse segmento e o deixa no disco; o write-ahead log é reprocessado de qualquer jeito. Um trace tem o teto de ORBIT_STACK_TRACE_MAX_BYTES (5MiB), e os spans do service graph à espera de par, o de ORBIT_STACK_TRACE_GRAPH_PENDING (100000); o mapa de serviços responde partial e unpairedSpans quando spans ficaram sem par.
  • As primeiras comparações de traces com o Grafana Tempo foram retiradas e substituídas pela rodada 2, do jeito que um crítico independente a executou de novo; o benchmark.md traz os números com a tabela de derrotas.

Migrando uma instalação existente: dê um volume ao orbit-api (components.orbit-api.persistence), decida como o primeiro administrador é criado (um par de chaves no Secret ou o código de configuração), volte ORBIT_TRUSTED_PROXIES para vazio e troque toda chamada ao orbit-api feita só com o bearer por uma chamada com sessão.

Adendo v0.2 (não lançado, em andamento)

Entregue desde que o adendo foi escrito

  • O head, o WAL e os blocos do engine foram refeitos (2026-09-23, ainda sem medição em um relatório de bench/runs/): o WAL grava os labels de cada série uma vez por arquivo, registra as amostras como colunas de deltas e XORs sob zstd e tira do page cache o que já sincronizou; os chunks fechados do head são empacotados em segmentos de spill compartilhados, com um pread por chunk; os blocos são compactados em segundo plano em níveis no estilo do Prometheus; um bloco que falha na verificação ao abrir é contornado com warnings, um /readyz degradado e orbit_stack_skipped_blocks; um selamento registra os seus logs no meta.json, então um crash não sela mais uma janela duas vezes; os matchers de regex são ancorados como ^(?s:re)$. O PromQL é o do Prometheus 3 para amostras float, e a API ganhou metadata, rules, query_exemplars, format_query, status/buildinfo e um limitador de leituras por IP (ORBIT_STACK_QUERY_RPM, ORBIT_STACK_QUERY_BURST). Veja docs/orbit-stack.md.

  • Os números de consulta com 20 mil séries foram corrigidos (2026-09-23): as medições do loop 1 misturavam recusas 429 com as respostas; medidos só sobre as respostas, p50 / p90 é 24 / 33 ms, 4,0x / 3,3x mais rápido que o Prometheus e 1,5x / 1,7x mais lento que o VictoriaMetrics.

  • O Orbit Stack existe (Adendo v0.3): services/orbit-stack, um binário estático que recebe remote-write do Prometheus, sela blocos colunares comprimidos com zstd e responde a um subconjunto de PromQL. Quarto contêiner no compose, no Helm e nos manifestos puros.

  • O benchmark foi executado, contra o Prometheus 3.1.0 e o VictoriaMetrics v1.152.0, e os números do site passaram a ser os medidos: 2,9x menos disco por amostra em blocos selados que o Prometheus (1,2x menos que o VictoriaMetrics), RSS 2,4x e 2,5x menor com 20 mil séries, ingest 1,19x o do Prometheus e paridade com o VictoriaMetrics, consulta 4,1x mais rápida que a do Prometheus e 1,5x mais lenta que a do VictoriaMetrics com 20 mil; com 200 mil séries toda linha vence o Prometheus e o RSS fica 64% acima do VictoriaMetrics. "10x", "6,8x de RAM com 10 M de séries" e "40 M de séries ativas por node" foram aposentados. docs/benchmark.md agora é uma página de resultados.

  • O selamento não materializa mais o bloco em RAM: as colunas passam pelo zstd série por série e o processo devolve o pico do selamento ao sistema operacional. Uma execução com 200 mil séries mostrou o selamento antigo dobrando o RSS; o docs/orbit-stack.md agora documenta o GOMEMLIMIT para contêineres.

  • ORBIT_DEMO_DATA=false inicia: internal/source/live lê um cluster Kubernetes (kubeconfig ou de dentro do cluster, com o ClusterRole somente-leitura do chart), deriva alertas e uma estimativa de FinOps por preço de tabela, e responde query_range a partir do engine. A fonte de demonstração serve o parque do CLAIMS.md com os formatos do frontend.

  • O Deck vai ao ar com NEXT_PUBLIC_DEMO_MODE=false, que o make k3d-up constrói: o console mostra o cluster k3d, alimentado por um Prometheus agent para dentro do engine.

  • PromQL ad hoc no Deck: a página de Observabilidade recebe uma expressão, roda-a através do query_range e a salva como painel no navegador.

  • A porta de entrada do web existe: apps/web/src/app/api/[...path]/route.ts encaminha /api/* para ORBIT_API_URL com o ORBIT_AUTH_TOKEN anexado no servidor, descarta qualquer Authorization vindo do cliente, transmite SSE sem buffer e cancela o upstream quando o navegador sai. O pnpm check:proxy a protege.

  • A página do Nocturne AI no Deck transmite do serviço por essa porta, frame a frame, e o painel de roteamento dela lê GET /api/v1/nocturne/models, que o orbit-api agora repassa junto com chat e analyze.

  • POST /api/v1/contact aceita os campos do próprio formulário do site (clusters, series, locale, source); a mensagem é opcional. O formulário faz POST para a própria origem.

  • ORBIT_TRUSTED_PROXIES / NOCTURNE_TRUSTED_PROXIES: o limitador por IP usa como chave o cliente encaminhado apenas atrás de um peer que o operador nomeou. Sem isso, todo visitante atrás do web compartilhava um único bucket.

  • CI (.github/workflows/ci.yml): o gate completo, build e scan de imagem sem supressão, e um digests.yaml gerado contra o qual o values-prod.yaml é renderizado e que acompanha a release.

  • Um rollout não corta mais uma resposta repassada do Nocturne AI sem um frame terminal: o orbit-api drena por 180s (antes 60s; terminationGracePeriodSeconds 200 em todo lugar), e qualquer stream repassado ainda aberto 5s antes do fim do orçamento é fechado com event: done + finishReason: "shutdown". O Deck imprime isso como "Cortada por um rollout do serviço. Pergunte de novo."

  • O make test não faz mais discovery contra um contexto kubectl não local. A validação de manifestos contra um cluster só roda em k3d-*, kind-*, minikube, docker-desktop ou rancher-desktop (ou com ORBIT_ALLOW_REMOTE=1).

A rodada 1 entregou os dois serviços Go sem autenticação de nenhum tipo: um chamador não autenticado podia ler o parque inteiro e escolher qual tier de modelo faturar. Este adendo fecha isso e mais duas lacunas relacionadas. Ele é obrigatório: um build que suba sem ele é um defeito.

Adicionado

  • Middleware de autenticação obrigatório à frente do router tanto no orbit-api quanto no nocturne: bearer static (comparação em tempo constante, recusa iniciar abaixo de 32 bytes), oidc (JWT verificado contra o JWKS do emissor) ou disabled (apenas demonstração local, recusado sempre que ORBIT_DEMO_DATA=false). Veja security.md.
  • O web agora faz proxy de /api/* para o orbit-api a partir do servidor Next.js, anexando ele mesmo o ORBIT_AUTH_TOKEN; o navegador nunca o tem.
  • /metrics saiu do listener da API para um endereço próprio (ORBIT_METRICS_ADDR / NOCTURNE_METRICS_ADDR, default :9090) nos dois serviços Go. Nenhum ingress o roteia, e a lista de isenções de autenticação nunca o cobre, porque ele não está no listener ao qual essa lista se aplica.
  • Novos formatos de métrica obrigatórios: counter *_provider_requests_total{tier,outcome}, histogram *_stream_duration_seconds (buckets até 300s) e um gauge de requisições em andamento. Essas métricas agora contam como falha um event: error dentro de uma resposta SSE 200.
  • O nocturne agora carrega o mesmo limitador por IP que o orbit-api já tinha, em todas as rotas, não apenas no contact.
  • O /readyz dos dois serviços agora precisa conseguir devolver 503: o orbit-api checa sua fonte e o nocturne; o nocturne checa a alcançabilidade do provedor (em cache).
  • Exigências explícitas de graça no desligamento: os dois serviços recebem <PREFIX>_SHUTDOWN_GRACE, com default acima do timeout de requisição (60s para o orbit-api, 180s para o nocturne, que transmite). Um drain que estoura registra shutdown incomplete e sai com código 0; isso nunca é reportado como falha de inicialização.

Alterado

  • O nocturne agora é alcançado exclusivamente pelo reverse proxy interno do orbit-api (POST /api/v1/nocturne/chat e /analyze no orbit-api); ele não tem regra de ingress nem superfície de CORS própria.

Removido / quebras de compatibilidade

  • NEXT_PUBLIC_API_URL acabou. Ela era embutida no bundle do navegador em tempo de build e apontava o navegador para um serviço que ele não pode mais alcançar diretamente. Se você a definia, pare: o web agora lê ORBIT_API_URL (apenas no servidor, em runtime). Veja configuration.md.
  • tier não é mais um campo do corpo da requisição de chat ou analyze. Um cliente não autenticado ou descuidado escolhendo o próprio tier de modelo é a lacuna de controle de faturamento que este adendo fecha. O tier.Select agora classifica toda requisição no servidor; o tier que rodou continua sendo reportado de volta no frame SSE done e em um cabeçalho de resposta, mas não pode mais ser solicitado. Veja api.md.

Migrando uma instalação existente: gere ORBIT_AUTH_TOKEN e NOCTURNE_AUTH_TOKEN (configuration.md → "Gerando um token estático") antes de atualizar. Um serviço em modo static sem token se recusa a iniciar; esse é o modo de falha correto para uma instalação que ninguém terminou de configurar, então não o contorne. Se você chamava o orbit-api ou o nocturne diretamente de um navegador contra as origens deles, pare; chame o caminho /api/* do web.

0.1.0: contrato inicial

O primeiro contrato acordado: três componentes (web, orbit-api, nocturne), a superfície compartilhada /healthz / /readyz / /metrics / /api/v1/version nos dois serviços Go, a superfície REST do orbit-api (clusters, nodes, workloads, events, alerts, FinOps, recommendations, query_range, contact), a superfície chat/analyze/models do nocturne com roteamento de modelo em dois tiers, as regras de hardening de contêiner e de Kubernetes (distroless, não-root, capabilities removidas, sistema de arquivos raiz somente-leitura, requests e limits, liveness/readiness nos caminhos do próprio contrato, PDBs e topology spread) e os limites de requisição/corpo/taxa enumerados em api.md. Entregue sem autenticação; o Adendo v0.2 acima explica por que isso não é mais verdade.

Para onde ir em seguida

  • O que está implementado em disco agora, componente por componente, em oposição ao que o contrato especifica: status.md.
  • A superfície completa e atual de variáveis de ambiente, adendo incluído: configuration.md.