プラットフォーム別インストール
Java と Kotlin
インストール com.github.blipit-io:blipit-java
blipit-java ライブラリは JitPack から GitHub 経由で直接配信されます。Blipit 独自のコアで動作し、依存関係はなく、Java 8 以降で動きます。リポジトリと依存関係を追加し、起動時にプロジェクトの公開キーとプロジェクト ID で Blipit.init を一度呼び出します。
1リポジトリと依存関係を追加
repositories {
mavenCentral()
maven("https://jitpack.io")
}
dependencies {
implementation("com.github.blipit-io:blipit-java:v0.2.2")
}<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>2起動時に初期化
Spring Boot:main の先頭(SpringApplication.run の前)、または @Configuration クラスの @PostConstruct メソッド内で呼び出します。どのスレッドで捕捉されなかった例外も、アプリが止まる前にディスク上のキューに書き込まれてから送信されるため、ネットワークが落ちていてもクラッシュは報告されます。残ったものは次回の起動時に送られます。
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());3キーを取得
app.blipit.io にサインインし、サイドバーの「APIキー」を開いてプロジェクトを選びます。各プロジェクトには2つのキーがあります。公開キーは blipit_pk_ で始まり、ブラウザやアプリのコードに置くものです。イベントの送信しかできないため、誰に見られても安全です。シークレットキーは blipit_sk_ で始まり、サーバーまたは Odoo に置き、ブラウザには決して置きません。イシューの読み取りや変更もできるためです。シークレットキーは作成直後に一度だけ表示されるので、そのときにコピーしてください。紛失した場合は「新しいシークレットキーを作成」を押すと、古いキーは即座に無効になります。一部の SDK では、同じページに表示されるプロジェクト ID も必要です。
4キーを環境変数に保管する
この SDK は公開キーとプロジェクト ID で送信します。環境変数から読み込むか、Spring Boot では環境変数から値を設定した application.properties から読み込みます。
blipit.key=${BLIPIT_KEY}
blipit.project=${BLIPIT_PROJECT}Blipit.init(BlipitOptions.builder()
.key(System.getenv("BLIPIT_KEY"))
.project(Long.parseLong(System.getenv("BLIPIT_PROJECT")))
.build());5キーを git に含めない
キーは環境変数またはホスティング先のシークレット設定に保管し、コミットするコードには決して書かないでください。また、.env ファイルを .gitignore に追加してください。Web ページに公開キーがあるのは通常のことです。シークレットキーが git、公開ページ、スクリーンショット、チャットなどに漏れた場合は、「APIキー」を開いて「新しいシークレットキーを作成」を押し、古いキーを使っていた箇所すべてに新しいキーを貼り付けてください。古いキーは即座に無効になります。
.env
.env.local
.env.*.local6手動キャプチャとログイン試行
ログイン試行にはシークレットキーが必要です。サーバーでは公開キーではなくシークレットキーで初期化してください。そうしないと受信側が 403 security_needs_secret_key で拒否します。Scale プラン。
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);7動作確認
app.blipit.io で「イシュー」を開きます。数秒以内に最初のイベントがイシューにまとめられて表示され、担当者にメールが届きます。
Blipit.captureMessage("Hello from Java");知っておくと便利
- Kotlin でも同じ呼び出しを使います。
- Java SDK はリクエストを自動では計測しません。Pulse ページを使うには、任意の OpenTelemetry エクスポーターから X-Blipit-Key ヘッダー付きで https://in.blipit.io/v1/traces にスパンを送信してください(JSON プロトコル)。
- v0.1 からのアップグレード:レベルの enum は io.blipit.Level になり、setUser(User) は setUser(id, email) または setUser(id, email, username) に、addBreadcrumb(Breadcrumb) は addBreadcrumb(message, category, level) になりました。Blipit.dsn は削除され、captureException と captureMessage はイベント ID を返し、flush はすべて配信されたかどうかを返します。
- Blipit を最新に保つ:「Blipit を最新に保つ」ガイド(docs.blipit.io/updates)で、更新バナー、重要なリリースのメール、開発コンソールのお知らせ、このプラットフォームの更新コマンドを説明しています。
- アプリとプラットフォームごとに 1 つのプロジェクト:各プロジェクトは作成時にプラットフォーム(Android、iOS、React Native、Flutter、Web、Backend、Odoo)を選び、Blipit はほかのプラットフォームからのデータをわかりやすいエラーで拒否します。そのため iOS アプリと Android アプリには、キーが別々の 2 つのプロジェクトが必要です。リリース、バージョン、クラッシュ率、ストア向けビルドはプラットフォームごとに異なり、1 つのプロジェクトに混ぜるとすべての数字が正しくなくなります。Web プロジェクトは同じ Web アプリのサーバー側(Next.js サーバーや Node)も受け付け、React Native と Flutter のプロジェクトは自身の Android と iOS のネイティブクラッシュレポートも受け付けます。
お困りですか?support@blipit.io までメールしてください。各プロジェクトのキーとプロジェクト ID は app.blipit.io の「APIキー」にあります。

