Installazione per piattaforma
Python
Installazione pip install blipit
Installa il pacchetto blipit (0.3.0 o successivo) e chiama init una volta con la chiave pubblica del tuo progetto. Funziona sul core di Blipit e non richiede altro che la libreria standard. Le eccezioni non gestite vengono segnalate da sole, e Django, Flask, FastAPI, Starlette, Celery, logging, chiamate HTTP e SQLAlchemy vengono rilevati automaticamente.
1Installazione
pip install blipit2Inizializza all'avvio
Per Django, mettilo in cima a settings.py. Per Flask o FastAPI, prima che l'app venga creata. La chiave è nella pagina Chiavi del progetto. Con una chiave vuota, init registra un avviso e restituisce False invece di sollevare un'eccezione, così una chiave mancante non impedisce mai all'app di avviarsi.
import blipit
blipit.init(
key="<public key>",
environment="production",
release="myapp@1.4.2",
)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 presa dalla pagina Chiavi API del progetto. Tienila in una variabile d'ambiente: in locale in un file .env caricato dal tuo framework o da python-dotenv, in produzione nelle impostazioni del tuo host. Usa la chiave segreta solo se invii i tentativi di accesso.
BLIPIT_KEY=blipit_pk_your_public_keyimport os
import blipit
blipit.init(key=os.environ.get("BLIPIT_KEY"))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(err)
blipit.capture_message("cache miss rate above 50%", level="warning")
blipit.set_user({"id": "42", "email": "ana@example.com"})
blipit.set_context("order", {"id": 1042, "total": 99.5})
blipit.capture_security("login_failed", actor=email, ip=request.META.get("REMOTE_ADDR"), outcome="bad_password")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 Python")Buono a sapersi
- Odoo: non usare questo; installa invece il modulo Blipit dall'Odoo Apps store. Conosce la richiesta, l'utente e l'azienda di Odoo.
- Passa traces_sample_rate=0.2 a init e richieste, task Celery, chiamate HTTP in uscita 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 dict 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.

