Vai al contenuto
Pathrule

documentazione

Panoramica di Signals

Pathrule Signals registra errori ed eventi di runtime, li raggruppa in base al percorso di codice da cui provengono, li rende leggibili dal tuo agente di programmazione e verifica una correzione con le prove di una release più recente.

In questa pagina

Pathrule Signals collega ciò che la tua app fa a runtime con gli sviluppatori e gli agenti di programmazione che la modificano. Instrumenti il codice una sola volta con l'SDK open source, che segnala gli errori e gli eventi che dimostrano il funzionamento di un flusso, insieme al percorso di codice e al flusso a cui appartengono e alla release che li ha prodotti. Signals raggruppa ciò che riceve, lo conserva, lo rende leggibile dal tuo agente di programmazione e stabilisce, in base alle prove di runtime, se una correzione regge davvero.

Cosa fa

  • Instrumenta il codice. pathrule.error() e pathrule.event() segnalano ciò che è successo, ciascuno collegato a un percorso di codice (node) e a un flusso. Consulta la guida rapida.
  • Raccoglie gli eventi. L'SDK li raggruppa in envelope del protocollo Signals e, in caso di errore, ritenta senza mai rifiutarli.
  • Li raggruppa. Un gruppo per ogni combinazione di ambiente, tipo e fingerprint, così trentasette occorrenze dello stesso errore diventano una sola cosa da esaminare.
  • Verifica le correzioni. Un gruppo risulta verificato solo dopo che una release più recente è stata osservata abbastanza a lungo e il suo flusso è andato a buon fine. Consulta verifica e ciclo di vita.
  • Osserva le release nel tempo. Una release più recente fa ripartire l'osservazione, e un'occorrenza in qualsiasi release successiva riapre il gruppo come recurred.
  • Arriva al tuo agente. L'integrazione con gli agenti fornisce agli agenti di programmazione una riga di runtime nel loro contesto e uno strumento per leggere i gruppi relativi al percorso su cui stanno lavorando.

Tre modalità di funzionamento

ModalitàAccountDove vanno gli eventiCosa ottieni
StandaloneNessunoUn collector HTTP gestito da te, tramite httpCollector()L'SDK e il protocollo. Conservi ed elabori gli eventi per conto tuo.
Pathrule LocalNessunoL'host Pathrule sulla tua macchina, tramite pathruleLocal()Conservazione, raggruppamento, verifica, accesso per gli agenti e la CLI, tutto in locale.
Pathrule CloudAccount PathruleIngestione gestita, tramite pathruleCloud({ key })Conservazione e accesso per gli agenti con la tua sessione, sui piani Pro, Team ed Enterprise.

Standalone e Local sono disponibili su tutti i piani, non hanno limiti di consumo e non richiedono un piano a pagamento. Cloud Signals è incluso nei piani Pro, Team ed Enterprise; consulta Cloud Signals e i prezzi.

Cosa non è Signals

  • Non è uno strumento di analytics. Non ci sono utenti, sessioni né funnel. Signals registra errori ed esiti dei flussi, raggruppati per percorso di codice.
  • Non corregge in automatico. Signals dice a te e al tuo agente cosa è successo e se una correzione ha retto. La modifica del codice resta compito tuo e del tuo agente.
  • Non è un pulsante di risoluzione manuale. Registrare una correzione è un'affermazione. Solo le prove di runtime risolvono un gruppo.

Cosa è incluso

  • L'SDK (@pathrule/signals 0.2.0, Apache-2.0) con il collector HTTP, le destinazioni Local e Cloud e la versione 1 del protocollo.
  • Pathrule Local: conservazione, raggruppamento e verifica sulla tua macchina, gli strumenti per gli agenti e il comando pathrule instrument events.
  • Pathrule Cloud: la pipeline di ingestione gestita, la registrazione delle correzioni e la loro verifica con la stessa policy di Local, la deduplicazione degli envelope e la conservazione automatica.