按平台安装
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-go2在 main 中初始化
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 密钥”,然后选择你的项目。每个项目有两个密钥。公钥以 blipit_pk_ 开头:它用于浏览器和应用代码,只能发送事件,任何人看到都没关系。私密密钥以 blipit_sk_ 开头:它留在你的服务器或 Odoo 中,切勿放进浏览器,因为它还可以读取和更改问题。私密密钥只在创建后显示一次,请当时就复制;如果丢失,请点击“创建新的密钥”,旧密钥会立即失效。部分 SDK 还需要项目 id,它显示在同一页面上。
4将密钥保存在环境变量中
此 SDK 使用公钥和项目 id 发送数据。从托管平台、systemd unit 或 docker run -e 设置的环境变量中读取它们。
blipit.Init(blipit.Options{
Key: os.Getenv("BLIPIT_KEY"),
Project: os.Getenv("BLIPIT_PROJECT"),
})5不要把密钥放进 git
请把密钥保存在环境变量或托管平台的密钥设置中,切勿写进你提交的代码,并把 .env 文件加入 .gitignore。网页中出现公钥是正常的。如果私密密钥曾出现在 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 包装你提供服务的 handler,即可上报带请求信息的 panic,并在 Pulse 上为每个请求计时,以其 ServeMux 模式命名。Gin、Echo 和 Fiber 使用 StartRequest、SetRoute 和 End,见包的 README。
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)介绍了更新横幅、重要版本的邮件、开发控制台中的提示以及此平台的更新命令。
- 每个应用每个平台一个项目:每个项目在创建时选择自己的平台(Android、iOS、React Native、Flutter、Web、Backend 或 Odoo),Blipit 会以明确的错误拒绝来自其他平台的数据,所以 iOS 应用和 Android 应用需要两个项目、两个密钥。各平台的发布、版本、崩溃率和商店构建都不同,混在一个项目里会让这些数据全部失真。Web 项目也接收同一 Web 应用的服务器端数据(Next.js 服务器或 Node),React Native 或 Flutter 项目也接收它自己的 Android 和 iOS 原生崩溃报告。
遇到问题?发邮件至 support@blipit.io。每个项目的密钥和项目 id 在 app.blipit.io 的“API 密钥”下。

