Java und Kotlin

Installation com.github.blipit-io:blipit-java

Die Bibliothek blipit-java wird von JitPack direkt aus GitHub bereitgestellt. Sie läuft auf Blipits eigenem Kern, hat keine Abhängigkeiten und funktioniert ab Java 8. Fügen Sie das Repository und die Abhängigkeit hinzu und rufen Sie Blipit.init beim Start einmal mit dem öffentlichen Schlüssel und der Projekt-ID Ihres Projekts auf.

Fügen Sie ihn in Claude Code, Cursor oder einen anderen KI-Programmierassistenten ein. Er enthält die Schritte und den Code. In app.blipit.io unter API-Schlüssel steht derselbe Prompt mit Ihrem Schlüssel bereits eingetragen.
Video: Blipit in jedem Stack installieren, ab 1:07

1Repository und Abhängigkeit hinzufügen

build.gradle.kts
repositories {
    mavenCentral()
    maven("https://jitpack.io")
}

dependencies {
    implementation("com.github.blipit-io:blipit-java:v0.2.2")
}
pom.xml
<repositories>
  <repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.github.blipit-io</groupId>
  <artifactId>blipit-java</artifactId>
  <version>v0.2.2</version>
</dependency>

2Beim Start initialisieren

Spring Boot: ganz oben in main, vor SpringApplication.run, oder in einer @PostConstruct-Methode einer @Configuration-Klasse. Nicht abgefangene Exceptions in jedem Thread werden in eine Warteschlange auf der Festplatte geschrieben, bevor die App stoppt, und dann gesendet, sodass ein Absturz auch ohne Netzwerk gemeldet wird; was übrig bleibt, geht beim nächsten Start raus.

java
import io.blipit.Blipit;
import io.blipit.BlipitOptions;

Blipit.init(BlipitOptions.builder()
    .key("<public key>")
    .project(<project id>)
    .environment("production")
    .release("myapp@1.4.2")
    .build());

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.

API-Schlüssel in app.blipit.io: der öffentliche Schlüssel (blipit_pk_) für Browser-Code und der geheime Schlüssel (blipit_sk_) für Server und Odoo.
API-Schlüssel in app.blipit.io: der öffentliche Schlüssel (blipit_pk_) für Browser-Code und der geheime Schlüssel (blipit_sk_) für Server und Odoo.
Ein neuer geheimer Schlüssel wird einmal angezeigt. Kopieren Sie ihn sofort: Er wird gehasht gespeichert und kann nicht erneut angezeigt werden.
Ein neuer geheimer Schlüssel wird einmal angezeigt. Kopieren Sie ihn sofort: Er wird gehasht gespeichert und kann nicht erneut angezeigt werden.

4Den Schlüssel in der Umgebung ablegen

Dieses SDK sendet mit dem öffentlichen Schlüssel und der Projekt-ID. Lesen Sie sie aus Umgebungsvariablen oder in Spring Boot aus application.properties, das aus der Umgebung befüllt wird.

application.properties
blipit.key=${BLIPIT_KEY}
blipit.project=${BLIPIT_PROJECT}
java
Blipit.init(BlipitOptions.builder()
    .key(System.getenv("BLIPIT_KEY"))
    .project(Long.parseLong(System.getenv("BLIPIT_PROJECT")))
    .build());

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.

.gitignore
.env
.env.local
.env.*.local

6Manuelles 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.

java
Blipit.captureException(err);
Blipit.captureMessage("cache miss rate above 50%");
Blipit.captureMessage("disk almost full", Level.WARNING);
Blipit.setUser("42", "ana@example.com");
Blipit.addBreadcrumb("GET /api/cart 500", "http", Level.ERROR);
Blipit.captureSecurity("login_failed", email, "bad_password", null, ip, userAgent, null);

7Prü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.

java
Blipit.captureMessage("Hello from Java");

Gut zu wissen

  • Kotlin verwendet dieselben Aufrufe.
  • Das Java-SDK misst Requests nicht selbst: Für die Pulse-Seite senden Sie Spans von einem beliebigen OpenTelemetry-Exporter an https://in.blipit.io/v1/traces mit dem Header X-Blipit-Key (JSON-Protokoll).
  • Upgrade von v0.1: Das Level-Enum ist io.blipit.Level, setUser(User) wird zu setUser(id, email) oder setUser(id, email, username), addBreadcrumb(Breadcrumb) wird zu addBreadcrumb(message, category, level), Blipit.dsn entfällt, captureException und captureMessage geben die Event-ID zurück, und flush meldet, ob alles zugestellt wurde.
  • 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.