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.
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()ypathrule.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
| Modo | Cuenta | Adónde van los eventos | Qué obtienes |
|---|---|---|---|
| Standalone | Ninguna | Un colector HTTP que tú ejecutas, mediante httpCollector() | El SDK y el protocolo. Tú almacenas y procesas los eventos. |
| Pathrule Local | Ninguna | El host de Pathrule en tu máquina, mediante pathruleLocal() | Almacenamiento, agrupación, verificación, acceso de agentes y la CLI, todo en local. |
| Pathrule Cloud | Cuenta de Pathrule | Ingesta 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/signals0.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.