PathruleSaiba o que aconteceu.
Verifique o que foi corrigido.
O Pathrule Signals conecta o que seu app faz em runtime aos agentes que o alteram. Erros e eventos são agrupados pelo caminho de código de onde vieram, seu agente de programação pode lê-los, e uma correção só conta como verificada quando a próxima release a comprova.
- TypeError em submitOrderrelease 2.4.0, 37 ocorrências, a linha de base
- Correção registrada pelo seu agenteuma afirmação, não uma prova
- Release 2.4.1 em observação60 min, 3 envelopes, 3 checkouts bem-sucedidos
- Verificadonenhuma recorrência na release mais nova
Qualquer ocorrência na 2.4.1 ou posterior faz o grupo voltar ao estado recurred.
Três formas de rodar.
- SDK de código abertoStandaloneO SDK Apache-2.0 envia para um coletor HTTP que você opera. Sem conta do Pathrule e sem Cloud.
- sem contaPathrule LocalOs eventos vão para o host do Pathrule na sua máquina, que os armazena, agrupa e verifica e deixa seu agente lê-los. Rode
pathrule init --localuma vez. - gerenciadoPathrule CloudIngestão gerenciada com chaves de projeto somente de escrita e retenção, lida pelos agentes com a sua sessão. Parte do Pro, do Team e do Enterprise.
Standalone e Local não exigem conta nem plano pago. O Cloud Signals faz parte do Pro, do Team e do Enterprise.
Instrumente uma vez.
import { pathrule, httpCollector } from "@pathrule/signals"; pathrule.init({ destination: httpCollector({ url: "https://collector.example.com/signals" }), environment: "production", release: { version: "2.4.0", commit: process.env.GIT_SHA },}); pathrule.error(error, { node: "/apps/web/checkout", flow: "checkout" });pathrule.event("order placed", { node: "/apps/web/checkout", flow: "checkout", meta: { outcome: "success" },});
Todo erro e todo evento informam seu caminho de código e seu fluxo. A identidade da release é o que torna a verificação possível, e um sucesso no mesmo fluxo é o que comprova uma correção.
Verificado é quando o runtime confirma.
- grouped
- Um grupo por ambiente, tipo e fingerprint, montado a partir do rótulo, do fluxo e do caminho de código. Um envelope reenviado é armazenado uma única vez.
- observing
- Uma release mais nova inicia a observação. A release de base, os eventos sem release e qualquer coisa anterior à correção nunca contam.
- verified
- Pelo menos 60 minutos, 3 envelopes da release mais nova e 3 sucessos do próprio fluxo do grupo.
- quiet
- 24 horas e 3 envelopes sem recorrência, para um grupo que não tem fluxo a comprovar.
- recurred
- Qualquer ocorrência em uma release mais nova, mesmo depois de verificado. O grupo volta a ficar ativo.
Registrar uma correção é uma afirmação, não uma prova. Só evidências de runtime de uma release mais nova podem resolver um grupo; ninguém resolve um grupo manualmente.
Seu agente lê isso.
Runtime: 2 active issues under apps/web/checkout (1 came back after a fix).Inspect with pathrule_runtime_events.
- pathrule_runtime_events
- Lê os grupos com o estado de verificação, as correções registradas e a cobertura, filtrados por caminho, tipo, ambiente ou estado.
- pathrule_runtime_events_resolve
- Registra uma correção na revisão de um grupo. É uma afirmação; o runtime decide se ela se sustenta.
- pathrule instrument events
- Os mesmos grupos em um terminal, por exemplo com --verification recurred.
A linha de runtime traz apenas contagens, nunca o conteúdo relatado, e tudo o que um agente lê do Signals é marcado como observação não confiável.
Perguntas frequentes.
Preciso de uma conta do Pathrule?
Não. No modo Standalone, o SDK envia para um coletor que você opera, e no Pathrule Local o host na sua máquina armazena e verifica os eventos. Uma conta só é necessária para o Pathrule Cloud.
O Signals é uma ferramenta de analytics?
Não. Ele não tem usuários, sessões nem funis. Ele registra erros e os eventos que mostram um fluxo funcionando, agrupados por caminho de código, e um hook de sanitização na configuração do SDK pode remover qualquer dado sensível antes do envio.
O que torna uma correção verificada?
Evidências de uma release mais nova: pelo menos 60 minutos de observação, 3 envelopes dessa release e 3 sucessos do próprio fluxo do grupo. Uma correção registrada é uma afirmação, e qualquer ocorrência posterior faz o grupo voltar ao estado recurred.
O que o Pathrule Cloud acrescenta?
Ingestão gerenciada com chaves de projeto somente de escrita, retenção, registro e verificação de correções no Cloud e acesso dos agentes com a sua própria sessão, no Pro, no Team e no Enterprise. Uma organização Team compartilha uma única franquia do Cloud Signals entre seus membros.