按平台安装
.NET
安装 dotnet add package Blipit
添加 Blipit 包(0.2.0 或更高版本),并在启动时用项目的公钥和项目 id 调用一次 Init。它运行在 Blipit 自有内核上。未处理的异常和无人等待的失败任务会自动上报,ASP.NET Core 也无需额外的包。
1安装
dotnet add package Blipit2启动时初始化
在进程的整个生命周期内保持返回的句柄存活。两个值都在项目的密钥页面上。
using Blipit;
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
Key = "<public key>",
Project = "<project id>",
Environment = "production",
Release = "myapp@1.4.2",
});3获取密钥
登录 app.blipit.io,打开侧边栏中的“API 密钥”,然后选择你的项目。每个项目有两个密钥。公钥以 blipit_pk_ 开头:它用于浏览器和应用代码,只能发送事件,任何人看到都没关系。私密密钥以 blipit_sk_ 开头:它留在你的服务器或 Odoo 中,切勿放进浏览器,因为它还可以读取和更改问题。私密密钥只在创建后显示一次,请当时就复制;如果丢失,请点击“创建新的密钥”,旧密钥会立即失效。部分 SDK 还需要项目 id,它显示在同一页面上。
4将密钥保存在配置中
此 SDK 使用公钥和项目 id 发送数据。开发时把它们保存在 user secrets 中,生产环境放在环境变量中(Blipit__Key 和 Blipit__Project),然后从配置中读取。
dotnet user-secrets set "Blipit:Key" "blipit_pk_your_public_key"
dotnet user-secrets set "Blipit:Project" "12"using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
Key = builder.Configuration["Blipit:Key"],
Project = builder.Configuration["Blipit:Project"],
});5不要把密钥放进 git
请把密钥保存在环境变量或托管平台的密钥设置中,切勿写进你提交的代码,并把 .env 文件加入 .gitignore。网页中出现公钥是正常的。如果私密密钥曾出现在 git、公开页面、截图或聊天中,请打开“API 密钥”,点击“创建新的密钥”,并在所有用过旧密钥的地方粘贴新密钥:旧密钥会立即失效。
.env
.env.local
.env.*.local6ASP.NET Core 与日志
无需添加其他内容:在 Program.cs 顶部调用 Init 即可。来自端点、控制器和中间件的异常会连同请求一起上报,即使由 UseExceptionHandler 处理也一样;设置 TracesSampleRate 后,每个被采样的请求都会按路由在 Pulse 上计时。BlipitLoggerProvider 会把 Information 及以上级别变为面包屑,Error 及以上级别变为事件。
var builder = WebApplication.CreateBuilder(args);
using var blipit = Blipit.Blipit.Init(new BlipitOptions
{
Key = builder.Configuration["Blipit:Key"],
Project = builder.Configuration["Blipit:Project"],
TracesSampleRate = 0.2,
});
builder.Logging.AddProvider(new BlipitLoggerProvider());7手动捕获和登录尝试
登录尝试需要私密密钥:请在服务器上使用私密密钥而不是公开密钥进行初始化,否则接收端会以 403 security_needs_secret_key 拒绝。Scale 套餐。
Blipit.Blipit.CaptureException(ex);
Blipit.Blipit.CaptureMessage("cache miss rate above 50%", BlipitLevel.Warning);
Blipit.Blipit.SetUser(id: "42", email: "ana@example.com");
Blipit.Blipit.CaptureSecurity("login_failed", email, "bad_password", null, ip, userAgent, null);8验证是否生效
打开 app.blipit.io 中的“问题”。首个事件几秒钟内就会出现,并归组为一个问题,负责人会收到邮件。
Blipit.Blipit.CaptureMessage("Hello from .NET");须知
- 目标框架为 netstandard2.0 和 net8.0。
- 在选项中设置 TracesSampleRate = 0.2,请求就会发送到 Pulse 页面;await Blipit.Blipit.Trace("charge card", () => gateway.ChargeAsync(order)) 可在请求内添加一个计时步骤。
- 从 0.1 升级:删除 0.1 所需的额外 ASP.NET Core 包和 builder.WebHost 那一行,因为 Init 已涵盖 ASP.NET Core。Blipit.Dsn、Blipit.Apply、BlipitOptions.Configure 和 PackageName 已移除,CaptureMessage 和 AddBreadcrumb 改用 BlipitLevel,各 capture 调用以字符串形式返回事件 id。
- 让 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 密钥”下。

