PathruleSachez ce qui s'est passé.
Vérifiez ce qui a été corrigé.
Pathrule Signals relie ce que fait votre application à l'exécution aux agents qui la modifient. Les erreurs et événements sont regroupés selon le chemin de code dont ils viennent, votre agent de codage peut les lire, et un correctif n'est considéré comme vérifié que lorsque la version suivante le prouve.
- TypeError dans submitOrderversion 2.4.0, 37 occurrences, la référence
- Correctif enregistré par votre agentune affirmation, pas une preuve
- Version 2.4.1 en observation60 min, 3 enveloppes, 3 checkouts réussis
- Vérifiéaucune récurrence dans la version plus récente
Toute occurrence en 2.4.1 ou au-delà repasse le groupe à l'état recurred.
Trois façons de l'exécuter.
- SDK open sourceStandaloneLe SDK sous Apache-2.0 envoie vers un collecteur HTTP que vous exploitez. Ni compte Pathrule ni Cloud.
- sans comptePathrule LocalLes événements vont à l'hôte Pathrule de votre machine, qui les stocke, les regroupe, les vérifie et les rend lisibles par votre agent. Lancez
pathrule init --localune fois. - géréPathrule CloudUne ingestion gérée avec des clés de projet en écriture seule et une durée de conservation, lue par les agents avec votre session. Inclus dans Pro, Team et Enterprise.
Standalone et Local ne demandent ni compte ni offre payante. Cloud Signals fait partie de Pro, Team et Enterprise.
Instrumentez une fois.
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" },});
Chaque erreur et chaque événement nomme son chemin de code et son flux. C'est l'identité de version qui rend la vérification possible, et c'est un succès sur le même flux qui prouve un correctif.
Vérifié veut dire que l'exécution l'atteste.
- grouped
- Un groupe par environnement, type et empreinte, construite à partir du libellé, du flux et du chemin de code. Une enveloppe renvoyée n'est stockée qu'une fois.
- observing
- Une version plus récente lance l'observation. La version de référence, les événements sans version et tout ce qui précède le correctif ne comptent jamais.
- verified
- Au moins 60 minutes, 3 enveloppes de la version plus récente et 3 succès du flux propre au groupe.
- quiet
- 24 heures et 3 enveloppes sans récurrence, pour un groupe qui n'a pas de flux à prouver.
- recurred
- Toute occurrence dans une version plus récente, même après verified. Le groupe redevient actif.
Enregistrer un correctif est une affirmation, pas une preuve. Seules des preuves d'exécution issues d'une version plus récente peuvent résoudre un groupe ; personne n'en résout un à la main.
Votre agent les lit.
Runtime: 2 active issues under apps/web/checkout (1 came back after a fix).Inspect with pathrule_runtime_events.
- pathrule_runtime_events
- Lit les groupes avec leur état de vérification, les corrections enregistrées et la couverture, filtrés par chemin, type, environnement ou état.
- pathrule_runtime_events_resolve
- Enregistre une correction pour une révision d'un groupe. C'est une affirmation ; l'exécution décide si elle tient.
- pathrule instrument events
- Les mêmes groupes dans un terminal, par exemple avec --verification recurred.
La ligne d'exécution ne contient que des comptes, jamais le contenu signalé, et tout ce qu'un agent lit dans Signals est marqué comme observation non fiable.
Questions fréquentes.
Ai-je besoin d'un compte Pathrule ?
Non. En mode Standalone, le SDK envoie vers un collecteur que vous exploitez, et avec Pathrule Local, l'hôte de votre machine stocke et vérifie les événements. Un compte n'est nécessaire que pour Pathrule Cloud.
Signals est-il un outil d'analytics ?
Non. Il n'a ni utilisateurs, ni sessions, ni entonnoirs. Il enregistre les erreurs et les événements qui montrent qu'un flux fonctionne, regroupés par chemin de code, et un hook de nettoyage dans la configuration du SDK peut retirer toute donnée sensible avant l'envoi.
Qu'est-ce qui rend un correctif vérifié ?
Des preuves issues d'une version plus récente : au moins 60 minutes d'observation, 3 enveloppes de cette version et 3 succès du flux propre au groupe. Un correctif enregistré est une affirmation, et toute occurrence ultérieure repasse le groupe à l'état recurred.
Qu'apporte Pathrule Cloud ?
Une ingestion gérée avec des clés de projet en écriture seule, la conservation, l'enregistrement et la vérification des correctifs dans Cloud, et un accès des agents avec votre propre session, sur Pro, Team et Enterprise. Une organisation Team partage un même quota Cloud Signals entre ses membres.