PHPackages                             devifyo/watchtower - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. devifyo/watchtower

ActiveLibrary[Logging & Monitoring](/categories/logging)

devifyo/watchtower
==================

Production-safe, driver-agnostic dashboard for Laravel crons, queues and errors — that also lets you fix them.

v1.0.2(yesterday)23↑2900%MITPHPPHP ^8.2CI passing

Since Jun 18Pushed yesterdayCompare

[ Source](https://github.com/Devifyo/watchtower)[ Packagist](https://packagist.org/packages/devifyo/watchtower)[ RSS](/packages/devifyo-watchtower/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (9)Versions (4)Used By (0)

Watchtower
==========

[](#watchtower)

> One production-safe dashboard for everything happening in the background of your Laravel app — scheduled tasks, queues & jobs, and errors — that also lets you **fix them**. Works with **any** queue driver (database, Redis, SQS) and **any database setup** — single-database, multi-database, or multi-tenant. No Redis required.

 [![Watchtower — one dashboard for crons, queues and errors](art/hero.svg)](art/hero.svg)

 [![Packagist Version](https://camo.githubusercontent.com/cdf050f19c05eb2672215bd54f5fc4aa3120d7d074138b32934ccbe53ddc6bb8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6465766966796f2f7761746368746f7765723f7374796c653d666c61742d737175617265266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d776869746526636f6c6f723d346634366535)](https://packagist.org/packages/devifyo/watchtower) [![Total Downloads](https://camo.githubusercontent.com/b253bb4c31aaf104b4a53848e89aa34f43de77a2ea94f007a8d070ab07961f1b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6465766966796f2f7761746368746f7765723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/devifyo/watchtower/stats) [![Tests](https://camo.githubusercontent.com/565b594dfd311d932526dd4c56a0cf0732c606688f75ad55ef16def430bb6684/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f4465766966796f2f7761746368746f7765722f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265266c6f676f3d676974687562)](https://github.com/Devifyo/watchtower/actions) [![PHP](https://camo.githubusercontent.com/4db8a0aedbcf50312328e1c2254f5828ee845c7a8363e4f965d58d0a9bdb06f9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6465766966796f2f7761746368746f7765723f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d776869746526636f6c6f723d373737424234)](https://camo.githubusercontent.com/4db8a0aedbcf50312328e1c2254f5828ee845c7a8363e4f965d58d0a9bdb06f9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6465766966796f2f7761746368746f7765723f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d776869746526636f6c6f723d373737424234) [![Laravel](https://camo.githubusercontent.com/677cb05372f68bebd38391f4dc95d0cac4d8654698ff54beafa592ea8d9563da/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d31312e7825323025374325323031322e782d4646324432303f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/677cb05372f68bebd38391f4dc95d0cac4d8654698ff54beafa592ea8d9563da/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61726176656c2d31312e7825323025374325323031322e782d4646324432303f7374796c653d666c61742d737175617265266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465) [![License: MIT](https://camo.githubusercontent.com/ac049ef4e7a0b7196b09add6ac2d4f180e544c0ac779c2b2ac2fd2723a209579/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75653f7374796c653d666c61742d737175617265)](LICENSE)

 **[📦 View on Packagist](https://packagist.org/packages/devifyo/watchtower)**

---

🤔 Why Watchtower?
-----------------

[](#-why-watchtower)

Laravel already ships excellent observability tools — so why another one? Because most of them either can't be left on in production, are locked to a single queue driver, or only let you *look* at problems instead of *fixing* them. Watchtower is built to live in production permanently, work no matter how your queues are configured, and turn the dashboard into a control panel.

It also adapts to **any database layout**: keep its tables in your main database (**single-database**), isolate them on a dedicated connection (**multi-database**) via `WATCHTOWER_DB_CONNECTION`, or run it in a **multi-tenant** app by pointing it at a stable central connection so you get one dashboard across all tenants. See [Installation](#-installation-in-2-commands).

**Why not Telescope / Horizon / Pulse?**

CapabilityWatchtowerHorizonTelescopePulseProduction-safe (leave it on)✓✓✗✓Works without Redis / any driver✓✗ (Redis-only)✓✓Scheduled-task + missed-run monitoring✓✗✗✗Bulk failed-job retry (by type / time window)✓✓✗✗Built-in error tracker with resolve✓✗✗✗Single-DB, multi-DB & multi-tenant aware✓✗✗✗Compiled dashboard (no host frontend deps)✓✓✓✓> These tools are **complementary, not strictly competitors**. Horizon is unmatched for deep Redis queue throughput, Telescope is a fantastic local debugger, and Pulse gives you a great application health overview. Watchtower fills the gap in between: a single, always-on, driver-agnostic place to watch crons, queues and errors — and act on them.

---

✅ Requirements
--------------

[](#-requirements)

- **PHP** 8.2+
- **Laravel** 11.x or 12.x

---

📦 Installation in 2 commands
----------------------------

[](#-installation-in-2-commands)

```
composer require devifyo/watchtower
php artisan watchtower:install
```

`watchtower:install` publishes the config file, publishes the dashboard assets, and runs the migrations for you. The **compiled dashboard assets ship inside the package** (served straight from its `dist/` directory), so there is **no `npm install` or build step** in your host application.

**Zero-config first run:** once installed, just visit:

```
https://your-app.test/watchtower

```

Out of the box the dashboard is accessible in your **local** environment with no extra setup. (See [Security](#-security) before exposing it in production.)

> **First run / multi-tenant apps:** if the tables haven't been created on the connection Watchtower is using, the dashboard shows a **"Set up database"**screen with a one-click button to run its migrations. In a **multi-tenant**app whose default connection changes per request, point Watchtower at a stable central connection so its data lives in one place:
>
> ```
> WATCHTOWER_DB_CONNECTION=mysql   # your central/landlord connection name
> ```
>
>
>
> then `php artisan config:clear` and click the setup button (or `php artisan migrate`).

---

🚀 Usage
-------

[](#-usage)

Open `/watchtower` and you get a single-page dashboard with a summary bar across the top and three tabs:

- **📅 Schedule** — every scheduled task, its cron expression (in plain English), last run, duration, status, and whether an expected run was **missed**. Hit **Run now** to dispatch any task on demand without waiting for the next tick.
- **⚙️ Queues & Jobs** — live queue metrics plus the failed-jobs table. **Retry** a single failed job, **delete** it, or **bulk-retry** — including filtering by **exception type** or a **time window** so you can re-run only the jobs from that bad deploy.
- **🐛 Errors** — every captured exception, grouped and counted, with the full stack trace and request/job context. Mark an error **resolved** once you've shipped a fix, or **reopen** it if it comes back.

The **summary bar** keeps the headline numbers — recent failures, missed schedules, open errors — in view at all times, and the dashboard polls for fresh data automatically (interval is configurable).

---

🖼️ Screenshots
--------------

[](#️-screenshots)

*Previews below are illustrative; replace with real screenshots of your running dashboard at `/watchtower`.*

**📅 Schedule** — scheduled tasks with missed-run detection and run-now

[![Schedule tab](art/screenshot-schedule.svg)](art/screenshot-schedule.svg)

**⚙️ Queues & Jobs** — queue metrics and bulk failed-job retry

[![Queues tab](art/screenshot-queues.svg)](art/screenshot-queues.svg)

**🐛 Errors** — exception tracker with resolve / reopen

[![Errors tab](art/screenshot-errors.svg)](art/screenshot-errors.svg)

---

⚙️ Configuration
----------------

[](#️-configuration)

After installing, the config file lives at `config/watchtower.php`. Every option is environment-overridable.

KeyDescriptionDefaultEnv var`enabled`Master switch. When off, nothing is recorded (repository becomes a no-op) but the dashboard still renders historical data.`true``WATCHTOWER_ENABLED``path`URI prefix the dashboard + JSON API are served from.`watchtower``WATCHTOWER_PATH``domain`Optionally scope all routes to a subdomain.`null``WATCHTOWER_DOMAIN``middleware`Middleware stack every route runs through (the `Authorize` middleware is appended automatically).`['web']`—`connection`Dedicated DB connection for Watchtower's tables so its writes never contend with app traffic. `null` = default connection.`null``WATCHTOWER_DB_CONNECTION``table_prefix`Namespaces every table Watchtower creates.`watchtower_``WATCHTOWER_TABLE_PREFIX``recording.schedule`Record scheduled-task runs.`true``WATCHTOWER_RECORD_SCHEDULE``recording.queue`Record queue/job activity.`true``WATCHTOWER_RECORD_QUEUE``recording.exceptions`Record exceptions.`true``WATCHTOWER_RECORD_EXCEPTIONS``writes.after_response`Defer writes to the framework's `terminating()` callback so request/job latency is untouched. `false` writes inline.`true``WATCHTOWER_AFTER_RESPONSE``sampling.rate`Fraction of records stored (`1.0` = everything, `0.1` = ~10%). Failures and schedule runs are **always** recorded regardless.`1.0``WATCHTOWER_SAMPLING_RATE``retention.schedule`Days to keep schedule runs before `watchtower:prune` deletes them.`30``WATCHTOWER_RETAIN_SCHEDULE``retention.queue`Days to keep queue/job records.`7``WATCHTOWER_RETAIN_QUEUE``retention.exceptions`Days to keep exception records.`30``WATCHTOWER_RETAIN_EXCEPTIONS``limits.trace`Max bytes stored for a stack trace.`16384``WATCHTOWER_LIMIT_TRACE``limits.payload`Max bytes stored for a job payload.`8192``WATCHTOWER_LIMIT_PAYLOAD``limits.output`Max bytes stored for command/task output.`8192``WATCHTOWER_LIMIT_OUTPUT``limits.message`Max bytes stored for an exception message.`2048``WATCHTOWER_LIMIT_MESSAGE``limits.store_payload`Set to `false` to **never** persist job payloads (for apps with sensitive job data).`true``WATCHTOWER_STORE_PAYLOAD``ignore.jobs`Fully-qualified job class names to skip entirely.`[]`—`ignore.commands`Command signatures to skip entirely.`[]`—`ignore.exceptions`Fully-qualified exception class names to skip entirely.`[]`—`dashboard.polling_interval`Dashboard auto-refresh interval, in milliseconds.`5000``WATCHTOWER_POLL_INTERVAL``dashboard.per_page`Rows per page in the dashboard tables.`25``WATCHTOWER_PER_PAGE``alerts.enabled`Master switch for alert notifications (off by default).`false``WATCHTOWER_ALERTS_ENABLED``alerts.channels.slack`Slack incoming-webhook URL.`null``WATCHTOWER_SLACK_WEBHOOK``alerts.channels.webhook`Generic webhook URL to POST alerts to.`null``WATCHTOWER_WEBHOOK_URL``alerts.channels.mail`Comma-separated list of email recipients.`[]``WATCHTOWER_ALERT_MAIL``alerts.on.schedule_failed`Alert when a scheduled task fails.`true`—`alerts.on.schedule_missed`Alert when an expected scheduled run is missed.`true`—`alerts.on.failed_jobs_threshold`Alert when failed jobs cross the threshold.`true`—`alerts.failed_jobs.threshold`Number of failed jobs that triggers an alert.`25``WATCHTOWER_FAILED_THRESHOLD``alerts.failed_jobs.window_minutes`Time window the threshold is measured over.`60``WATCHTOWER_FAILED_WINDOW`---

🛡️ Production safety
--------------------

[](#️-production-safety)

Watchtower is designed to be **left on in production**. Here's how it stays out of your hot path and keeps your database bounded:

- **After-response / deferred writes** — with `writes.after_response` (default `true`), metrics are written in the framework's `terminating()` callback, so request and job latency are untouched.
- **Sampling** — set `sampling.rate` below `1.0` to store only a fraction of records on high-traffic apps. Failures and schedule runs are **always** recorded, so you never miss the things that matter.
- **Truncation** — every stored field is capped via `limits.*` (trace, payload, output, message) to bound row size.
- **Separate connection** — point `connection` at a dedicated database so Watchtower's writes never contend with your application's traffic.
- **Bounded retention + pruning** — old records are deleted per `retention.*`. Schedule the prune command to run daily:

    ```
    // routes/console.php (Laravel 11/12) or app/Console/Kernel.php
    $schedule->command('watchtower:prune')->daily();
    ```
- **Global kill switch** — set `WATCHTOWER_ENABLED=false` to stop all recording instantly. The dashboard still renders historical data.
- **Ignore lists** — silence noisy or expected items with `ignore.jobs`, `ignore.commands`, and `ignore.exceptions`.
- **Redact sensitive payloads** — set `limits.store_payload=false` to never persist job payloads at all.

---

🔒 Security
----------

[](#-security)

The dashboard **and** the JSON API run behind the middleware stack you configure (default `['web']`) **plus** an `Authorize` middleware that checks a `viewWatchtower` gate. The gate defaults to allowing **only the local environment** — the same pattern Horizon and Telescope use — so the dashboard is **never accidentally public** in production.

To grant access in production, define the gate in a service provider (e.g. `app/Providers/AppServiceProvider.php`):

```
use Illuminate\Support\Facades\Gate;

public function boot(): void
{
    Gate::define('viewWatchtower', function ($user) {
        return $user !== null && $user->isAdmin();
    });
}
```

Or use the fluent `Watchtower::auth()` callback, which takes precedence over the gate:

```
use Watchtower\Watchtower;

public function boot(): void
{
    Watchtower::auth(fn ($request) => $request->user()?->isAdmin());
}
```

Either way, any request that fails authorization gets a `403` — there is no path to the dashboard or API without passing the gate.

---

🔔 Alerts (optional)
-------------------

[](#-alerts-optional)

Alerts are **off by default**. When enabled, Watchtower sends notifications when something needs your attention. They're implemented as standard **Laravel notifications**, so they slot into your existing setup.

**Channels** (each independent — configure any combination):

- **Slack** — incoming-webhook URL via `WATCHTOWER_SLACK_WEBHOOK`
- **Generic webhook** — POST alerts anywhere via `WATCHTOWER_WEBHOOK_URL`
- **Mail** — comma-separated recipients via `WATCHTOWER_ALERT_MAIL`

**Triggers:**

- A **scheduled task fails** (`alerts.on.schedule_failed`)
- A scheduled run is **missed** (`alerts.on.schedule_missed`)
- **Failed jobs cross a threshold** (`alerts.on.failed_jobs_threshold`) — default 25 failures within a 60-minute window, tunable via `WATCHTOWER_FAILED_THRESHOLD` and `WATCHTOWER_FAILED_WINDOW`

Enable alerts and run the monitor on a schedule:

```
WATCHTOWER_ALERTS_ENABLED=true
WATCHTOWER_SLACK_WEBHOOK=https://hooks.slack.com/services/XXX/YYY/ZZZ
```

```
$schedule->command('watchtower:monitor')->everyFiveMinutes();
```

---

🛠️ Artisan commands
-------------------

[](#️-artisan-commands)

CommandDescription`watchtower:install`Publish config & assets and run migrations. `--force` overwrites existing published files.`watchtower:prune`Delete records older than the configured retention windows. `--hours=` overrides every retention window with the given number of hours.`watchtower:monitor`Evaluate alert conditions and dispatch notifications. Schedule it (e.g. every five minutes).---

🧪 Testing
---------

[](#-testing)

```
composer test
```

The suite runs on **Pest** with **Orchestra Testbench**.

---

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please open an issue to discuss substantial changes first, then send a PR. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Bug reports, docs improvements, and pull requests are all appreciated.

---

📄 License
---------

[](#-license)

Watchtower is open-source software licensed under the [MIT license](LICENSE).

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance100

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

1d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/76768816?v=4)[ByteAlchemy ](/maintainers/devifyo)[@Devifyo](https://github.com/Devifyo)

---

Top Contributors

[![Devifyo](https://avatars.githubusercontent.com/u/76768816?v=4)](https://github.com/Devifyo "Devifyo (6 commits)")

---

Tags

schedulerlaravelmonitoringexceptionsqueuedashboardhorizontelescope

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/devifyo-watchtower/health.svg)

```
[![Health](https://phpackages.com/badges/devifyo-watchtower/health.svg)](https://phpackages.com/packages/devifyo-watchtower)
```

###  Alternatives

[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.1k91.3M279](/packages/laravel-horizon)[spatie/laravel-health

Monitor the health of a Laravel application

87411.3M152](/packages/spatie-laravel-health)[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k14.1M121](/packages/laravel-pulse)[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k51.0M7.5k](/packages/larastan-larastan)[laravel/ai

The official AI SDK for Laravel.

9782.1M157](/packages/laravel-ai)[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)