Guias
Envie a condução como logs OpenTelemetry
Ligue a telemetria privada, aponte para um Collector e leia os indicadores de SDLC Analytics por maestro e por time.
Ligue e confira
A telemetria envia os eventos que o Orkastery já grava no ledger como logs OpenTelemetry, por OTLP/HTTP JSON. A adesão é privada da pessoa ou da máquina, fica desligada por padrão e não muda o orkastery.yaml.
ork telemetria ligar cria o arquivo privado ork.telemetria-config/v1, fora do repositório, com permissão 0600. Ele guarda só a opção e um pseudônimo aleatório estável; endpoint e cabeçalhos ficam no ambiente do processo.
Variáveis OTEL sozinhas não ligam o recurso. Desligada, ork telemetria status e ork telemetria enviar retornam antes de enumerar threads, abrir ledgers ou ler endpoint e cabeçalhos.
ork telemetria ligar
ork telemetria status
ork telemetria desligarAponte para um Collector
Defina OTEL_EXPORTER_OTLP_ENDPOINT, ao qual o Orkastery acrescenta v1/logs, ou OTEL_EXPORTER_OTLP_LOGS_ENDPOINT, usado exatamente como informado; o de logs vence. A mesma precedência vale para os cabeçalhos, em pares chave=valor. Valor inválido é recusado sem eco.
O envio é manual, por ork telemetria enviar. O cursor é incremental por ledger e só avança depois da confirmação remota: a entrega é ao menos uma vez, e o consumidor deduplica por log.record.uid.
Os modelos de referência ficam em templates/telemetria: collector-otlp.yaml para um destino OTLP/HTTP genérico, collector-loki.yaml para a base OTLP do Loki e os painéis do Grafana de condução, prompts e saúde do Collector. Os painéis não fixam URL nem datasource.
O receiver público não traz TLS nem autenticação. Use rede confiável e aplique um overlay privado com TLS e autenticação antes de expô-lo.
export OTEL_EXPORTER_OTLP_ENDPOINT=http://collector.example:4318
ork telemetria enviar --dry-run
ork telemetria enviarConfira antes de enviar
ork telemetria status --json mostra a origem da ativação, o destino sem credencial, os bytes pendentes por thread, o último UID confirmado e a rejeição terminal.
ork telemetria enviar --dry-run ignora o cursor gravado e mostra o pedido já redigido, desde o início ou desde o byte de --offset. Ele não resolve cabeçalhos, não usa rede e não grava cursor.
ork telemetria status --json
ork telemetria enviar --dry-run --json
ork telemetria enviar --dry-run --offset <byte> --jsonAtributos e correlação com os runtimes
Cada LogRecord usa atributos de uma lista fechada: service, vcs, cicd e gen_ai das convenções do OpenTelemetry, user.hash com o pseudônimo e os atributos orkastery.* de thread, fase, despacho, modo, decisão, claim, recibo e runtime. Heartbeat e campos fora da lista não viram atributo.
Cada despacho bem-sucedido gera orkastery.ledger.phase_dispatch, com session.id no Claude Code ou conversation.id no Codex. O Orkastery não reemite eventos nem corpo nativos.
A sessão despachada recebe uma configuração efêmera que desliga prompt, resposta e detalhe de ferramenta nos logs nativos do runtime. Endpoint e cabeçalhos nunca entram no argv nem no ledger.
Conteúdo de prompts
Com a adesão ligada, o texto vem só do arquivo carimbado por phase_prompt_recorded, conferido pelo SHA-256 registrado. Antes do LogRecord, o núcleo remove segredos (literais, separados, em Base64 e em JSON aninhado), aplica dado_privado e confere de novo.
O texto restante sai em gen_ai.input.messages, com a política ork.telemetria-redacao/v1. Arquivo ausente, caminho inseguro, tamanho acima do limite ou hash divergente viram lacuna tipada, sem prompt, caminho ou hash; erro transitório ou falha da remoção param antes do evento, e o cursor não avança.
As convenções GenAI 1.37.0 usadas estão em estado Development. O conteúdo pode ser sensível, e a empresa que recebe os logs vê o texto restante depois da remoção; por isso a adesão é opt-in e privada.
Indicadores por maestro e por time
ork telemetria maturidade calcula seis indicadores agênticos sobre os ledgers da máquina, na janela entre --desde e --ate, sem rede nem opt-in: cobertura de recibo nos merges, primeira verdade sustentada, retrabalho do CHECK, decisões, perguntas e reversões, exceções de política e uso de modos.
Só os dois primeiros são taxas; os outros são contagens ou distribuições, cada um com cobertura e lacunas. Nenhum indicador vira nota composta, peso, ranking ou meta, e evento histórico incompleto não vira negativo.
A projeção emite o evento ratificado orkastery.sdlc.analytics.result.v1, com numerador, denominador, cobertura e lacunas. O painel soma esses campos por user.hash e por service.namespace, o time atribuído pela política, sem refazer as fórmulas; sem time, a política marca team_source_missing.
As medidas DORA ficam separadas, com pipeline própria e schema fechado, e saem como não confirmadas sem deployment e incidente externos vinculados ao merge provado. A equivalência das consultas em Loki segue não confirmada.
ork telemetria maturidade --desde <ISO> --ate <ISO> --json