PathruleVerifizierung und Lebenszyklus
Wie Pathrule Signals Events gruppiert, was jeder Gruppenstatus und jeder Verifizierungszustand bedeutet, welche Belege ein Fix braucht, bevor er als verifiziert gilt, und wie lange Local Gruppen aufbewahrt.
Auf dieser Seite
Signals trennt zwei Fragen: Was passiert immer wieder, und hat ein Fix tatsächlich gehalten? Die erste beantwortet die Gruppierung, die zweite die Verifizierung, und die zweite lässt sich nur mit Belegen aus der Laufzeit beantworten.
Gruppen
Jedes Event gehört zu genau einer Gruppe pro Umgebung, Art (error oder event) und Fingerprint. Der Fingerprint wird aus Label, Flow und Codepfad des Events abgeleitet. Derselbe Fehler an derselben Stelle bildet also eine einzige Gruppe, egal wie oft er auftritt, und derselbe Fehler in Production und in Preview bleibt getrennt. Jedes Envelope trägt eine ID, die bei jedem erneuten Senden gleich bleibt, sodass ein wiederholt gesendetes Envelope nur einmal gespeichert wird.
Status und Verifizierung
Eine Gruppe hat einen Status:
active: Sie tritt auf oder ist zurückgekehrt.declared: Ein Instrumentierungspunkt wurde angekündigt, aber bisher wurde nichts gemeldet.resolved: Die Verifizierung hat bewiesen, dass der Fix gehalten hat.archived: Sie ist verstummt und wurde geschlossen. Archiviert heißt nicht gelöst.
Und einen Verifizierungszustand:
| Zustand | Bedeutung |
|---|---|
unobserved | Kein Fix erfasst oder noch kein neueres Release gesehen. |
observing | Ein neueres Release läuft, und es werden Belege gesammelt. |
quiet | 24 Stunden und mindestens 3 Envelopes aus dem neueren Release ohne erneutes Auftreten. Mehr kann eine Gruppe ohne Flow nicht erreichen. |
verified | Der Fix hat gehalten: Die unten beschriebenen Belege liegen vor. Die Gruppe wird resolved. |
recurred | Sie ist in einem neueren Release erneut aufgetreten. Die Gruppe ist wieder active. |
Was als Beleg zählt
Ein Fix ist verifiziert, wenn für ein Release, das neuer ist als das, gegen das der Fix erfasst wurde, alle drei Bedingungen erfüllt sind:
- mindestens 60 Minuten Beobachtung,
- mindestens 3 Envelopes aus diesem neueren Release,
- mindestens 3 erfolgreiche Durchläufe des gruppeneigenen Flows, gemeldet mit
meta.outcome: "success".
Manches zählt nie: das Baseline-Release, Events ohne Release-Identität und alles, was beobachtet wurde, bevor der Fix erfasst war. Ein neueres Release startet die Beobachtung von vorn. Bleibt das neuere Release 45 Minuten lang stumm, veraltet ein quiet-Zustand. Ohne Release-Identität ist die Verifizierung blockiert, und das SDK meldet no_release.
Einen Fix erfassen
Wenn du oder dein Agent etwas behebt, wird der Fix an der Gruppe erfasst (siehe Agent-Integration). Das Erfassen ist eine Behauptung, kein Beweis: Es setzt von sich aus nichts auf resolved. Das tut nur die Verifizierung. Es gibt kein manuelles Lösen, und jedes Auftreten in einem neueren Release setzt die Gruppe auf recurred und zurück auf active, selbst nach verified.
Aufbewahrung in Pathrule Local
- Bis zu 5.000 Gruppen pro Workspace.
- Eine ungelöste Gruppe läuft ab, wenn sie 14 Tage lang in Production nicht aufgetreten ist, 7 Tage in Development oder Preview und 30 Tage bei einer Deklaration.
- Gelöste Gruppen und ihre Historie werden 90 Tage lang aufbewahrt.
- Envelope-IDs werden 2 Tage lang gespeichert, und genau das macht erneutes Senden sicher.
Die Aufbewahrung in der Cloud ist auf der Seite Cloud Signals beschrieben.