プラットフォーム別インストール
Go
インストール go get github.com/blipit-io/blipit-go
blipit-go モジュール(v0.3.0 以降)を追加し、main でプロジェクトの公開キーとプロジェクト ID を使って Init を一度呼び出します。Blipit 独自のコアで動作し、Go の標準ライブラリだけを使います。最後のイベントを失わないよう、プロセスの終了前に Flush してください。
1インストール
go get github.com/blipit-io/blipit-go2main で初期化
Init が panic することはありません。キーまたはプロジェクト ID が空の場合はエラーを返し、Blipit はオフのままになります。終了せずに、そのエラーをログに出してください。
import (
"log"
"time"
"github.com/blipit-io/blipit-go"
)
func main() {
if err := blipit.Init(blipit.Options{
Key: "<public key>",
Project: "<project id>",
Environment: "production",
Release: "myapp@1.4.2",
}); err != nil {
log.Printf("blipit: %v", err)
}
defer blipit.Flush(2 * time.Second)
}3キーを取得
app.blipit.io にサインインし、サイドバーの「APIキー」を開いてプロジェクトを選びます。各プロジェクトには2つのキーがあります。公開キーは blipit_pk_ で始まり、ブラウザやアプリのコードに置くものです。イベントの送信しかできないため、誰に見られても安全です。シークレットキーは blipit_sk_ で始まり、サーバーまたは Odoo に置き、ブラウザには決して置きません。イシューの読み取りや変更もできるためです。シークレットキーは作成直後に一度だけ表示されるので、そのときにコピーしてください。紛失した場合は「新しいシークレットキーを作成」を押すと、古いキーは即座に無効になります。一部の SDK では、同じページに表示されるプロジェクト ID も必要です。
4キーを環境変数に保管する
この SDK は公開キーとプロジェクト ID で送信します。ホスティング先、systemd ユニット、または docker run -e で設定した環境変数から読み込みます。
blipit.Init(blipit.Options{
Key: os.Getenv("BLIPIT_KEY"),
Project: os.Getenv("BLIPIT_PROJECT"),
})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.SetUser(blipit.User{ID: "42", Email: "ana@example.com"})
blipit.CaptureSecurity(blipit.Security{Kind: "login_failed", Actor: email, IP: ip, UserAgent: agent, Outcome: "bad_password"})7panic と net/http
main や任意の goroutine の先頭で defer blipit.Recover() を使うと、panic をスタック付きで報告し、送信を済ませてから再び panic します。提供するハンドラーを blipit.Handler で包むと、panic をリクエスト付きで報告し、各リクエストを ServeMux のパターン名で Pulse 上で計測します。Gin、Echo、Fiber では、パッケージの README にある StartRequest、SetRoute、End を使います。
go func() {
defer blipit.Recover()
work()
}()
mux := http.NewServeMux()
mux.HandleFunc("GET /items/{id}", item)
http.ListenAndServe(":8080", blipit.Handler(mux))8動作確認
app.blipit.io で「イシュー」を開きます。数秒以内に最初のイベントがイシューにまとめられて表示され、担当者にメールが届きます。
blipit.CaptureMessage("Hello from Go")知っておくと便利
- Options に TracesSampleRate: 0.2 を指定すると、リクエストが Pulse ページに送られます。blipit.Trace(ctx, name, fn) はリクエスト内に計測ステップを追加します。
- v0.2 からのアップグレード:blipit.DSN は削除され、User、Breadcrumb、Level は Blipit 独自の型になりました(User には ID、Email、Username が、Breadcrumb には Category、Message、Level、Data、Timestamp が残ります)。
- 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キー」にあります。

