.NET

Instalar dotnet add package Blipit

Añade el paquete Blipit (0.2.0 o posterior) y llama a Init una vez al arrancar con la clave pública y el id de tu proyecto. Funciona sobre el núcleo propio de Blipit. Las excepciones no controladas y las tareas fallidas que nadie esperó se reportan solas, y ASP.NET Core no necesita ningún paquete extra.

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
dotnet add package Blipit

2Inicializa al arrancar

Mantén vivo el handle devuelto durante toda la vida del proceso. Ambos valores están en la página de Claves del proyecto.

Program.cs
using Blipit;

using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
    Key = "<public key>",
    Project = "<project id>",
    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 la configuración

Este SDK envía con la clave pública y el id del proyecto. Guárdalos en user secrets durante el desarrollo y en variables de entorno en producción (Blipit__Key y Blipit__Project), y luego léelos desde la configuración.

sh
dotnet user-secrets set "Blipit:Key" "blipit_pk_your_public_key"
dotnet user-secrets set "Blipit:Project" "12"
Program.cs
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
    Key = builder.Configuration["Blipit:Key"],
    Project = builder.Configuration["Blipit:Project"],
});

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

6ASP.NET Core y logging

No hay que añadir nada más: llama a Init al principio de Program.cs. Las excepciones de endpoints, controladores y middleware se reportan con la petición, también cuando las gestiona UseExceptionHandler, y con TracesSampleRate configurado cada petición muestreada se mide en Pulse por su ruta. BlipitLoggerProvider convierte Information y superiores en breadcrumbs, y Error y superiores en eventos.

Program.cs
var builder = WebApplication.CreateBuilder(args);
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
    Key = builder.Configuration["Blipit:Key"],
    Project = builder.Configuration["Blipit:Project"],
    TracesSampleRate = 0.2,
});
builder.Logging.AddProvider(new BlipitLoggerProvider());

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.

csharp
Blipit.Blipit.CaptureException(ex);
Blipit.Blipit.CaptureMessage("cache miss rate above 50%", BlipitLevel.Warning);
Blipit.Blipit.SetUser(id: "42", email: "ana@example.com");
Blipit.Blipit.CaptureSecurity("login_failed", email, "bad_password", null, ip, userAgent, null);

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.

csharp
Blipit.Blipit.CaptureMessage("Hello from .NET");

Conviene saber

  • Compatible con netstandard2.0 y net8.0.
  • TracesSampleRate = 0.2 en las opciones envía las peticiones a la página Pulse; await Blipit.Blipit.Trace("charge card", () => gateway.ChargeAsync(order)) añade un paso medido dentro de una petición.
  • Si actualizas desde 0.1: quita el paquete extra de ASP.NET Core y la línea builder.WebHost que necesitaba 0.1, porque Init ya cubre ASP.NET Core. Blipit.Dsn, Blipit.Apply, BlipitOptions.Configure y PackageName se han eliminado, CaptureMessage y AddBreadcrumb reciben BlipitLevel, y las llamadas de captura devuelven el id del evento como string.
  • 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.