Laravel logt fouten standaard naar storage/logs. Prima tijdens het bouwen, maar in productie kijkt niemand daar. Met de Sentry SDK voor Laravel en errors.nl zie je elke fout direct, gegroepeerd en met de context erbij. Zo zet je het op.
1. Maak een project aan
Log in bij errors.nl, maak een organisatie en een project aan en kopieer de DSN. Die ziet eruit als https://<sleutel>@ingest.errors.nl/<project>.
2. Installeer de SDK
composer require sentry/sentry-laravel php artisan sentry:publish --dsn=https://<sleutel>@ingest.errors.nl/<project>
Het publish-commando maakt config/sentry.php aan en zet de DSN in je .env als SENTRY_LARAVEL_DSN.
3. Koppel de exception handler
In Laravel 11 en nieuwer doe je dat in bootstrap/app.php:
use Illuminate\Foundation\Configuration\Exceptions; use Sentry\Laravel\Integration; ->withExceptions(function (Exceptions $exceptions) { Integration::handles($exceptions); })
4. Test het
php artisan sentry:test
Binnen een paar seconden staat er een testfout onder Issues in het dashboard.
5. Releases en omgevingen
Geef bij elke deploy de versie mee, dan zie je bij welke release een fout begon, en zie je meteen als een opgeloste fout terugkomt:
[email protected] SENTRY_ENVIRONMENT=production
Zet foutmonitoring voor je lokale omgeving uit door SENTRY_LARAVEL_DSN daar leeg te laten.
6. Houd persoonsgegevens buiten de deur
In config/sentry.php staat send_default_pii standaard op false: dan stuurt de SDK geen IP-adressen, cookies of gebruikersgegevens mee. Laat dat zo, tenzij je ze echt nodig hebt. errors.nl filtert daarnaast wachtwoorden, tokens, e-mailadressen en rekeningnummers uit elke fout. Meer daarover lees je in Foutmonitoring en de AVG.
Meldingen
Wil je weten wanneer er iets misgaat zonder het dashboard open te hebben? Zet bij je project een melding per e-mail aan, of koppel Slack, Teams, Discord of ntfy voor pushmeldingen op je telefoon.