按平台安装

PHP 和 Laravel

安装 composer require blipit/blipit

安装 blipit/blipit 包，并用项目的公钥和项目 id 调用一次 init。未捕获的异常和错误会自动上报。

1安装

sh
composer require blipit/blipit

2启动时初始化

纯 PHP：放在前端控制器顶部。Laravel：放在 AppServiceProvider::boot 中。两个值都在项目的密钥页面上。

php
use Blipit\Blipit;

Blipit::init([
    "key" => "<public key>",
    "project" => <project id>,
    "environment" => "production",
    "release" => "myapp@1.4.2",
]);

3手动捕获和登录尝试

php
Blipit::captureException($e);
Blipit::captureMessage("cache miss rate above 50%", "warning");
Blipit::setUser(["id" => "42", "email" => "ana@example.com"]);
Blipit::captureSecurity("login_failed", $email, "bad_password", null, $request->ip(), $request->userAgent());

4验证是否生效

打开 app.blipit.io 中的“问题”。首个事件几秒钟内就会出现，并归组为一个问题，负责人会收到邮件。

php
Blipit::captureMessage("Hello from PHP");

须知

  • Laravel 的完整集成（请求上下文、队列任务、Artisan）来自 sentry/sentry-laravel 包；设置 SENTRY_LARAVEL_DSN=https://<public key>@in.blipit.io/<project id> 后无需更改即可使用。
  • 在 init 中传入 "traces_sample_rate" => 0.2，请求就会显示在性能页面。

遇到问题？发邮件至 support@blipit.io。每个项目的密钥和确切的 DSN 在 app.blipit.io 的“API 密钥”下。