Installation nach Plattform
Go
Installation go get github.com/blipit-io/blipit-go
Fügen Sie das Modul blipit-go (v0.3.0 oder neuer) hinzu und rufen Sie Init einmal in main mit dem öffentlichen Schlüssel und der Projekt-ID Ihres Projekts auf. Es läuft auf Blipits eigenem Kern und nutzt nur die Go-Standardbibliothek. Rufen Sie Flush auf, bevor der Prozess endet, damit die letzten Events nicht verloren gehen.
1Installation
go get github.com/blipit-io/blipit-go2In main initialisieren
Init löst nie eine Panic aus: Mit einem leeren Schlüssel oder einer leeren Projekt-ID gibt es einen Fehler zurück und Blipit bleibt aus. Protokollieren Sie den Fehler also, statt das Programm zu beenden.
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)
}3Schlüssel abrufen
Melden Sie sich bei app.blipit.io an und öffnen Sie API-Schlüssel in der Seitenleiste, dann Ihr Projekt. Jedes Projekt hat zwei Schlüssel. Der öffentliche Schlüssel beginnt mit blipit_pk_: Er gehört in Browser- und App-Code, kann nur Events senden und darf von jedem gesehen werden. Der geheime Schlüssel beginnt mit blipit_sk_: Er bleibt auf Ihrem Server oder in Odoo, nie in einem Browser, weil er auch Issues lesen und ändern kann. Der geheime Schlüssel wird nur einmal angezeigt, direkt nach der Erstellung, kopieren Sie ihn also dann; geht er verloren, klicken Sie auf Neuen geheimen Schlüssel erstellen, und der alte funktioniert sofort nicht mehr. Manche SDKs brauchen zusätzlich die Projekt-ID, die auf derselben Seite steht.
4Den Schlüssel in der Umgebung ablegen
Dieses SDK sendet mit dem öffentlichen Schlüssel und der Projekt-ID. Lesen Sie sie aus Umgebungsvariablen, die Ihr Hoster, eine systemd-Unit oder docker run -e setzt.
blipit.Init(blipit.Options{
Key: os.Getenv("BLIPIT_KEY"),
Project: os.Getenv("BLIPIT_PROJECT"),
})5Schlüssel aus Git heraushalten
Bewahren Sie Schlüssel in Umgebungsvariablen oder den Secret-Einstellungen Ihres Hosters auf, nie in Code, den Sie committen, und tragen Sie Ihre .env-Dateien in .gitignore ein. Ein öffentlicher Schlüssel in einer Webseite ist normal. Landet ein geheimer Schlüssel je in Git, auf einer öffentlichen Seite, in einem Screenshot oder einem Chat, öffnen Sie API-Schlüssel, klicken Sie auf Neuen geheimen Schlüssel erstellen und fügen Sie den neuen Schlüssel überall ein, wo der alte verwendet wurde: Der alte Schlüssel funktioniert sofort nicht mehr.
.env
.env.local
.env.*.local6Manuelles Erfassen und Anmeldeversuche
Anmeldeversuche brauchen den geheimen Schlüssel: Initialisieren Sie auf dem Server mit dem geheimen statt dem öffentlichen Schlüssel, sonst lehnt die Annahme sie mit 403 security_needs_secret_key ab. Scale-Tarif.
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 und net/http
defer blipit.Recover() am Anfang von main oder einer beliebigen Goroutine meldet eine Panic mit ihrem Stack, sendet ausstehende Events und löst die Panic erneut aus. Umschließen Sie den Handler, den Sie bereitstellen, mit blipit.Handler, um Panics mit dem Request zu melden und jeden Request auf Pulse zu messen, benannt nach seinem ServeMux-Muster. Gin, Echo und Fiber verwenden StartRequest, SetRoute und End, wie in der README des Pakets gezeigt.
go func() {
defer blipit.Recover()
work()
}()
mux := http.NewServeMux()
mux.HandleFunc("GET /items/{id}", item)
http.ListenAndServe(":8080", blipit.Handler(mux))8Prüfen, ob es funktioniert
Öffnen Sie Issues in app.blipit.io. Das erste Event erscheint innerhalb weniger Sekunden, gruppiert zu einem Issue, und die verantwortlichen Personen erhalten eine E-Mail.
blipit.CaptureMessage("Hello from Go")Gut zu wissen
- TracesSampleRate: 0.2 in Options sendet Requests an die Pulse-Seite; blipit.Trace(ctx, name, fn) fügt innerhalb eines Requests einen gemessenen Schritt hinzu.
- Upgrade von v0.2: blipit.DSN entfällt, und User, Breadcrumb und Level sind Blipits eigene Typen (User behält ID, Email und Username; Breadcrumb behält Category, Message, Level, Data und Timestamp).
- Blipit aktuell halten: Die Anleitung „Blipit auf dem neuesten Stand halten“ (docs.blipit.io/updates) erklärt das Update-Banner, die E-Mails zu wichtigen Releases, den Hinweis in deiner Entwicklungskonsole und den Update-Befehl für diese Plattform.
- Ein Projekt pro App und Plattform: Jedes Projekt legt beim Anlegen seine Plattform fest (Android, iOS, React Native, Flutter, Web, Backend oder Odoo), und Blipit lehnt Daten von jeder anderen Plattform mit einer klaren Fehlermeldung ab. Eine iOS-App und eine Android-App brauchen also zwei Projekte mit zwei Schlüsseln. Releases, Versionen, Absturzraten und Store-Builds sind je Plattform verschieden, und gemischt in einem Projekt stimmt keiner dieser Werte mehr. Ein Web-Projekt nimmt auch die Serverseite derselben Web-App an (den Next.js-Server oder Node), und ein React-Native- oder Flutter-Projekt auch seine eigenen nativen Android- und iOS-Absturzberichte.
Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und die Projekt-ID jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.

