Saltar al contenido
Pathrule

documentación

Descripción general de Signals

Pathrule Signals registra errores y eventos en tiempo de ejecución, los agrupa según la ruta de código de la que provienen, permite que tu agente de programación los lea y verifica una corrección con evidencia de una versión más reciente.

En esta página

Pathrule Signals conecta lo que hace tu aplicación en tiempo de ejecución con los desarrolladores y agentes de programación que la modifican. Instrumentas tu código una sola vez con el SDK de código abierto. Este reporta los errores, y también los eventos que muestran que un flujo funciona, junto con la ruta de código y el flujo al que pertenecen y la versión que los generó. Signals agrupa lo que recibe, lo conserva, lo pone a disposición de tu agente de programación y decide, con base en evidencia en tiempo de ejecución, si una corrección realmente se sostiene.

Qué hace

  • Instrumenta tu código. pathrule.error() y pathrule.event() reportan lo que ocurrió, cada uno vinculado a una ruta de código (node) y a un flujo. Consulta el inicio rápido.
  • Recopila eventos. El SDK los agrupa en lotes dentro de sobres del protocolo de Signals y reintenta cuando hay fallos, sin rechazar nunca.
  • Los agrupa. Hay un grupo por entorno, tipo y huella, así que treinta y siete ocurrencias del mismo error son una sola cosa que revisar.
  • Verifica correcciones. Un grupo solo queda verificado después de que se ha observado una versión más reciente durante el tiempo suficiente y su propio flujo se ha completado con éxito. Consulta verificación y ciclo de vida.
  • Observa entre versiones. Una versión más reciente reinicia la observación, y una ocurrencia en cualquier versión posterior reabre el grupo como recurred.
  • Llega a tu agente. La integración con agentes les da a los agentes de programación una línea de tiempo de ejecución en su contexto y una herramienta para leer los grupos bajo la ruta en la que están trabajando.

Tres modos de funcionamiento

ModoCuentaAdónde van los eventosQué obtienes
StandaloneNingunaUn colector HTTP que tú ejecutas, mediante httpCollector()El SDK y el protocolo. Tú almacenas y procesas los eventos.
Pathrule LocalNingunaEl host de Pathrule en tu máquina, mediante pathruleLocal()Almacenamiento, agrupación, verificación, acceso de agentes y la CLI, todo en local.
Pathrule CloudCuenta de PathruleIngesta gestionada, mediante pathruleCloud({ key })Retención y acceso de agentes con tu propia sesión, en Pro, Team y Enterprise.

Standalone y Local están disponibles en todos los planes, no se miden y no requieren un plan de pago. Cloud Signals forma parte de Pro, Team y Enterprise; consulta Cloud Signals y los precios.

Qué no es Signals

  • No es analítica. No hay usuarios, sesiones ni embudos. Signals registra errores y resultados de flujos, agrupados por ruta de código.
  • No corrige automáticamente. Signals les dice a ti y a tu agente qué ocurrió y si una corrección se sostuvo. Cambiar el código sigue siendo tarea tuya y de tu agente.
  • No es un botón para resolver manualmente. Registrar una corrección es una afirmación. Solo la evidencia en tiempo de ejecución resuelve un grupo.

Qué se incluye

  • El SDK (@pathrule/signals 0.2.0, Apache-2.0) con el colector HTTP, los destinos Local y Cloud, y la versión 1 del protocolo.
  • Pathrule Local: almacenamiento, agrupación y verificación en tu máquina, las herramientas para agentes y el comando pathrule instrument events.
  • Pathrule Cloud: el pipeline de ingesta gestionada, el registro de correcciones y su verificación con la misma política que Local, la deduplicación de sobres y la retención automática.