Zum Inhalt springen
Pathrule

pathrule.iodocs

Pathrule

doku

DokuLoslegen

Signals im Überblick

Pathrule Signals erfasst Laufzeitfehler und Events, gruppiert sie nach dem Codepfad, aus dem sie stammen, macht sie für deinen Coding-Agent lesbar und bestätigt einen Fix anhand von Belegen aus einem neueren Release.

Auf dieser Seite

Pathrule Signals verbindet das, was deine App zur Laufzeit tut, mit den Entwicklern und Coding-Agents, die sie verändern. Du instrumentierst deinen Code einmalig mit dem Open-Source-SDK. Es meldet Fehler sowie die Events, die zeigen, dass ein Flow funktioniert, jeweils zusammen mit dem Codepfad und dem Flow, zu dem sie gehören, und dem Release, aus dem sie stammen. Signals gruppiert, was ankommt, bewahrt es auf, macht es für deinen Coding-Agent lesbar und entscheidet anhand von Laufzeitbelegen, ob ein Fix tatsächlich hält.

Was Signals leistet

  • Instrumentiert deinen Code. pathrule.error() und pathrule.event() melden, was passiert ist, jeweils verknüpft mit einem Codepfad (node) und einem Flow. Siehe den Schnellstart.
  • Sammelt Events. Das SDK bündelt sie in Envelopes nach dem Signals-Protokoll und wiederholt Übertragungen bei Fehlern, ohne jemals einen Fehler zu werfen.
  • Gruppiert sie. Pro Umgebung, Art und Fingerprint gibt es eine Gruppe, sodass siebenunddreißig Vorkommen desselben Fehlers eine einzige Sache sind, die du dir ansiehst.
  • Verifiziert Fixes. Eine Gruppe gilt erst als verifiziert, wenn ein neueres Release lange genug beobachtet wurde und ihr eigener Flow erfolgreich war. Siehe Verifizierung und Lebenszyklus.
  • Beobachtet über Releases hinweg. Ein neueres Release startet die Beobachtung neu, und ein Vorkommen in einem beliebigen späteren Release öffnet die Gruppe wieder als recurred.
  • Erreicht deinen Agent. Die Agent-Integration gibt Coding-Agents eine Laufzeitzeile in ihrem Kontext und ein Tool, mit dem sie die Gruppen unter dem Pfad lesen, an dem sie gerade arbeiten.

Drei Betriebsmodi

ModusKontoWohin Events gehenWas du bekommst
StandaloneKeinsEin HTTP-Collector, den du selbst betreibst, über httpCollector()Das SDK und das Protokoll. Speicherung und Verarbeitung der Events übernimmst du selbst.
Pathrule LocalKeinsDer Pathrule-Host auf deinem Rechner, über pathruleLocal()Speicherung, Gruppierung, Verifizierung, Agent-Zugriff und die CLI, alles lokal.
Pathrule CloudPathrule-KontoVerwaltete Ingestion, über pathruleCloud({ key })Aufbewahrung und Agent-Zugriff mit deiner eigenen Session, in Pro, Team und Enterprise.

Standalone und Local sind in jedem Plan enthalten, werden nicht abgerechnet und brauchen keinen kostenpflichtigen Plan. Cloud Signals ist Teil von Pro, Team und Enterprise; siehe Cloud Signals und Preise.

Was Signals nicht ist

  • Kein Analytics-Tool. Es gibt keine Nutzer, Sessions oder Funnels. Signals erfasst Fehler und Flow-Ergebnisse, gruppiert nach Codepfad.
  • Kein automatischer Fixer. Signals sagt dir und deinem Agent, was passiert ist und ob ein Fix gehalten hat. Den Code zu ändern bleibt deine Aufgabe und die deines Agents.
  • Kein manueller Resolve-Button. Einen Fix zu erfassen ist eine Behauptung. Nur Laufzeitbelege lösen eine Gruppe auf.

Was enthalten ist

  • Das SDK (@pathrule/signals 0.2.0, Apache-2.0) mit dem HTTP-Collector, den Zielen Local und Cloud sowie Protokollversion 1.
  • Pathrule Local: Speicherung, Gruppierung und Verifizierung auf deinem Rechner, die Agent-Tools und der Befehl pathrule instrument events.
  • Pathrule Cloud: die verwaltete Ingest-Pipeline, das Erfassen von Fixes und ihre Verifizierung nach derselben Richtlinie wie bei Local, Deduplizierung von Envelopes und automatische Aufbewahrung.