按平台安装
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 密钥”,然后选择你的项目。每个项目有两个密钥。公钥以 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。网页中出现公钥是正常的。如果私密密钥曾出现在 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)介绍了更新横幅、重要版本的邮件、开发控制台中的提示以及此平台的更新命令。
- 每个应用每个平台一个项目:每个项目在创建时选择自己的平台(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 密钥”下。

