Monitor a Laravel app with Lampwick

The lampwick/laravel package sends requests, queries, jobs, exceptions, logs and scheduled tasks from Laravel 12 or 13 to Lampwick. Three commands to set up.

Updated View as Markdown

The lampwick/laravel package is Lampwick's own integration for Laravel. Your app hands its records to an ingest daemon on the same server, so requests never wait on the network.

What Lampwick monitors in a Laravel app

WhatWhat you seeDocs
ExceptionsIssues: grouped by class, file and line, with the request or job they happened inIssues
Slow requestsRequests: duration and p95 per route, each request with its queries and logsLaravel
QueriesQueries: every query with its duration and the request or job that ran itLaravel
JobsJobs and Queued jobs: attempts, failures and durationsLaravel
Scheduled tasksSchedule health: an alert when a task misses a run, fails or runs too longSchedule health
LogsLogs from the lampwick log channel, next to the request that wrote themLaravel
UptimeUptime: an alert after 2 failed checks in a row, and when it is up againUptime
SSL and domainAlerts 14, 7, 3 and 1 days before a certificate expires, and 30 to 1 days before the domain doesSSL, domain & DNS
DeploysDeploys: record each deploy from CI, and every issue shows the deploy it was first seen inAPI

Requirements: PHP 8.2 or later with the curl extension, Laravel 12 or 13.

What it costs

Per team, excluding VAT. Every plan has all of the above; they differ in volume and history.

PlanMonthlyEvents / monthHistoryUptime monitors
Free€0500k3 days3, every 5 min
Pro€295M14 days20, every minute
Team€7925M30 days100, every 30 s
Business€199100M60 days300, every 30 s

Yearly billing gets 2 months free. Projects, seats and the rest: pricing.

Set it up

Terminal
composer require lampwick/laravel

Add the project's ingest token, from the Connect your app card on the project's Settings page:

.env
LAMPWICK_TOKEN=YOUR_PROJECT_TOKEN

Start the ingest daemon, and check it from a second terminal:

Terminal
php artisan lampwick:agent
Terminal
php artisan lampwick:test

Open your app: the request shows up in Lampwick within seconds. In production, run lampwick:agent under Forge, Supervisor or a sidecar container, like a queue worker.

Let your agent do it

Paste this into Claude Code, Cursor or Codex, in your app's repository:

Add Lampwick monitoring to this Laravel app. Read https://lampwick.dev/docs/laravel.md and follow it: install lampwick/laravel, put LAMPWICK_TOKEN in .env (never in git or the chat), run php artisan lampwick:test, and set up php artisan lampwick:agent under the process manager this app uses in production.

No Lampwick account yet? The agent setup lets your agent create a workspace and hand you a claim link.

Next step

The Laravel docs cover the production setup per host, every configuration variable and troubleshooting.