Installeren per platform
PHP en Laravel
Installeren composer require blipit/blipit
Installeer het package blipit/blipit (0.3.0 of nieuwer) en roep init één keer aan met de publieke sleutel van je project. Het draait op Blipit's eigen kern en haalt geen ander package binnen. Niet-afgevangen exceptions, waarschuwingen en fatale fouten worden vanzelf gemeld, en Laravel en Symfony zijn ingebouwd.
1Installeren
composer require blipit/blipit2Initialiseer bij het opstarten
Gewone PHP: bovenaan je front controller, voordat er een request wordt afgehandeld. Laravel start Blipit vanuit zijn config, zoals in de volgende stap. De sleutel staat op de pagina Sleutels van het project. Met een lege sleutel schrijft init een waarschuwing naar de error log en geeft false terug in plaats van een exception te gooien.
use Blipit\Blipit;
Blipit::init([
"key" => "<public key>",
"environment" => "production",
"release" => "myapp@1.4.2",
]);3Haal je sleutels op
Log in op app.blipit.io en open API-sleutels in de zijbalk, en dan je project. Elk project heeft twee sleutels. De publieke sleutel begint met blipit_pk_: hij gaat in browser- en appcode, kan alleen events insturen en mag door iedereen gezien worden. De geheime sleutel begint met blipit_sk_: hij blijft op je server of in Odoo, nooit in een browser, omdat hij ook issues kan lezen en wijzigen. De geheime sleutel wordt maar één keer getoond, direct na het aanmaken, dus kopieer hem dan; raak je hem kwijt, druk dan op Nieuwe geheime sleutel aanmaken, en de oude werkt meteen niet meer. Sommige SDK's hebben ook het project-id nodig, dat op dezelfde pagina staat.
4Bewaar de sleutel in de omgeving
Deze SDK verstuurt met de publieke sleutel. Laravel: zet hem in .env en in config/services.php; de Blipit-service provider wordt vanzelf gevonden en start Blipit vanuit die config, dus verder is niets nodig. Lees waarden via config, want env() geeft niets terug in app-code zodra de config gecachet is. Gewone PHP: lees de sleutel met getenv() uit de omgeving van de server.
BLIPIT_KEY=blipit_pk_your_public_key'blipit' => [
'key' => env('BLIPIT_KEY'),
'environment' => env('APP_ENV'),
'release' => env('GIT_SHA'),
],5Houd sleutels buiten git
Bewaar sleutels in omgevingsvariabelen of in de geheime instellingen van je host, nooit in code die je commit, en zet je .env-bestanden in .gitignore. Een publieke sleutel in een webpagina is normaal. Belandt een geheime sleutel ooit in git, op een openbare pagina, in een screenshot of in een chat, open dan API-sleutels, druk op Nieuwe geheime sleutel aanmaken en plak de nieuwe sleutel overal waar de oude werd gebruikt: de oude sleutel werkt meteen niet meer.
.env
.env.local
.env.*.local6Laravel en Symfony
Laravel: elke exception die de handler meldt, komt bij Blipit aan, dus 404's en validatiefouten blijven buiten. Queries, logregels en aanroepen van de HTTP-client worden breadcrumbs, en jobs in de wachtrij worden getraced. Een regel Blipit::captureException die je al in bootstrap/app.php hebt, kan blijven: dezelfde exception wordt nooit twee keer verstuurd. Symfony: registreer de listener in config/services.yaml en roep Blipit::init vroeg aan in public/index.php en bin/console.
Blipit\Symfony\BlipitListener:
arguments: ['@router']
tags:
- { name: kernel.event_listener, event: kernel.exception, method: onKernelException }
- { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }
- { name: kernel.event_listener, event: kernel.terminate, method: onKernelTerminate }
- { name: kernel.event_listener, event: console.error, method: onConsoleError }7Handmatige capture en inlogpogingen
Inlogpogingen hebben de geheime sleutel nodig: initialiseer op de server met de geheime sleutel in plaats van de publieke, anders weigert de ingest ze met 403 security_needs_secret_key. Scale-abonnement.
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());8Check of het werkt
Open Issues in app.blipit.io. Het eerste event verschijnt binnen een paar seconden, gegroepeerd in een issue, en de verantwoordelijken krijgen een e-mail.
Blipit::captureMessage("Hello from PHP");Goed om te weten
- Geef "traces_sample_rate" => 0.2 mee in init en requests verschijnen op de pagina Pulse. Blipit::trace("import orders", fn () => $importer->run()) meet de tijd van elk blok binnen een getracede request of job.
- Upgraden vanaf 0.2: project is niet meer nodig (het wordt nog geaccepteerd), Blipit::dsn() en Blipit::notice() zijn verdwenen, en before_send krijgt en geeft het event nu als array in het formaat van Blipit.
- Blipit up-to-date houden: de gids Blipit up-to-date houden (docs.blipit.io/updates) legt de updatebanner uit, de e-mails voor belangrijke releases, de melding in je ontwikkelconsole en het updatecommando voor dit platform.
- Eén project per app en platform: elk project kiest bij het aanmaken zijn platform (Android, iOS, React Native, Flutter, Web, Backend of Odoo), en Blipit weigert gegevens van elk ander platform met een duidelijke foutmelding. Een iOS-app en een Android-app hebben dus twee projecten met twee sleutels nodig. Releases, versies, crashpercentages en store-builds verschillen per platform, en door ze in één project te mengen klopt geen van die cijfers meer. Een Web-project neemt ook de serverkant van dezelfde web-app aan (de Next.js-server of Node), en een React Native- of Flutter-project ook zijn eigen native Android- en iOS-crashrapporten.
Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.

