Instalar por plataforma
Ruby y Rails
Instalar gem install blipit
Añade la gema 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, sin dependencias en tiempo de ejecución. Las excepciones no controladas se reportan solas, y Rails, Rack, Sinatra y Sidekiq vienen incluidos.
1Gemfile
gem "blipit"2Inicializa al arrancar
Rails: config/initializers/blipit.rb; no hay que instalar nada más, porque Blipit añade por su cuenta su middleware de Rack y el reporte de Active Job y Rails.error. Las apps de Rack y Sinatra añaden use Blipit::Rack. Scripts: antes de que se ejecute tu código. La clave está en la página Claves del proyecto. Con una clave vacía, init muestra un aviso y devuelve false en lugar de lanzar una excepción.
Blipit.init(
key: "<public key>",
environment: Rails.env,
release: ENV["RELEASE"],
)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 las credentials de Rails
Este SDK envía con la clave pública. En Rails, guárdala en las credenciales cifradas y léela en el initializer; en otros casos, usa una variable de entorno.
bin/rails credentials:editblipit:
key: blipit_pk_your_public_keyBlipit.init(
key: Rails.application.credentials.dig(:blipit, :key),
environment: Rails.env,
)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(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)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 Rails")Conviene saber
- Pasa traces_sample_rate: 0.2 a init y las peticiones, los jobs, las llamadas Net::HTTP 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 Hash 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.

