PathruleScopri cosa è successo.
Verifica cosa è stato corretto.
Pathrule Signals collega ciò che la tua app fa a runtime con gli agenti che la modificano. Errori ed eventi vengono raggruppati per il percorso del codice da cui provengono, il tuo agente di programmazione può leggerli e una correzione conta come verificata solo quando la release successiva lo dimostra.
- TypeError in submitOrderrelease 2.4.0, 37 occorrenze, la baseline
- Correzione registrata dal tuo agenteun'affermazione, non una prova
- Release 2.4.1 in osservazione60 min, 3 envelope, 3 checkout riusciti
- Verificatonessuna ricorrenza nella release più recente
Qualsiasi occorrenza nella 2.4.1 o successive riporta il gruppo allo stato recurred.
Tre modi per usarlo.
- SDK open sourceStandaloneL'SDK Apache-2.0 invia i dati a un collector HTTP gestito da te. Nessun account Pathrule e nessun Cloud.
- senza accountPathrule LocalGli eventi vanno all'host Pathrule sulla tua macchina, che li conserva, li raggruppa, li verifica e li rende leggibili al tuo agente. Basta eseguire
pathrule init --localuna volta. - gestitoPathrule CloudAcquisizione gestita con chiavi di progetto in sola scrittura e conservazione dei dati, letta dagli agenti con la tua sessione. Parte di Pro, Team ed Enterprise.
Standalone e Local non richiedono account né piani a pagamento. Cloud Signals fa parte di Pro, Team ed Enterprise.
Instrumenta una volta sola.
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" },});
Ogni errore ed evento indica il proprio percorso del codice e il proprio flusso. È l'identità della release a rendere possibile la verifica, ed è un successo sullo stesso flusso a dimostrare una correzione.
Verificato significa che lo dice il runtime.
- grouped
- Un gruppo per ambiente, tipo e fingerprint, costruito da etichetta, flusso e percorso del codice. Un envelope ritrasmesso viene salvato una sola volta.
- observing
- Una release più recente avvia l'osservazione. La release di baseline, gli eventi senza release e tutto ciò che precede la correzione non contano mai.
- verified
- Almeno 60 minuti, 3 envelope dalla release più recente e 3 successi del flusso proprio del gruppo.
- quiet
- 24 ore e 3 envelope senza ricorrenze, per un gruppo che non ha un flusso da dimostrare.
- recurred
- Qualsiasi occorrenza in una release più recente, anche dopo verified. Il gruppo torna attivo.
Registrare una correzione è un'affermazione, non una prova. Solo le evidenze di runtime di una release più recente possono risolvere un gruppo; nessuno lo risolve a mano.
Il tuo agente lo legge.
Runtime: 2 active issues under apps/web/checkout (1 came back after a fix).Inspect with pathrule_runtime_events.
- pathrule_runtime_events
- Legge i gruppi con il loro stato di verifica, le correzioni registrate e la copertura, filtrati per percorso, tipo, ambiente o stato.
- pathrule_runtime_events_resolve
- Registra una correzione rispetto alla revisione di un gruppo. È un'affermazione; è il runtime a decidere se regge.
- pathrule instrument events
- Gli stessi gruppi in un terminale, ad esempio con --verification recurred.
La riga di runtime riporta solo conteggi, mai il contenuto segnalato, e tutto ciò che un agente legge da Signals è contrassegnato come osservazione non attendibile.
Domande frequenti.
Mi serve un account Pathrule?
No. In modalità Standalone l'SDK invia i dati a un collector gestito da te, e in Pathrule Local l'host sulla tua macchina conserva e verifica gli eventi. Un account serve solo per Pathrule Cloud.
Signals è uno strumento di analytics?
No. Non ha utenti, sessioni o funnel. Registra gli errori e gli eventi che mostrano un flusso funzionante, raggruppati per percorso del codice, e un hook di pulizia nella configurazione dell'SDK può rimuovere qualsiasi dato sensibile prima dell'invio.
Quando una correzione è verificata?
Quando lo dimostrano le evidenze di una release più recente: almeno 60 minuti di osservazione, 3 envelope da quella release e 3 successi del flusso proprio del gruppo. Una correzione registrata è un'affermazione, e qualsiasi occorrenza successiva riporta il gruppo allo stato recurred.
Cosa aggiunge Pathrule Cloud?
Acquisizione gestita con chiavi di progetto in sola scrittura, conservazione dei dati, registrazione e verifica delle correzioni nel Cloud e accesso degli agenti con la tua sessione, nei piani Pro, Team ed Enterprise. Un'organizzazione Team condivide una sola quota di Cloud Signals tra i suoi membri.