PathruleVisão geral do Signals
O Pathrule Signals registra erros e eventos de runtime, agrupa-os pelo caminho de código de onde vieram, permite que seu agente de programação os leia e verifica uma correção com evidências de uma release mais nova.
O Pathrule Signals conecta o que seu app faz em runtime aos desenvolvedores e agentes de programação que o modificam. Você instrumenta seu código uma única vez com o SDK de código aberto. Ele reporta erros e os eventos que mostram um fluxo funcionando, junto com o caminho de código e o fluxo a que pertencem e a release que os gerou. O Signals agrupa o que recebe, guarda esses dados, deixa tudo legível para o seu agente de programação e decide, com base em evidências de runtime, se uma correção realmente se sustenta.
O que ele faz
- Instrumenta seu código.
pathrule.error()epathrule.event()reportam o que aconteceu, cada um vinculado a um caminho de código (node) e a um fluxo. Veja o guia rápido. - Coleta eventos. O SDK os agrupa em lotes dentro de envelopes do protocolo Signals e tenta de novo em caso de falha, sem nunca rejeitar.
- Agrupa os eventos. Um grupo por ambiente, tipo e fingerprint, de modo que trinta e sete ocorrências do mesmo erro viram uma única coisa para analisar.
- Verifica correções. Um grupo só é verificado depois que uma release mais nova foi observada por tempo suficiente e o próprio fluxo dele teve sucesso. Veja verificação e ciclo de vida.
- Observa ao longo das releases. Uma release mais nova reinicia a observação, e uma ocorrência em qualquer release posterior reabre o grupo como recurred.
- Chega ao seu agente. A integração com agentes dá aos agentes de programação uma linha de runtime no contexto e uma ferramenta para ler os grupos sob o caminho em que estão trabalhando.
Três modos de operação
| Modo | Conta | Para onde vão os eventos | O que você recebe |
|---|---|---|---|
| Standalone | Nenhuma | Um coletor HTTP que você opera, via httpCollector() | O SDK e o protocolo. Você mesmo armazena e processa os eventos. |
| Pathrule Local | Nenhuma | O host Pathrule na sua máquina, via pathruleLocal() | Armazenamento, agrupamento, verificação, acesso para agentes e o CLI, tudo local. |
| Pathrule Cloud | Conta Pathrule | Ingestão gerenciada, via pathruleCloud({ key }) | Retenção e acesso para agentes com a sua própria sessão, nos planos Pro, Team e Enterprise. |
Standalone e Local estão disponíveis em todos os planos, não são medidos e não exigem plano pago. O Cloud Signals faz parte dos planos Pro, Team e Enterprise; veja Cloud Signals e preços.
O que o Signals não é
- Não é analytics. Não há usuários, sessões nem funis. O Signals registra erros e resultados de fluxos, agrupados por caminho de código.
- Não é um corretor automático. O Signals informa a você e ao seu agente o que aconteceu e se uma correção se sustentou. Alterar o código continua sendo tarefa sua e do seu agente.
- Não é um botão de resolver manual. Registrar uma correção é uma alegação. Só evidência de runtime resolve um grupo.
O que está disponível
- O SDK (
@pathrule/signals0.2.0, Apache-2.0) com o coletor HTTP, os destinos Local e Cloud e a versão 1 do protocolo. - Pathrule Local: armazenamento, agrupamento e verificação na sua máquina, as ferramentas para agentes e o comando
pathrule instrument events. - Pathrule Cloud: o pipeline de ingestão gerenciado, o registro de correções e a verificação delas com a mesma política do Local, deduplicação de envelopes e retenção automática.