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.

Pégalo en Claude Code, Cursor o cualquier asistente de programación con IA. Incluye los pasos y el código. En app.blipit.io, en Claves de API, el mismo prompt viene con tu clave ya puesta.
Vídeo: instalar Blipit en cualquier stack, desde 1:07

1Instalar

sh
pip install blipit

2Inicializa 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.

python
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.

Claves API en app.blipit.io: la clave pública (blipit_pk_) para el código del navegador y la clave secreta (blipit_sk_) para servidores y Odoo.
Claves API en app.blipit.io: la clave pública (blipit_pk_) para el código del navegador y la clave secreta (blipit_sk_) para servidores y Odoo.
Una nueva clave secreta se muestra una sola vez. Cópiala ahora: se guarda con hash y no se puede volver a mostrar.
Una nueva clave secreta se muestra una sola vez. Cópiala ahora: se guarda con hash y no se puede volver a mostrar.

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.

.env
BLIPIT_KEY=blipit_pk_your_public_key
python
import 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.

.gitignore
.env
.env.local
.env.*.local

6Captura 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.

python
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.

python
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.