# 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.

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

| What | What you see | Docs |
|---|---|---|
| Exceptions | **Issues**: grouped by class, file and line, with the request or job they happened in | [Issues](/docs/issues/) |
| Slow requests | **Requests**: duration and p95 per route, each request with its queries and logs | [Laravel](/docs/laravel/) |
| Queries | **Queries**: every query with its duration and the request or job that ran it | [Laravel](/docs/laravel/) |
| Jobs | **Jobs** and **Queued jobs**: attempts, failures and durations | [Laravel](/docs/laravel/) |
| Scheduled tasks | **Schedule health**: an alert when a task misses a run, fails or runs too long | [Schedule health](/docs/cron-health/) |
| Logs | **Logs** from the `lampwick` log channel, next to the request that wrote them | [Laravel](/docs/laravel/#install-the-package) |
| Uptime | **Uptime**: an alert after 2 failed checks in a row, and when it is up again | [Uptime](/docs/uptime/) |
| SSL and domain | Alerts 14, 7, 3 and 1 days before a certificate expires, and 30 to 1 days before the domain does | [SSL, domain & DNS](/docs/host-checks/) |
| Deploys | **Deploys**: record each deploy from CI, and every issue shows the deploy it was first seen in | [API](/docs/api/) |

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.

| Plan | Monthly | Events / month | History | Uptime monitors |
|---|---|---|---|---|
| Free | €0 | 500k | 3 days | 3, every 5 min |
| Pro | €29 | 5M | 14 days | 20, every minute |
| Team | €79 | 25M | 30 days | 100, every 30 s |
| Business | €199 | 100M | 60 days | 300, every 30 s |

Yearly billing gets 2 months free. Projects, seats and the rest: [pricing](/#pricing).

## Set it up

```bash
composer require lampwick/laravel
```

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

```dotenv
LAMPWICK_TOKEN=YOUR_PROJECT_TOKEN
```

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

```bash
php artisan lampwick:agent
```

```bash
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:

```text
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](/docs/agents/) lets your agent create a workspace and hand you a claim link.

## Next step

The [Laravel docs](/docs/laravel/) cover the production setup per host, every configuration variable and troubleshooting.