Instalar por plataforma
Python
Instalar pip install blipit
Instala el paquete blipit (0.3.0 o posterior) y llama a init una vez con la clave pública de tu proyecto. Funciona sobre el núcleo propio de Blipit y no necesita nada más que la biblioteca estándar. Las excepciones no controladas se reportan solas, y Django, Flask, FastAPI, Starlette, Celery, logging, las llamadas HTTP y SQLAlchemy se detectan automáticamente.
1Instalar
pip install blipit2Inicializa al arrancar
En Django, ponlo al principio de settings.py. En Flask o FastAPI, antes de crear la app. La clave está en la página Claves del proyecto. Con una clave vacía, init registra un aviso y devuelve False en lugar de lanzar una excepción, así que una clave que falta nunca impide que la app arranque.
import blipit
blipit.init(
key="<public key>",
environment="production",
release="myapp@1.4.2",
)3Obtén tus claves
Inicia sesión en app.blipit.io y abre Claves API en la barra lateral y luego tu proyecto. Cada proyecto tiene dos claves. La clave pública empieza por blipit_pk_: va en el código del navegador y de las apps, solo puede enviar eventos y cualquiera puede verla sin riesgo. La clave secreta empieza por blipit_sk_: se queda en tu servidor o en Odoo, nunca en un navegador, porque también puede leer y cambiar incidencias. La clave secreta solo se muestra una vez, justo al crearla, así que cópiala entonces; si la pierdes, pulsa Crear una nueva clave secreta y la anterior deja de funcionar al instante. Algunos SDKs también necesitan el id del proyecto, que aparece en la misma página.
4Guarda la clave en el entorno
Este SDK envía con la clave pública de la página Claves API del proyecto. Guárdala en una variable de entorno: en local, en un archivo .env que cargue tu framework o python-dotenv; en producción, en los ajustes de tu hosting. Usa la clave secreta solo si envías intentos de inicio de sesión.
BLIPIT_KEY=blipit_pk_your_public_keyimport os
import blipit
blipit.init(key=os.environ.get("BLIPIT_KEY"))5Mantén las claves fuera de git
Guarda las claves en variables de entorno o en los ajustes de secretos de tu hosting, nunca en código que subas con commit, y añade tus archivos .env a .gitignore. Una clave pública en una página web es normal. Si alguna vez una clave secreta acaba en git, en una página pública, en una captura o en un chat, abre Claves API, pulsa Crear una nueva clave secreta y pega la nueva clave donde se usaba la anterior: la clave anterior deja de funcionar al instante.
.env
.env.local
.env.*.local6Captura manual e intentos de inicio de sesión
Los intentos de inicio de sesión necesitan la clave secreta: en el servidor, inicializa con la clave secreta en lugar de la pública, o la ingesta los rechaza con 403 security_needs_secret_key. Plan 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")7Comprueba que funciona
Abre Incidencias en app.blipit.io. El primer evento aparece en unos segundos, agrupado en una incidencia, y los responsables reciben un correo.
blipit.capture_message("Hello from Python")Conviene saber
- Odoo: no uses esto; instala en su lugar el módulo de Blipit desde la tienda Odoo Apps. Conoce la petición, el usuario y la empresa de Odoo.
- Pasa traces_sample_rate=0.2 a init y las peticiones, las tareas de Celery, las llamadas HTTP salientes y las consultas SQL aparecen en la página Pulse.
- Si actualizas desde 0.2: project= ya no hace falta (se sigue aceptando), blipit.dsn() ya no existe y before_send ahora recibe el evento como un dict en el formato de Blipit.
- Mantener Blipit actualizado: la guía Mantener Blipit actualizado (docs.blipit.io/updates) explica el banner de actualización, los correos para versiones importantes, el aviso en tu consola de desarrollo y el comando de actualización para esta plataforma.
- Un proyecto por app y plataforma: cada proyecto elige su plataforma al crearse (Android, iOS, React Native, Flutter, Web, Backend u Odoo) y Blipit rechaza con un error claro los datos de cualquier otra plataforma, así que una app de iOS y una de Android necesitan dos proyectos con dos claves. Las versiones, las compilaciones, las tasas de fallos y las builds de tienda son distintas en cada plataforma, y mezclarlas en un proyecto hace que todas sean incorrectas. Un proyecto Web también acepta la parte de servidor de la misma app web (el servidor de Next.js o Node), y un proyecto de React Native o Flutter también acepta sus propios informes de fallos nativos de Android e iOS.
¿Atascado? Escribe a support@blipit.io. Las claves y el id de cada proyecto están en Claves API en app.blipit.io.

