プラットフォーム別インストール
Python
インストール pip install blipit
blipit パッケージ(0.3.0 以降)をインストールし、プロジェクトの公開キーで init を一度呼び出します。Blipit 独自のコアで動作し、標準ライブラリ以外は何も必要ありません。未処理の例外は自動で報告され、Django、Flask、FastAPI、Starlette、Celery、logging、HTTP 呼び出し、SQLAlchemy は自動的に検出されます。
1インストール
pip install blipit2起動時に初期化
Django では settings.py の先頭に、Flask や FastAPI ではアプリを作成する前に置きます。キーはプロジェクトのキーのページにあります。キーが空の場合、init は例外を投げずに警告をログに出して False を返すため、キーがなくてもアプリの起動が止まることはありません。
import 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 も必要です。
4キーを環境変数に保管する
この SDK は、プロジェクトの「APIキー」ページにある公開キーで送信します。キーは環境変数に置いてください。ローカルではフレームワークまたは python-dotenv が読み込む .env ファイルに、本番ではホストの設定に置きます。シークレットキーはログイン試行を送信する場合にのみ使います。
BLIPIT_KEY=blipit_pk_your_public_keyimport os
import blipit
blipit.init(key=os.environ.get("BLIPIT_KEY"))5キーを git に含めない
キーは環境変数またはホスティング先のシークレット設定に保管し、コミットするコードには決して書かないでください。また、.env ファイルを .gitignore に追加してください。Web ページに公開キーがあるのは通常のことです。シークレットキーが git、公開ページ、スクリーンショット、チャットなどに漏れた場合は、「APIキー」を開いて「新しいシークレットキーを作成」を押し、古いキーを使っていた箇所すべてに新しいキーを貼り付けてください。古いキーは即座に無効になります。
.env
.env.local
.env.*.local6手動キャプチャとログイン試行
ログイン試行にはシークレットキーが必要です。サーバーでは公開キーではなくシークレットキーで初期化してください。そうしないと受信側が 403 security_needs_secret_key で拒否します。Scale プラン。
blipit.capture_exception(err)
blipit.capture_message("cache miss rate above 50%", level="warning")
blipit.set_user({"id": "42", "email": "ana@example.com"})
blipit.set_context("order", {"id": 1042, "total": 99.5})
blipit.capture_security("login_failed", actor=email, ip=request.META.get("REMOTE_ADDR"), outcome="bad_password")7動作確認
app.blipit.io で「イシュー」を開きます。数秒以内に最初のイベントがイシューにまとめられて表示され、担当者にメールが届きます。
blipit.capture_message("Hello from Python")知っておくと便利
- Odoo ではこれを使わず、代わりに Odoo Apps ストアから Blipit モジュールをインストールしてください。Odoo のリクエスト、ユーザー、会社を認識します。
- init に traces_sample_rate=0.2 を渡すと、リクエスト、Celery タスク、外部への HTTP 呼び出し、SQL クエリが Pulse ページに表示されます。
- 0.2 からのアップグレード:project= は不要になりました(引き続き受け付けます)。blipit.dsn() は削除され、before_send は Blipit 形式の dict としてイベントを受け取るようになりました。
- 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キー」にあります。

