README

Self-hosted monitoring and observability dashboard for Laravel applications. Track requests, queries, exceptions, jobs, and more — all within your own infrastructure.

Screenshots

Server Monitoring

Htop Monitor

Requirements

• PHP 8.2+
• Laravel 11.x or 12.x

Installation

Install the package via Composer:

composer require hashcrypttech/hashguardian

The service provider and facade are auto-discovered by Laravel. No manual registration is needed.

Run the install command to publish the config, migrations, and assets:

php artisan hashguardian:install

This will:

• Publish the config/hashguardian.php configuration file
• Publish the HashGuardianServiceProvider to app/Providers/
• Publish frontend assets to public/vendor/hashguardian/
• Run database migrations

Configuration

After installation, configure HashGuardian via config/hashguardian.php or environment variables:

HASHGUARDIAN_ENABLED=true
HASHGUARDIAN_PATH=hashguardian
HASHGUARDIAN_DB_CONNECTION=mysql
HASHGUARDIAN_PRUNE_HOURS=72

Authorization

By default, the HashGuardian dashboard is only accessible in the local environment. To configure access in production, define the viewHashGuardian gate in your App\Providers\HashGuardianServiceProvider:

use Hashcrypttech\HashGuardian\Facades\HashGuardian;

HashGuardian::auth(function ($request) {
    return in_array($request->user()?->email, [
        'admin@example.com',
    ]);
});

Dashboard

Access the monitoring dashboard at:

https://your-app.com/hashguardian

Watchers

HashGuardian includes 20 built-in watchers that can be individually enabled/disabled:

Custom Metrics

Track custom business metrics in your application:

use Hashcrypttech\HashGuardian\Facades\HashGuardian;

// Count events
HashGuardian::count('orders.placed');

// Record numeric metrics
HashGuardian::metric('payment.amount', 99.99);

// Time operations
HashGuardian::startTimer('api.call');
// ... your code ...
HashGuardian::stopTimer('api.call');

API Access

Enable the REST API for programmatic access:

HASHGUARDIAN_API_ENABLED=true

Create API tokens:

php artisan hashguardian:token create "My Token"

Artisan Commands

Scheduled Tasks

Add these to your routes/console.php or scheduler:

use Illuminate\Support\Facades\Schedule;

Schedule::command('hashguardian:prune')->daily();
Schedule::command('hashguardian:aggregate')->hourly();

Server Monitoring

Enable server resource monitoring (CPU, RAM, disk, network):

HASHGUARDIAN_SERVER_MONITORING=true

Run the monitor as a background process:

php artisan hashguardian:monitor

Publishing Assets

To update assets after a package update:

php artisan hashguardian:publish

Or use vendor:publish with tags:

php artisan vendor:publish --tag=hashguardian-config
php artisan vendor:publish --tag=hashguardian-assets
php artisan vendor:publish --tag=hashguardian-provider

About

HashGuardian is developed and maintained by Hashcrypt Technologies Pvt. Ltd., a software development company based in Rajkot, Gujarat, India.

• Website: https://hashcrypt.com
• Email: contact@hashcrypt.com
• Phone: +91 90332 72899
• Address: 3rd Floor, United Square, Nana Mava Rd, Karan Park, Rajkot, Gujarat 360001

License

HashGuardian is open-sourced software licensed under the MIT license.