PathruleSabe qué pasó.
Verifica lo que se corrigió.
Pathrule Signals conecta lo que hace tu aplicación en tiempo de ejecución con los agentes que la modifican. Los errores y eventos se agrupan por la ruta de código de la que proceden, tu agente de programación puede leerlos y una corrección solo cuenta como verificada cuando la siguiente versión lo demuestra.
- TypeError en submitOrderversión 2.4.0, 37 apariciones, la referencia
- Corrección registrada por tu agenteuna afirmación, no una prueba
- Versión 2.4.1 en observación60 min, 3 envíos, 3 checkouts correctos
- Verificadosin repeticiones en la versión más reciente
Cualquier aparición en la 2.4.1 o posterior devuelve el grupo al estado recurred.
Tres formas de usarlo.
- SDK de código abiertoStandaloneEl SDK Apache-2.0 envía los datos a un recopilador HTTP que gestionas tú. Sin cuenta de Pathrule y sin Cloud.
- sin cuentaPathrule LocalLos eventos van al host de Pathrule en tu máquina, que los almacena, agrupa y verifica, y permite que tu agente los lea. Ejecuta
pathrule init --localuna vez. - gestionadoPathrule CloudIngesta gestionada con claves de proyecto de solo escritura y retención, y lectura por parte de los agentes con tu sesión. Forma parte de Pro, Team y Enterprise.
Standalone y Local no necesitan cuenta ni plan de pago. Cloud Signals forma parte de Pro, Team y Enterprise.
Instrumenta una 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" },});
Cada error y cada evento indican su ruta de código y su flujo. La identidad de la versión es lo que hace posible la verificación, y un éxito en el mismo flujo es lo que demuestra una corrección.
Verificado significa que lo confirma la ejecución.
- grouped
- Un grupo por entorno, tipo y huella, construido a partir de la etiqueta, el flujo y la ruta de código. Un envío reintentado se guarda una sola vez.
- observing
- Una versión más reciente inicia la observación. La versión de referencia, los eventos sin versión y todo lo anterior a la corrección nunca cuentan.
- verified
- Al menos 60 minutos, 3 envíos de la versión más reciente y 3 éxitos del propio flujo del grupo.
- quiet
- 24 horas y 3 envíos sin repeticiones, para un grupo que no tiene un flujo que demostrar.
- recurred
- Cualquier aparición en una versión más reciente, incluso después de verified. El grupo vuelve a estar activo.
Registrar una corrección es una afirmación, no una prueba. Solo la evidencia de ejecución de una versión más reciente puede resolver un grupo; nadie lo resuelve a mano.
Tu agente lo lee.
Runtime: 2 active issues under apps/web/checkout (1 came back after a fix).Inspect with pathrule_runtime_events.
- pathrule_runtime_events
- Lee los grupos con su estado de verificación, las correcciones registradas y la cobertura, filtrados por ruta, tipo, entorno o estado.
- pathrule_runtime_events_resolve
- Registra una corrección sobre la revisión de un grupo. Es una afirmación; la ejecución decide si se sostiene.
- pathrule instrument events
- Los mismos grupos en la terminal, por ejemplo con --verification recurred.
La línea de ejecución solo incluye recuentos, nunca el contenido notificado, y todo lo que un agente lee de Signals se marca como observación no fiable.
Preguntas frecuentes.
¿Necesito una cuenta de Pathrule?
No. En el modo Standalone, el SDK envía los datos a un recopilador que gestionas tú, y en Pathrule Local el host de tu máquina almacena y verifica los eventos. Solo necesitas una cuenta para Pathrule Cloud.
¿Signals es una herramienta de analítica?
No. No tiene usuarios, sesiones ni embudos. Registra errores y los eventos que demuestran que un flujo funciona, agrupados por ruta de código, y un hook de saneamiento en la configuración del SDK puede eliminar cualquier dato sensible antes de enviarlo.
¿Qué hace que una corrección quede verificada?
La evidencia de una versión más reciente: al menos 60 minutos de observación, 3 envíos de esa versión y 3 éxitos del propio flujo del grupo. Una corrección registrada es una afirmación, y cualquier aparición posterior devuelve el grupo al estado recurred.
¿Qué añade Pathrule Cloud?
Ingesta gestionada con claves de proyecto de solo escritura, retención, registro y verificación de correcciones en Cloud y acceso de los agentes con tu propia sesión, en Pro, Team y Enterprise. Una organización Team comparte una única asignación de Cloud Signals entre sus miembros.