Instalar por plataforma
Go
Instalar go get github.com/blipit-io/blipit-go
Añade el módulo blipit-go (v0.3.0 o posterior) y llama a Init una vez en main con la clave pública y el id de tu proyecto. Funciona sobre el núcleo propio de Blipit y solo usa la biblioteca estándar de Go. Haz Flush antes de que termine el proceso para no perder los últimos eventos.
1Instalar
go get github.com/blipit-io/blipit-go2Inicializa en main
Init nunca hace panic: con una clave o un id de proyecto vacíos devuelve un error y Blipit queda desactivado, así que registra el error en lugar de salir.
import (
"log"
"time"
"github.com/blipit-io/blipit-go"
)
func main() {
if err := blipit.Init(blipit.Options{
Key: "<public key>",
Project: "<project id>",
Environment: "production",
Release: "myapp@1.4.2",
}); err != nil {
log.Printf("blipit: %v", err)
}
defer blipit.Flush(2 * time.Second)
}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 y el id del proyecto. Léelos de variables de entorno definidas por tu hosting, una unidad de systemd o docker run -e.
blipit.Init(blipit.Options{
Key: os.Getenv("BLIPIT_KEY"),
Project: os.Getenv("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.
.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.CaptureException(err)
blipit.CaptureMessage("cache miss rate above 50%")
blipit.SetUser(blipit.User{ID: "42", Email: "ana@example.com"})
blipit.CaptureSecurity(blipit.Security{Kind: "login_failed", Actor: email, IP: ip, UserAgent: agent, Outcome: "bad_password"})7Panics y net/http
defer blipit.Recover() al principio de main o de cualquier goroutine reporta un panic con su stack, envía lo pendiente y vuelve a hacer panic. Envuelve el handler que sirves con blipit.Handler para reportar los panics con la petición y medir cada petición en Pulse, con el nombre de su patrón de ServeMux. Gin, Echo y Fiber usan StartRequest, SetRoute y End, como muestra el README del paquete.
go func() {
defer blipit.Recover()
work()
}()
mux := http.NewServeMux()
mux.HandleFunc("GET /items/{id}", item)
http.ListenAndServe(":8080", blipit.Handler(mux))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.
blipit.CaptureMessage("Hello from Go")Conviene saber
- TracesSampleRate: 0.2 en Options envía las peticiones a la página Pulse; blipit.Trace(ctx, name, fn) añade un paso medido dentro de una petición.
- Si actualizas desde v0.2: blipit.DSN se ha eliminado, y User, Breadcrumb y Level son tipos propios de Blipit (User conserva ID, Email y Username; Breadcrumb conserva Category, Message, Level, Data y Timestamp).
- 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.

