Java et Kotlin

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

La bibliothèque blipit-java est servie par JitPack directement depuis GitHub. Elle fonctionne sur le cœur de Blipit, n'a aucune dépendance et marche sur Java 8 ou plus récent. Ajoutez le dépôt et la dépendance, puis appelez Blipit.init une fois au démarrage avec la clé publique et l'identifiant de votre projet.

Collez-le dans Claude Code, Cursor ou tout autre assistant de code IA. Il contient les étapes et le code. Dans app.blipit.io, sous Clés API, le même prompt est fourni avec votre clé déjà renseignée.
Vidéo : installer Blipit dans n'importe quel stack, à partir de 1:07

1Ajouter le dépôt et la dépendance

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>

2Initialiser au démarrage

Spring Boot : en haut de main, avant SpringApplication.run, ou dans une méthode @PostConstruct d'une classe @Configuration. Les exceptions non interceptées sur n'importe quel thread sont écrites dans une file sur disque avant l'arrêt de l'application, puis envoyées, donc un crash est signalé même si le réseau est coupé ; ce qui reste part au démarrage suivant.

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

3Obtenir vos clés

Connectez-vous sur app.blipit.io et ouvrez Clés API dans la barre latérale, puis votre projet. Chaque projet a deux clés. La clé publique commence par blipit_pk_ : elle va dans le code navigateur et applicatif, ne peut qu'envoyer des événements et peut être vue par n'importe qui sans risque. La clé secrète commence par blipit_sk_ : elle reste sur votre serveur ou dans Odoo, jamais dans un navigateur, car elle peut aussi lire et modifier les problèmes. La clé secrète n'est affichée qu'une fois, juste après sa création, alors copiez-la à ce moment-là ; si vous la perdez, appuyez sur Créer une nouvelle clé secrète, et l'ancienne cesse aussitôt de fonctionner. Certains SDK ont aussi besoin de l'identifiant de projet, affiché sur la même page.

Clés API dans app.blipit.io : la clé publique (blipit_pk_) pour le code navigateur et la clé secrète (blipit_sk_) pour les serveurs et Odoo.
Clés API dans app.blipit.io : la clé publique (blipit_pk_) pour le code navigateur et la clé secrète (blipit_sk_) pour les serveurs et Odoo.
Une nouvelle clé secrète n'est affichée qu'une fois. Copiez-la maintenant : elle est stockée sous forme de hash et ne peut plus être affichée.
Une nouvelle clé secrète n'est affichée qu'une fois. Copiez-la maintenant : elle est stockée sous forme de hash et ne peut plus être affichée.

4Gardez la clé dans l'environnement

Ce SDK envoie avec la clé publique et l'identifiant de projet. Lisez-les depuis des variables d'environnement, ou, avec Spring Boot, depuis application.properties alimenté par l'environnement.

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

5Gardez les clés hors de git

Gardez les clés dans des variables d'environnement ou dans les réglages de secrets de votre hébergeur, jamais dans du code que vous committez, et ajoutez vos fichiers .env à .gitignore. Une clé publique dans une page web est normale. Si une clé secrète se retrouve un jour dans git, sur une page publique, dans une capture d'écran ou dans un chat, ouvrez Clés API, appuyez sur Créer une nouvelle clé secrète, et collez la nouvelle clé partout où l'ancienne était utilisée : l'ancienne clé cesse immédiatement de fonctionner.

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

6Capture manuelle et tentatives de connexion

Les tentatives de connexion exigent la clé secrète : sur le serveur, initialisez avec la clé secrète au lieu de la clé publique, sinon l'ingestion les refuse avec 403 security_needs_secret_key. Offre Scale.

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

7Vérifier que ça fonctionne

Ouvrez Problèmes dans app.blipit.io. Le premier événement apparaît en quelques secondes, regroupé en un problème, et les responsables reçoivent un e-mail.

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

Bon à savoir

  • Kotlin utilise les mêmes appels.
  • Le SDK Java ne chronomètre pas les requêtes de lui-même : pour la page Pulse, envoyez des spans depuis n'importe quel exporteur OpenTelemetry vers https://in.blipit.io/v1/traces avec l'en-tête X-Blipit-Key (protocole JSON).
  • Mise à jour depuis v0.1 : l'enum de niveau est io.blipit.Level, setUser(User) devient setUser(id, email) ou setUser(id, email, username), addBreadcrumb(Breadcrumb) devient addBreadcrumb(message, category, level), Blipit.dsn a disparu, captureException et captureMessage renvoient l'identifiant de l'événement, et flush indique si tout a été livré.
  • Garder Blipit à jour : le guide Garder Blipit à jour (docs.blipit.io/updates) explique la bannière de mise à jour, les e-mails pour les versions importantes, l'avis dans votre console de développement et la commande de mise à jour pour cette plateforme.
  • Un projet par application et par plateforme : chaque projet choisit sa plateforme à sa création (Android, iOS, React Native, Flutter, Web, Backend ou Odoo), et Blipit refuse avec une erreur claire les données de toute autre plateforme. Une app iOS et une app Android ont donc besoin de deux projets avec deux clés. Les releases, les versions, les taux de plantage et les builds des stores diffèrent selon la plateforme, et les mélanger dans un projet les rend tous faux. Un projet Web accepte aussi la partie serveur de la même app web (le serveur Next.js ou Node), et un projet React Native ou Flutter accepte aussi ses propres rapports de plantage natifs Android et iOS.

Bloqué ? Écrivez à support@blipit.io. Les clés et l'identifiant de chaque projet sont sous Clés API dans app.blipit.io.