PHP y Laravel

Instalar composer require blipit/blipit

Instala el paquete blipit/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 instala ningún otro paquete. Las excepciones no capturadas, los avisos y los errores fatales se reportan solos, y Laravel y Symfony vienen incluidos.

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
composer require blipit/blipit

2Inicializa al arrancar

PHP sin framework: al principio de tu front controller, antes de atender cualquier petición. Laravel arranca Blipit desde su configuración, como en el siguiente paso. La clave está en la página Claves del proyecto. Con una clave vacía, init escribe un aviso en el log de errores y devuelve false en lugar de lanzar una excepción.

php
use Blipit\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. Laravel: añádela a .env y a config/services.php; el service provider de Blipit se detecta solo y arranca Blipit desde esa configuración, así que no hace falta nada más. Lee los valores a través de config, porque env() no devuelve nada en el código de la app una vez cacheada la configuración. PHP sin framework: lee la clave con getenv() del entorno del servidor.

.env
BLIPIT_KEY=blipit_pk_your_public_key
config/services.php
'blipit' => [
    'key' => env('BLIPIT_KEY'),
    'environment' => env('APP_ENV'),
    'release' => env('GIT_SHA'),
],

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

6Laravel y Symfony

Laravel: toda excepción que reporta su handler llega a Blipit, así que los 404 y los errores de validación quedan fuera. Las consultas, las líneas de log y las llamadas del cliente HTTP se convierten en breadcrumbs, y los jobs en cola se trazan. Una línea Blipit::captureException que ya tengas en bootstrap/app.php puede quedarse: la misma excepción nunca se envía dos veces. Symfony: registra el listener en config/services.yaml y llama a Blipit::init pronto en public/index.php y bin/console.

config/services.yaml
Blipit\Symfony\BlipitListener:
    arguments: ['@router']
    tags:
        - { name: kernel.event_listener, event: kernel.exception, method: onKernelException }
        - { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }
        - { name: kernel.event_listener, event: kernel.terminate, method: onKernelTerminate }
        - { name: kernel.event_listener, event: console.error, method: onConsoleError }

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

php
Blipit::captureException($e);
Blipit::captureMessage("cache miss rate above 50%", "warning");
Blipit::setUser(["id" => "42", "email" => "ana@example.com"]);
Blipit::captureSecurity("login_failed", $email, "bad_password", null, $request->ip(), $request->userAgent());

8Comprueba 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.

php
Blipit::captureMessage("Hello from PHP");

Conviene saber

  • Pasa "traces_sample_rate" => 0.2 en init y las peticiones aparecen en la página Pulse. Blipit::trace("import orders", fn () => $importer->run()) mide cualquier bloque dentro de una petición o job trazado.
  • Si actualizas desde 0.2: project ya no hace falta (se sigue aceptando), Blipit::dsn() y Blipit::notice() ya no existen y before_send ahora recibe y devuelve el evento como un array 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.