Java en Kotlin

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

De bibliotheek blipit-java wordt door JitPack rechtstreeks vanaf GitHub geleverd. Ze draait op Blipit's eigen kern, heeft geen dependencies en werkt op Java 8 of nieuwer. Voeg de repository en de dependency toe en roep Blipit.init één keer aan bij het opstarten met de publieke sleutel en het project-id van je project.

Plak hem in Claude Code, Cursor of een andere AI-codeerassistent. Hij bevat de stappen en de code. In app.blipit.io, onder API-sleutels, staat dezelfde prompt met je sleutel al ingevuld.
Video: Blipit installeren in elke stack, vanaf 1:07

1Voeg de repository en dependency toe

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>

2Initialiseer bij het opstarten

Spring Boot: bovenaan main, vóór SpringApplication.run, of in een @PostConstruct-methode van een @Configuration-klasse. Niet-afgevangen exceptions op elke thread worden naar een wachtrij op schijf geschreven voordat de app stopt en daarna verstuurd, dus een crash wordt gemeld, ook als het netwerk plat ligt; wat overblijft gaat mee bij de volgende start.

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());

3Haal je sleutels op

Log in op app.blipit.io en open API-sleutels in de zijbalk, en dan je project. Elk project heeft twee sleutels. De publieke sleutel begint met blipit_pk_: hij gaat in browser- en appcode, kan alleen events insturen en mag door iedereen gezien worden. De geheime sleutel begint met blipit_sk_: hij blijft op je server of in Odoo, nooit in een browser, omdat hij ook issues kan lezen en wijzigen. De geheime sleutel wordt maar één keer getoond, direct na het aanmaken, dus kopieer hem dan; raak je hem kwijt, druk dan op Nieuwe geheime sleutel aanmaken, en de oude werkt meteen niet meer. Sommige SDK's hebben ook het project-id nodig, dat op dezelfde pagina staat.

API-sleutels in app.blipit.io: de publieke sleutel (blipit_pk_) voor browsercode en de geheime sleutel (blipit_sk_) voor servers en Odoo.
API-sleutels in app.blipit.io: de publieke sleutel (blipit_pk_) voor browsercode en de geheime sleutel (blipit_sk_) voor servers en Odoo.
Een nieuwe geheime sleutel wordt één keer getoond. Kopieer hem nu: hij wordt gehasht opgeslagen en kan niet meer worden getoond.
Een nieuwe geheime sleutel wordt één keer getoond. Kopieer hem nu: hij wordt gehasht opgeslagen en kan niet meer worden getoond.

4Bewaar de sleutel in de omgeving

Deze SDK verstuurt met de publieke sleutel en het project-id. Lees ze uit omgevingsvariabelen, of in Spring Boot uit application.properties, gevuld vanuit de omgeving.

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());

5Houd sleutels buiten git

Bewaar sleutels in omgevingsvariabelen of in de geheime instellingen van je host, nooit in code die je commit, en zet je .env-bestanden in .gitignore. Een publieke sleutel in een webpagina is normaal. Belandt een geheime sleutel ooit in git, op een openbare pagina, in een screenshot of in een chat, open dan API-sleutels, druk op Nieuwe geheime sleutel aanmaken en plak de nieuwe sleutel overal waar de oude werd gebruikt: de oude sleutel werkt meteen niet meer.

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

6Handmatige capture en inlogpogingen

Inlogpogingen hebben de geheime sleutel nodig: initialiseer op de server met de geheime sleutel in plaats van de publieke, anders weigert de ingest ze met 403 security_needs_secret_key. Scale-abonnement.

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);

7Check of het werkt

Open Issues in app.blipit.io. Het eerste event verschijnt binnen een paar seconden, gegroepeerd in een issue, en de verantwoordelijken krijgen een e-mail.

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

Goed om te weten

  • Kotlin gebruikt dezelfde aanroepen.
  • De Java SDK timet requests niet zelf: stuur voor de pagina Pulse spans vanuit een willekeurige OpenTelemetry-exporter naar https://in.blipit.io/v1/traces met de header X-Blipit-Key (JSON-protocol).
  • Upgraden vanaf v0.1: de level-enum is io.blipit.Level, setUser(User) wordt setUser(id, email) of setUser(id, email, username), addBreadcrumb(Breadcrumb) wordt addBreadcrumb(message, category, level), Blipit.dsn is verdwenen, captureException en captureMessage geven het event-id terug, en flush geeft terug of alles is afgeleverd.
  • Blipit up-to-date houden: de gids Blipit up-to-date houden (docs.blipit.io/updates) legt de updatebanner uit, de e-mails voor belangrijke releases, de melding in je ontwikkelconsole en het updatecommando voor dit platform.
  • Eén project per app en platform: elk project kiest bij het aanmaken zijn platform (Android, iOS, React Native, Flutter, Web, Backend of Odoo), en Blipit weigert gegevens van elk ander platform met een duidelijke foutmelding. Een iOS-app en een Android-app hebben dus twee projecten met twee sleutels nodig. Releases, versies, crashpercentages en store-builds verschillen per platform, en door ze in één project te mengen klopt geen van die cijfers meer. Een Web-project neemt ook de serverkant van dezelfde web-app aan (de Next.js-server of Node), en een React Native- of Flutter-project ook zijn eigen native Android- en iOS-crashrapporten.

Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.