PathruleWissen, was passiert ist.
Prüfen, was behoben wurde.
Pathrule Signals verbindet, was deine App zur Laufzeit tut, mit den Agenten, die sie ändern. Fehler und Ereignisse werden nach dem Codepfad gruppiert, aus dem sie stammen, dein Coding-Agent kann sie lesen, und ein Fix gilt erst als verifiziert, wenn das nächste Release ihn belegt.
- TypeError in submitOrderRelease 2.4.0, 37 Vorkommen, die Baseline
- Fix von deinem Agenten erfassteine Behauptung, kein Beweis
- Release 2.4.1 unter Beobachtung60 Min., 3 Envelopes, 3 erfolgreiche Checkouts
- Verifiziertkein erneutes Auftreten im neueren Release
Jedes Vorkommen in 2.4.1 oder später setzt die Gruppe auf recurred zurück.
Drei Wege, es zu betreiben.
- Open-Source-SDKStandaloneDas SDK unter Apache-2.0 sendet an einen HTTP-Collector, den du betreibst. Kein Pathrule-Konto und keine Cloud.
- ohne KontoPathrule LocalEreignisse gehen an den Pathrule-Host auf deinem Rechner, der sie speichert, gruppiert und verifiziert und deinen Agenten sie lesen lässt. Führe einmal
pathrule init --localaus. - verwaltetPathrule CloudVerwaltete Erfassung mit Projektschlüsseln, die nur schreiben dürfen, und Aufbewahrung, von Agenten mit deiner Session gelesen. Teil von Pro, Team und Enterprise.
Standalone und Local brauchen weder ein Konto noch einen bezahlten Tarif. Cloud Signals ist Teil von Pro, Team und Enterprise.
Einmal instrumentieren.
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" },});
Jeder Fehler und jedes Ereignis nennt seinen Codepfad und Flow. Eine Release-Identität macht Verifizierung erst möglich, und ein Erfolg im selben Flow belegt einen Fix.
Verifiziert heißt: Die Runtime sagt es.
- grouped
- Eine Gruppe pro Umgebung, Art und Fingerprint, gebildet aus Label, Flow und Codepfad. Ein erneut gesendeter Envelope wird nur einmal gespeichert.
- observing
- Ein neueres Release startet die Beobachtung. Das Baseline-Release, Ereignisse ohne Release und alles vor dem Fix zählen nie.
- verified
- Mindestens 60 Minuten, 3 Envelopes aus dem neueren Release und 3 Erfolge im eigenen Flow der Gruppe.
- quiet
- 24 Stunden und 3 Envelopes ohne erneutes Auftreten, für eine Gruppe ohne Flow, der etwas belegen könnte.
- recurred
- Jedes Vorkommen in einem neueren Release, auch nach verified. Die Gruppe ist wieder aktiv.
Einen Fix zu erfassen ist eine Behauptung, kein Beweis. Nur Laufzeitnachweise aus einem neueren Release können eine Gruppe auflösen; niemand löst eine von Hand auf.
Dein Agent liest es.
Runtime: 2 active issues under apps/web/checkout (1 came back after a fix).Inspect with pathrule_runtime_events.
- pathrule_runtime_events
- Liest Gruppen mit ihrem Verifizierungsstatus, erfassten Korrekturen und ihrer Abdeckung, gefiltert nach Pfad, Art, Umgebung oder Status.
- pathrule_runtime_events_resolve
- Erfasst eine Korrektur zu einer Revision einer Gruppe. Das ist eine Behauptung; die Runtime entscheidet, ob sie hält.
- pathrule instrument events
- Dieselben Gruppen im Terminal, zum Beispiel mit --verification recurred.
Die Runtime-Zeile enthält nur Zähler, nie die gemeldeten Inhalte, und alles, was ein Agent aus Signals liest, ist als nicht vertrauenswürdige Beobachtung markiert.
Häufige Fragen.
Brauche ich ein Pathrule-Konto?
Nein. Im Standalone-Modus sendet das SDK an einen Collector, den du betreibst, und in Pathrule Local speichert und verifiziert der Host auf deinem Rechner die Ereignisse. Ein Konto brauchst du nur für Pathrule Cloud.
Ist Signals ein Analytics-Tool?
Nein. Es kennt keine Nutzer, Sessions oder Funnels. Es erfasst Fehler und die Ereignisse, die zeigen, dass ein Flow funktioniert, gruppiert nach Codepfad, und ein Scrub-Hook in der SDK-Konfiguration kann alles Sensible entfernen, bevor es gesendet wird.
Wann gilt ein Fix als verifiziert?
Wenn ein neueres Release ihn belegt: mindestens 60 Minuten Beobachtung, 3 Envelopes aus diesem Release und 3 Erfolge im eigenen Flow der Gruppe. Ein erfasster Fix ist eine Behauptung, und jedes spätere Vorkommen setzt die Gruppe auf recurred zurück.
Was bringt Pathrule Cloud zusätzlich?
Verwaltete Erfassung mit Projektschlüsseln, die nur schreiben dürfen, Aufbewahrung, Erfassung und Verifizierung von Fixes in der Cloud und Agentenzugriff mit deiner eigenen Session, in Pro, Team und Enterprise. Eine Team-Organisation teilt sich ein Cloud-Signals-Kontingent über alle Mitglieder.