PHPackages                             tawfiq-alqaidy/logpilot-laravel - 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. tawfiq-alqaidy/logpilot-laravel

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

tawfiq-alqaidy/logpilot-laravel
===============================

Zero-configuration SDK that captures unhandled exceptions and logs them to LogPilot AI

v1.0.0(1mo ago)01MITPHPPHP ^8.1

Since Jun 16Pushed 1mo agoCompare

[ Source](https://github.com/Tawfiq-alqaidy/logpilot-laravel)[ Packagist](https://packagist.org/packages/tawfiq-alqaidy/logpilot-laravel)[ RSS](/packages/tawfiq-alqaidy-logpilot-laravel/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependencies (3)Versions (2)Used By (0)

LogPilot Laravel
================

[](#logpilot-laravel)

A lightweight, zero-configuration Laravel package that automatically captures unhandled exceptions and sends them to [LogPilot AI](https://github.com/Tawfiq-alqaidy/logpilot-laravel) via a FastAPI microservice.

No changes to `config/logging.php` or your exception handler are required — install the package, set your API URL, and you're done.

Requirements
------------

[](#requirements)

- PHP ^8.1
- Laravel 10 or 11

Installation
------------

[](#installation)

Install via Composer:

```
composer require tawfiq-alqaidy/logpilot-laravel
```

The service provider is auto-discovered. No manual registration is needed.

Configuration
-------------

[](#configuration)

### Environment variables

[](#environment-variables)

Add these to your `.env` file:

```
LOGPILOT_API_URL=http://localhost:8000/api/v1/logs
LOGPILOT_SERVICE_NAME="${APP_NAME}"
```

VariableDescriptionDefault`LOGPILOT_API_URL`LogPilot FastAPI ingest endpoint`http://localhost:8000/api/v1/logs``LOGPILOT_SERVICE_NAME`Identifier for this service in LogPilotValue of `APP_NAME`, or `laravel-app`### Publish config (optional)

[](#publish-config-optional)

To customize the config file directly:

```
php artisan vendor:publish --tag=logpilot-config
```

This publishes `config/logpilot.php` to your application.

How it works
------------

[](#how-it-works)

On boot, the package:

1. Registers a custom `logpilot` Monolog channel.
2. Appends `logpilot` to Laravel's default `stack` channel (when `LOG_CHANNEL=stack`, the Laravel default).

When Laravel's exception handler logs an unhandled exception to the stack, the `LogPilotHandler` intercepts it and sends a fire-and-forget HTTP POST to your LogPilot API:

```
{
  "service_name": "my-laravel-app",
  "error_type": "RuntimeException",
  "stack_trace": "..."
}
```

If LogPilot is unreachable or returns an error, the failure is silently ignored — your Laravel app is never affected.

Manual logging
--------------

[](#manual-logging)

You can also send logs directly to the LogPilot channel:

```
use Illuminate\Support\Facades\Log;

Log::channel('logpilot')->error('Something went wrong', [
    'exception' => $exception,
]);
```

When an `exception` is present in the log context, the handler extracts the exception class and stack trace automatically. Otherwise, the log message is used for both fields.

Architecture
------------

[](#architecture)

```
Exception Handler
       │
       ▼
  stack channel  ──►  logpilot channel  ──►  LogPilotHandler  ──►  POST /api/v1/logs

```

License
-------

[](#license)

MIT

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance90

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

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

Unknown

Total

1

Last Release

47d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4d892100ff85d51e677802656f86d3484c4b6faf36a3766a45492e3f714dae03?d=identicon)[Tawfiq-alqaidy](/maintainers/Tawfiq-alqaidy)

---

Top Contributors

[![Tawfiq-alqaidy](https://avatars.githubusercontent.com/u/120083003?v=4)](https://github.com/Tawfiq-alqaidy "Tawfiq-alqaidy (1 commits)")

### Embed Badge

![Health badge](/badges/tawfiq-alqaidy-logpilot-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/tawfiq-alqaidy-logpilot-laravel/health.svg)](https://phpackages.com/packages/tawfiq-alqaidy-logpilot-laravel)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.7M3.3k](/packages/craftcms-cms)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.4M352](/packages/psalm-plugin-laravel)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45844.8k1](/packages/pressbooks-pressbooks)[illuminate/log

The Illuminate Log package.

6225.7M672](/packages/illuminate-log)[illuminate/auth

The Illuminate Auth package.

9328.5M1.3k](/packages/illuminate-auth)[api-platform/laravel

API Platform support for Laravel

58174.6k18](/packages/api-platform-laravel)

PHPackages © 2026

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