JavaScript

Cosa raccoglie

Da solo:

• le eccezioni non gestite e i rifiuti di Promise;
• i log strutturati;
• la cronologia prima dell'errore: click, navigazione, console, richieste HTTP (solo nel browser);
• i metodi lenti, quando li misuri con measure().

Se lo accendi tu:

• i problemi di performance: chiamate HTTP lente o ripetute, pagina che si blocca;
• i Web Vitals;
• gli errori delle risorse e le violazioni CSP;
• le pagine viste;
• la registrazione della sessione, con i campi dei moduli mascherati;
• la telemetria d'uso (solo lato server).

Dalla 0.13.0, il modulo facoltativo /database osserva query lente e ripetute su Node: pg, mysql2, Drizzle tramite questi driver e Prisma tramite il driver PostgreSQL. È disattivato per impostazione predefinita. Prisma MySQL, cursori e streaming non sono coperti.

Installa

pnpm add @bussolabs/closeyourit-js
npm install @bussolabs/closeyourit-js

Basta uno dei due comandi.

Configura

import * as CloseYourIt from "@bussolabs/closeyourit-js"

CloseYourIt.init({
  endpointUrl: "https://bugs.example.com",
  publicKey: "<chiave pubblica del token>",
  projectId: "<id del progetto>",
  environment: "production",
  release: "[email protected]",
})

Quale credenziale

• Nel browser usa publicKey: non è segreta.
• Su Node usa un token segreto con permesso ingest. Per leggere serve il permesso separato read.

Il token non deve mai finire nel codice del browser. Se nel browser passi solo il token, l'SDK resta spento e lo scrive in console.

Vue e Nuxt

La versione 0.12.0 aggiunge adattatori facoltativi Vue, Nuxt client e Nitro server. La guida Nuxt descrive configurazione pubblica, credenziali private, isolamento delle richieste e rimozione.

Per le tracce OpenTelemetry usa il percorso OTLP separato. Gli header W3C e measure() dell’SDK nativo non creano operazioni OTLP.

Altri framework

React/Next, Angular, Svelte/SvelteKit ed Express/Fastify/Nest hanno moduli facoltativi nel pacchetto 0.13.0. Consulta copertura e limiti prima di scegliere l’adattatore. La guida database Node descrive installazione esplicita, confini della richiesta, privacy e disinstallazione.