Skip to main content
To monitor an application, install the laraowl/client package into it and point it at your LaraOwl server. Once connected, the app immediately begins streaming telemetry — requests, exceptions, queries, jobs, and more.
You need a running LaraOwl server and a project API token first. Create a project and copy its token from Project Settings → API Keys. See Getting started.

1. Install the client package

In the Laravel application you want to monitor:

2. Configure

Run the interactive setup command, which writes the required configuration for you:
Or add the values manually to the application’s .env:
The API token maps each application to one project. Use a separate token per application so their data stays isolated in its own project dashboard.

3. Optional: forward application logs

To ship the application’s logs into LaraOwl’s centralized log viewer, add the laraowl channel to your log stack:
That’s it. Your application will immediately begin sending telemetry data to the LaraOwl server.

Verify the connection

Generate some traffic by hitting a few routes, then open the project dashboard. Within seconds you should see requests, queries, and any exceptions appear in real time.
If nothing shows up, confirm the server’s queue worker and Reverb process are running, and that LARAOWL_SERVER_URL is reachable from the monitored app. See Troubleshooting.

What happens next

The client sends captured data to the server’s /api/ingest endpoint over authenticated HTTP. The server queues it instantly and processes it in the background — so monitoring adds negligible overhead to your application. See Architecture for the full data flow.