Fehler-Monitoring für Laravel.

Stand: 21.10.2026, sentry/sentry-laravel 4.29.0, Laravel 11 und neuer.

1. Paket installieren und DSN setzen

composer require sentry/sentry-laravel
php artisan sentry:publish --dsn=https://<key>@app.fehlo.de/<project-id>

sentry:publish legt config/sentry.php an und schreibt den DSN in deine .env. Für mehrere Umgebungen setzt du die Werte dort:

SENTRY_LARAVEL_DSN=https://<key>@app.fehlo.de/<project-id>
SENTRY_ENVIRONMENT=production
SENTRY_RELEASE=my-app@1.0.0

2. Exceptions an Fehlo melden

Seit Laravel 11 registrierst du das Paket in bootstrap/app.php:

<?php

use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;
use Sentry\Laravel\Integration;

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware) {
        //
    })
    ->withExceptions(function (Exceptions $exceptions) {
        Integration::handles($exceptions);
    })
    ->create();

3. Testen

php artisan sentry:test

Der Befehl schickt ein Testereignis an den eingestellten DSN. Oder du legst eine Route an, die eine Exception wirft:

Route::get('/debug-fehlo', function () {
    throw new Exception('Fehlo test error');
});

Datenschutz

Das Laravel-SDK sendet IP-Adressen und Nutzerdaten nur, wenn SENTRY_SEND_DEFAULT_PII auf true steht; Standard ist false. Lass es so, wenn du die Nutzer nicht brauchst. Für Argumente in Stacktraces empfiehlt Sentry zend.exception_ignore_args = Off in der php.ini. Damit landen auch Argumentwerte in den Ereignissen; Passwörter und Tokens filtert Fehlo serverseitig heraus.

Performance messen

SENTRY_TRACES_SAMPLE_RATE=0.2

Standard ist aus. Jede gemessene Anfrage ist eine Transaktion und zählt zum Transaktionskontingent deines Plans, nicht zu den Ereignissen.

Häufige Fragen