Installazione per piattaforma
Ruby e Rails
Installazione gem install blipit
Aggiungi la gem blipit (0.3.0 o successiva) e chiama init una volta con la chiave pubblica del tuo progetto. Funziona sul core di Blipit senza dipendenze a runtime. Le eccezioni non gestite vengono segnalate da sole, e Rails, Rack, Sinatra e Sidekiq sono integrati.
1Gemfile
gem "blipit"2Inizializza all'avvio
Rails: config/initializers/blipit.rb; non serve installare altro, perché Blipit aggiunge da solo il suo middleware Rack e la segnalazione di Active Job e Rails.error. Le app Rack e Sinatra aggiungono use Blipit::Rack. Script: prima che il tuo codice venga eseguito. La chiave è nella pagina Chiavi del progetto. Con una chiave vuota, init stampa un avviso e restituisce false invece di sollevare un'eccezione.
Blipit.init(
key: "<public key>",
environment: Rails.env,
release: ENV["RELEASE"],
)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 nelle credentials di Rails
Questo SDK invia con la chiave pubblica. In Rails, tienila nelle credentials cifrate e leggila nell'initializer; altrove, usa una variabile d'ambiente.
bin/rails credentials:editblipit:
key: blipit_pk_your_public_keyBlipit.init(
key: Rails.application.credentials.dig(:blipit, :key),
environment: Rails.env,
)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.capture_exception(e)
Blipit.capture_message("cache miss rate above 50%", level: :warning)
Blipit.set_user(id: "42", email: "ana@example.com")
Blipit.capture_security("login_failed", email, outcome: "bad_password", ip: request.remote_ip, user_agent: request.user_agent)7Verifica 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.capture_message("Hello from Rails")Buono a sapersi
- Passa traces_sample_rate: 0.2 a init e richieste, job, chiamate Net::HTTP e query SQL compaiono nella pagina Pulse.
- Aggiornamento dalla 0.2: project: non serve più (è ancora accettato), Blipit.dsn non esiste più e before_send ora riceve l'evento come Hash nel formato di Blipit.
- 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.

