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. Vejalogs.md. @status:503encontra 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:okvolta a achar ostatusda 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. Vejalogs.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,valeservice: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 aceitakey:a,bpara qualquer um dos valores. Vejalogs.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 oUTC [pid] ERROR:do Postgres), ofail:do .NET e o] INFO [do Kafka. Uma linha recuada ou oSTATEMENT: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. Vejalogs.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. Vejalogs.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
managedFieldse sem a cópia do last-applied, com todo valor que seria de uma credencial mascarado como um diff o mascara. Ela exigeconfig.reade lêGET /api/v1/clusters/{id}/workloads/{ns}/{kind}/{name}/manifestsó quando a aba abre; cada leitura é auditada comoworkload.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-Protocom http, então owebdefinia os cookies semSecurenem__Host-e imprimiahttp://no snippet do MCP e nos redirect URIs de SSO. OpublicUrlagora chega aoweb, e um endereço https nele prevalece sobre o header. Vazio, nada muda. Vejaconfiguration.md.
Notas de upgrade
- Uma instalação com
publicUrlhttps cujo ingress diz http faz todo mundo entrar mais uma vez no upgrade, e de novo num rollback: owebnão lê uma sessão soborbit_sessionno https.
O que a página de um serviço conta (não lançado)
Corrigido
- Workers e crons que informam o
service.namede 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/servicemapadicionabackgroundRateà 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 emSIGNATUREou_SIG, chaves de assinatura e de criptografia,HMACKEY,MASTERKEY,PRIVKEY,KEY_PEMe parecidos,PASS_1,SSHPASS, o-storepassdo keytool, o--requirepassdo 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, oAccountKey=da Azure, a assinatura de uma URL assinada,dbPassword: x,--db-password=x, um*_KEY=xem maiúsculas num texto. - Um vetor de inicialização,
KEY_IDeSIGNATURE_VERSIONseguem em claro: nenhum é segredo.PUBLIC_KEYeTOKEN_TTLseguem 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
envremovida com o contêiner ou odatade um ConfigMap, ou alteraargsque levam--password x. Um host ou uma imagem com nome de credencial (auth-token:8080,registry.example/team/app-token:1.2.3) e omatchLabelKeysde 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>). Vejaapm.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 ostorage/logs/laravel.logdo Laravel e o diáriolaravel-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. Vejalogs.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.allowedHostsepublicUrlno 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 cadacloudwatch.interval(3m por padrão) com resolução de 1 minuto; só as séries ativas recentemente são pedidas. Veja emcloudwatch.mdo custo por intervalo.- A role somente leitura ganha
cloudwatch:GetMetricDataecloudwatch:ListMetrics, e odeploy/aws/setup-pod-identity.shtambém associa<release>-orbit-agenta 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.managee 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-stacke os enginesorbit-*, sobregcr.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 gitgo-oracle, só como oráculo diferencial. - Os engines padrão do chart passam a ser
orbit:telemetry.agent.engine,telemetry.nodeExporter.engine,telemetry.kubeStateMetrics.engineeapm.collector.engine. Um upgrade troca esses workloads num único rolling update; definaprometheus/upstreampara manter as imagens upstream. Com oorbit-agentnão há o jobkubelet; nada o consultava. - O
orbit-stacknão tem coletor de lixo:GOGC,GOMEMLIMITeORBIT_STACK_MEMORY_LIMITsão ignorados. Vejaorbit-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=goroda 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 cookieorbit_session(HttpOnly); três papéis embutidos e papéis personalizados sobre onze permissões, checadas em toda rota. O primeiro administrador vem deORBIT_ADMIN_USEReORBIT_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. Vejaidentity.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/audite emGET /api/v1/audit, exportável como CSV e retido pelo prazo deORBIT_AUDIT_RETENTION. Vejaaudit.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. Vejadashboards.md. - Traces e APM: o
orbit-stackrecebe OTLP/HTTP emPOST /v1/traces, guarda os spans pelo prazo deORBIT_STACK_TRACE_RETENTIONe 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 dedemo.shop.enabled. Vejaapm.md. - Reconhecimentos e silenciamentos de alertas, guardados pelo
orbit-api, liberados porworkloads.writee auditados; uma seção de runbook para cada regra derivada. Vejaalerts.md. - Leads de contato (Adendo v0.7): gravados antes de o formulário receber a resposta,
listados em
/deck/admin/leadse emGET /api/v1/leadse, opcionalmente, enviados por POST paraORBIT_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_BYTESe asORBIT_SHOP_*da loja. Vejaconfiguration.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 ocontact, exige uma sessão, além do bearer. Um script que chamavaGET /api/v1/versionouGET /api/v1/clusterssó com o bearer agora recebe401: faça login antes (identity.md→ "Entrar pelo shell"). OGET /api/v1/auth/stateresponde só com o bearer e é a nova forma de conferir isso. - O
orbit-apiroda uma única réplica em todos os caminhos de instalação, sobre um armazenamento de escritor único emORBIT_DATA_DIR. O chart forçareplicas: 1, recusa autoscaling para ele, deixa de criar o PodDisruptionBudget dele e, comcomponents.orbit-api.persistence.enabled, monta um claim com rolloutRecreate. Ovalues-prod.yamle ovalues-eks.yamlligam a persistência. - O
ORBIT_TRUSTED_PROXIESnão nomeia mais oweb: owebganha 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_URLestá 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 deORBIT_STACK_TRACE_GRAPH_PENDING(100000); o mapa de serviços respondepartialeunpairedSpansquando 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.mdtraz 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 umpreadpor 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 comwarnings, um/readyzdegradado eorbit_stack_skipped_blocks; um selamento registra os seus logs nometa.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 ganhoumetadata,rules,query_exemplars,format_query,status/buildinfoe um limitador de leituras por IP (ORBIT_STACK_QUERY_RPM,ORBIT_STACK_QUERY_BURST). Vejadocs/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
429com 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.mdagora é 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.mdagora documenta oGOMEMLIMITpara contêineres.ORBIT_DEMO_DATA=falseinicia:internal/source/livelê 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 respondequery_rangea 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 omake k3d-upconstró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_rangee a salva como painel no navegador.A porta de entrada do
webexiste:apps/web/src/app/api/[...path]/route.tsencaminha/api/*paraORBIT_API_URLcom oORBIT_AUTH_TOKENanexado no servidor, descarta qualquerAuthorizationvindo do cliente, transmite SSE sem buffer e cancela o upstream quando o navegador sai. Opnpm check:proxya 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 oorbit-apiagora repassa junto comchateanalyze.POST /api/v1/contactaceita 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 dowebcompartilhava um único bucket.CI (
.github/workflows/ci.yml): o gate completo, build e scan de imagem sem supressão, e umdigests.yamlgerado contra o qual ovalues-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-apidrena por 180s (antes 60s;terminationGracePeriodSeconds200 em todo lugar), e qualquer stream repassado ainda aberto 5s antes do fim do orçamento é fechado comevent: done+finishReason: "shutdown". O Deck imprime isso como "Cortada por um rollout do serviço. Pergunte de novo."O
make testnão faz mais discovery contra um contexto kubectl não local. A validação de manifestos contra um cluster só roda emk3d-*,kind-*,minikube,docker-desktopourancher-desktop(ou comORBIT_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-apiquanto nonocturne: bearerstatic(comparação em tempo constante, recusa iniciar abaixo de 32 bytes),oidc(JWT verificado contra o JWKS do emissor) oudisabled(apenas demonstração local, recusado sempre queORBIT_DEMO_DATA=false). Vejasecurity.md. - O
webagora faz proxy de/api/*para oorbit-apia partir do servidor Next.js, anexando ele mesmo oORBIT_AUTH_TOKEN; o navegador nunca o tem. /metricssaiu 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 umevent: errordentro de uma resposta SSE200. - O
nocturneagora carrega o mesmo limitador por IP que oorbit-apijá tinha, em todas as rotas, não apenas nocontact. - O
/readyzdos dois serviços agora precisa conseguir devolver503: oorbit-apicheca sua fonte e onocturne; onocturnecheca 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 (60spara oorbit-api,180spara onocturne, que transmite). Um drain que estoura registrashutdown incompletee sai com código0; isso nunca é reportado como falha de inicialização.
Alterado
- O
nocturneagora é alcançado exclusivamente pelo reverse proxy interno doorbit-api(POST /api/v1/nocturne/chate/analyzenoorbit-api); ele não tem regra de ingress nem superfície de CORS própria.
Removido / quebras de compatibilidade
NEXT_PUBLIC_API_URLacabou. 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: owebagora lêORBIT_API_URL(apenas no servidor, em runtime). Vejaconfiguration.md.tiernão é mais um campo do corpo da requisição dechatouanalyze. Um cliente não autenticado ou descuidado escolhendo o próprio tier de modelo é a lacuna de controle de faturamento que este adendo fecha. Otier.Selectagora classifica toda requisição no servidor; o tier que rodou continua sendo reportado de volta no frame SSEdonee em um cabeçalho de resposta, mas não pode mais ser solicitado. Vejaapi.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.