Installazione per piattaforma
Go
Installazione go get github.com/blipit-io/blipit-go
Aggiungi il modulo blipit-go (v0.3.0 o successivo) e chiama Init una volta in main con la chiave pubblica e l'id del tuo progetto. Funziona sul core di Blipit e usa solo la libreria standard di Go. Chiama Flush prima che il processo termini, così gli ultimi eventi non vanno persi.
1Installazione
go get github.com/blipit-io/blipit-go2Inizializza in main
Init non va mai in panic: con una chiave o un id progetto vuoti restituisce un errore e Blipit resta spento, quindi registra l'errore invece di uscire.
import (
"log"
"time"
"github.com/blipit-io/blipit-go"
)
func main() {
if err := blipit.Init(blipit.Options{
Key: "<public key>",
Project: "<project id>",
Environment: "production",
Release: "myapp@1.4.2",
}); err != nil {
log.Printf("blipit: %v", err)
}
defer blipit.Flush(2 * time.Second)
}3Ottieni le chiavi
Accedi su app.blipit.io e apri Chiavi API nella barra laterale, poi il tuo progetto. Ogni progetto ha due chiavi. La chiave pubblica inizia con blipit_pk_: va nel codice del browser e delle app, può solo inviare eventi e chiunque può vederla senza rischi. La chiave segreta inizia con blipit_sk_: resta sul tuo server o in Odoo, mai in un browser, perché può anche leggere e modificare le issue. La chiave segreta viene mostrata una sola volta, subito dopo la creazione, quindi copiala in quel momento; se la perdi, premi Crea una nuova chiave segreta e quella vecchia smette subito di funzionare. Alcuni SDK richiedono anche l'id del progetto, mostrato nella stessa pagina.
4Tieni la chiave nell'ambiente
Questo SDK invia con la chiave pubblica e l'id del progetto. Leggili da variabili d'ambiente impostate dal tuo host, da una unit systemd o da docker run -e.
blipit.Init(blipit.Options{
Key: os.Getenv("BLIPIT_KEY"),
Project: os.Getenv("BLIPIT_PROJECT"),
})5Tieni le chiavi fuori da git
Tieni le chiavi in variabili d'ambiente o nelle impostazioni dei secret del tuo host, mai nel codice che fai commit, e aggiungi i tuoi file .env a .gitignore. Una chiave pubblica in una pagina web è normale. Se una chiave segreta finisce in git, in una pagina pubblica, in uno screenshot o in una chat, apri Chiavi API, premi Crea una nuova chiave segreta e incolla la nuova chiave ovunque usavi quella vecchia: la vecchia chiave smette di funzionare subito.
.env
.env.local
.env.*.local6Cattura manuale e tentativi di accesso
I tentativi di accesso richiedono la chiave segreta: sul server inizializza con la chiave segreta invece di quella pubblica, altrimenti l'ingestione li rifiuta con 403 security_needs_secret_key. Piano Scale.
blipit.CaptureException(err)
blipit.CaptureMessage("cache miss rate above 50%")
blipit.SetUser(blipit.User{ID: "42", Email: "ana@example.com"})
blipit.CaptureSecurity(blipit.Security{Kind: "login_failed", Actor: email, IP: ip, UserAgent: agent, Outcome: "bad_password"})7Panic e net/http
defer blipit.Recover() in cima a main o a qualsiasi goroutine segnala un panic con il suo stack, svuota la coda e rilancia il panic. Avvolgi l'handler che servi con blipit.Handler per segnalare i panic con la richiesta e misurare ogni richiesta su Pulse, chiamata secondo il suo pattern ServeMux. Gin, Echo e Fiber usano StartRequest, SetRoute ed End, mostrati nel README del pacchetto.
go func() {
defer blipit.Recover()
work()
}()
mux := http.NewServeMux()
mux.HandleFunc("GET /items/{id}", item)
http.ListenAndServe(":8080", blipit.Handler(mux))8Verifica che funzioni
Apri Issue in app.blipit.io. Il primo evento compare entro pochi secondi, raggruppato in una issue, e i responsabili ricevono un'email.
blipit.CaptureMessage("Hello from Go")Buono a sapersi
- TracesSampleRate: 0.2 in Options invia le richieste alla pagina Pulse; blipit.Trace(ctx, name, fn) aggiunge un passaggio cronometrato dentro una richiesta.
- Aggiornamento dalla v0.2: blipit.DSN è stato rimosso, e User, Breadcrumb e Level sono tipi propri di Blipit (User mantiene ID, Email e Username; Breadcrumb mantiene Category, Message, Level, Data e Timestamp).
- Tenere Blipit aggiornato: la guida Tenere Blipit aggiornato (docs.blipit.io/updates) spiega il banner di aggiornamento, le email per le versioni importanti, l'avviso nella console di sviluppo e il comando di aggiornamento per questa piattaforma.
- Un progetto per app e piattaforma: ogni progetto sceglie la sua piattaforma quando viene creato (Android, iOS, React Native, Flutter, Web, Backend o Odoo) e Blipit rifiuta con un errore chiaro i dati di qualsiasi altra piattaforma, quindi un'app iOS e un'app Android hanno bisogno di due progetti con due chiavi. Release, versioni, tassi di crash e build per gli store sono diversi per ogni piattaforma, e mescolarli in un progetto li rende tutti sbagliati. Un progetto Web accetta anche la parte server della stessa app web (il server Next.js o Node), e un progetto React Native o Flutter accetta anche i propri crash nativi Android e iOS.
Bloccato? Scrivi a support@blipit.io. Le chiavi e l'id di ogni progetto sono sotto Chiavi API in app.blipit.io.

