PHP と Laravel

インストール composer require blipit/blipit

blipit/blipit パッケージ(0.3.0 以降)をインストールし、プロジェクトの公開キーで init を一度呼び出します。Blipit 独自のコアで動作し、ほかのパッケージは一切取り込みません。捕捉されなかった例外、警告、致命的エラーは自動で報告され、Laravel と Symfony への対応も組み込まれています。

Claude Code、Cursor などのAIコーディングアシスタントに貼り付けてください。手順とコードが含まれています。app.blipit.io の「APIキー」では、キーが入力済みの同じプロンプトをコピーできます。
動画:どのスタックにも Blipit を導入(1:07 から)

1インストール

sh
composer require blipit/blipit

2起動時に初期化

素の PHP:リクエストを処理する前に、フロントコントローラーの先頭で呼び出します。Laravel では、次の手順のとおり設定から Blipit が起動します。キーはプロジェクトのキーのページにあります。キーが空の場合、init は例外を投げずにエラーログに警告を書き込み、false を返します。

php
use Blipit\Blipit;

Blipit::init([
    "key" => "<public key>",
    "environment" => "production",
    "release" => "myapp@1.4.2",
]);

3キーを取得

app.blipit.io にサインインし、サイドバーの「APIキー」を開いてプロジェクトを選びます。各プロジェクトには2つのキーがあります。公開キーは blipit_pk_ で始まり、ブラウザやアプリのコードに置くものです。イベントの送信しかできないため、誰に見られても安全です。シークレットキーは blipit_sk_ で始まり、サーバーまたは Odoo に置き、ブラウザには決して置きません。イシューの読み取りや変更もできるためです。シークレットキーは作成直後に一度だけ表示されるので、そのときにコピーしてください。紛失した場合は「新しいシークレットキーを作成」を押すと、古いキーは即座に無効になります。一部の SDK では、同じページに表示されるプロジェクト ID も必要です。

app.blipit.io の API キー:ブラウザコード用の公開キー(blipit_pk_)と、サーバーおよび Odoo 用のシークレットキー(blipit_sk_)。
app.blipit.io の API キー:ブラウザコード用の公開キー(blipit_pk_)と、サーバーおよび Odoo 用のシークレットキー(blipit_sk_)。
新しいシークレットキーは一度だけ表示されます。今すぐコピーしてください。ハッシュ化して保存されるため、再表示はできません。
新しいシークレットキーは一度だけ表示されます。今すぐコピーしてください。ハッシュ化して保存されるため、再表示はできません。

4キーを環境変数に保管する

この SDK は公開キーで送信します。Laravel:キーを .env と config/services.php に追加します。Blipit のサービスプロバイダーは自動で検出され、その設定から Blipit を起動するため、ほかに必要なものはありません。設定をキャッシュすると、アプリのコードで env() は何も返さなくなるため、値は config 経由で読み取ってください。素の PHP:サーバーの環境から getenv() でキーを読み取ります。

.env
BLIPIT_KEY=blipit_pk_your_public_key
config/services.php
'blipit' => [
    'key' => env('BLIPIT_KEY'),
    'environment' => env('APP_ENV'),
    'release' => env('GIT_SHA'),
],

5キーを git に含めない

キーは環境変数またはホスティング先のシークレット設定に保管し、コミットするコードには決して書かないでください。また、.env ファイルを .gitignore に追加してください。Web ページに公開キーがあるのは通常のことです。シークレットキーが git、公開ページ、スクリーンショット、チャットなどに漏れた場合は、「APIキー」を開いて「新しいシークレットキーを作成」を押し、古いキーを使っていた箇所すべてに新しいキーを貼り付けてください。古いキーは即座に無効になります。

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

6Laravel と Symfony

Laravel:例外ハンドラーが報告する例外はすべて Blipit に届くため、404 やバリデーションエラーは含まれません。クエリ、ログ行、HTTP クライアントの呼び出しはブレッドクラムになり、キューのジョブはトレースされます。bootstrap/app.php にすでにある Blipit::captureException の行は残しても構いません。同じ例外が二重に送信されることはありません。Symfony:config/services.yaml にリスナーを登録し、public/index.php と bin/console の早い段階で Blipit::init を呼び出します。

config/services.yaml
Blipit\Symfony\BlipitListener:
    arguments: ['@router']
    tags:
        - { name: kernel.event_listener, event: kernel.exception, method: onKernelException }
        - { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }
        - { name: kernel.event_listener, event: kernel.terminate, method: onKernelTerminate }
        - { name: kernel.event_listener, event: console.error, method: onConsoleError }

7手動キャプチャとログイン試行

ログイン試行にはシークレットキーが必要です。サーバーでは公開キーではなくシークレットキーで初期化してください。そうしないと受信側が 403 security_needs_secret_key で拒否します。Scale プラン。

php
Blipit::captureException($e);
Blipit::captureMessage("cache miss rate above 50%", "warning");
Blipit::setUser(["id" => "42", "email" => "ana@example.com"]);
Blipit::captureSecurity("login_failed", $email, "bad_password", null, $request->ip(), $request->userAgent());

8動作確認

app.blipit.io で「イシュー」を開きます。数秒以内に最初のイベントがイシューにまとめられて表示され、担当者にメールが届きます。

php
Blipit::captureMessage("Hello from PHP");

知っておくと便利

  • init に "traces_sample_rate" => 0.2 を渡すと、リクエストが Pulse ページに表示されます。Blipit::trace("import orders", fn () => $importer->run()) で、トレース中のリクエストやジョブ内の任意のブロックの所要時間を計測できます。
  • 0.2 からのアップグレード:project は不要になりました(引き続き受け付けます)。Blipit::dsn() と Blipit::notice() は削除され、before_send は Blipit 形式の配列としてイベントを受け取り、返すようになりました。
  • 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キー」にあります。