PHPackages                             filaforge/filament-system-widget - 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. filaforge/filament-system-widget

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

filaforge/filament-system-widget
================================

Filament v4 dashboard widget for real-time system monitoring

v1.0.0(9mo ago)00MITBladePHP ^8.1

Since Aug 19Pushed 9mo agoCompare

[ Source](https://github.com/filaforge/filament-system-widget)[ Packagist](https://packagist.org/packages/filaforge/filament-system-widget)[ Docs](https://github.com/filaforge/system-widget)[ RSS](/packages/filaforge-filament-system-widget/feed)WikiDiscussions master Synced 1mo ago

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

Filaforge System Widget
=======================

[](#filaforge-system-widget)

A powerful Filament plugin that provides beautiful dashboard widgets for system monitoring and information display.

Features
--------

[](#features)

- **System Status Widget**: Real-time system health and status overview
- **Resource Usage Widget**: Live CPU, memory, and disk usage monitoring
- **Process List Widget**: Top processes by resource consumption
- **Service Status Widget**: System services health monitoring
- **Network Status Widget**: Network interface and connection status
- **Performance Metrics Widget**: System performance trends and analytics
- **Customizable Display**: Adjustable widget sizes and layouts
- **Auto-refresh**: Configurable refresh intervals for real-time data
- **Responsive Design**: Works seamlessly on all device sizes
- **Dark Mode Support**: Full compatibility with Filament's dark mode

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

[](#installation)

### 1. Install via Composer

[](#1-install-via-composer)

```
composer require filaforge/system-widget
```

### 2. Publish & Migrate

[](#2-publish--migrate)

```
# Publish provider groups (config, views, migrations)
php artisan vendor:publish --provider="Filaforge\\SystemWidget\\Providers\\SystemWidgetServiceProvider"

# Run migrations
php artisan migrate
```

### 3. Register Plugin

[](#3-register-plugin)

Add the plugin to your Filament panel provider:

```
use Filament\Panel;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... other configuration
        ->plugin(\Filaforge\SystemWidget\SystemWidgetPlugin::make());
}
```

Setup
-----

[](#setup)

### Prerequisites

[](#prerequisites)

Before using this plugin, ensure your system meets these requirements:

- **Linux/Unix System**: Compatible operating system for system monitoring
- **System Permissions**: Appropriate permissions for system information access
- **Required Extensions**: PHP extensions for system monitoring
- **Storage**: Sufficient storage for widget data and caching

### Configuration

[](#configuration)

The plugin will automatically:

- Publish configuration files to `config/system-widget.php`
- Publish view files to `resources/views/vendor/system-widget/`
- Publish migration files to `database/migrations/`
- Register necessary routes and middleware

### Widget Configuration

[](#widget-configuration)

Configure the system widgets in the published config file:

```
// config/system-widget.php
return [
    'enabled' => env('SYSTEM_WIDGET_ENABLED', true),
    'widgets' => [
        'system_status' => [
            'enabled' => true,
            'refresh_interval' => 30,
            'show_uptime' => true,
            'show_load_average' => true,
            'show_system_info' => true,
        ],
        'resource_usage' => [
            'enabled' => true,
            'refresh_interval' => 15,
            'show_cpu' => true,
            'show_memory' => true,
            'show_disk' => true,
            'show_network' => true,
        ],
        'process_list' => [
            'enabled' => true,
            'refresh_interval' => 60,
            'max_processes' => 10,
            'show_pid' => true,
            'show_user' => true,
            'show_command' => true,
        ],
        'service_status' => [
            'enabled' => true,
            'refresh_interval' => 120,
            'monitored_services' => [
                'nginx', 'apache2', 'mysql', 'redis', 'php-fpm'
            ],
            'show_status' => true,
            'show_uptime' => true,
        ],
    ],
    'display_settings' => [
        'widget_height' => env('SYSTEM_WIDGET_HEIGHT', 'medium'),
        'show_charts' => env('SYSTEM_WIDGET_SHOW_CHARTS', true),
        'chart_type' => env('SYSTEM_WIDGET_CHART_TYPE', 'line'),
        'color_scheme' => env('SYSTEM_WIDGET_COLOR_SCHEME', 'auto'),
    ],
    'performance' => [
        'cache_enabled' => env('SYSTEM_WIDGET_CACHE_ENABLED', true),
        'cache_ttl' => env('SYSTEM_WIDGET_CACHE_TTL', 300),
        'max_data_points' => env('SYSTEM_WIDGET_MAX_DATA_POINTS', 100),
    ],
];
```

### Environment Variables

[](#environment-variables)

Add these to your `.env` file:

```
SYSTEM_WIDGET_ENABLED=true
SYSTEM_WIDGET_HEIGHT=medium
SYSTEM_WIDGET_SHOW_CHARTS=true
SYSTEM_WIDGET_CHART_TYPE=line
SYSTEM_WIDGET_COLOR_SCHEME=auto
SYSTEM_WIDGET_CACHE_ENABLED=true
SYSTEM_WIDGET_CACHE_TTL=300
SYSTEM_WIDGET_MAX_DATA_POINTS=100
```

Usage
-----

[](#usage)

### Accessing System Widgets

[](#accessing-system-widgets)

1. Navigate to your Filament admin panel
2. The system widgets will automatically appear on your dashboard
3. Configure and customize widgets through the configuration

### Available Widgets

[](#available-widgets)

#### System Status Widget

[](#system-status-widget)

- **System Overview**: OS details, kernel version, architecture
- **Uptime Display**: System uptime and last boot information
- **Load Average**: Current system load average
- **System Health**: Overall system health indicator

#### Resource Usage Widget

[](#resource-usage-widget)

- **CPU Usage**: Real-time CPU utilization with charts
- **Memory Usage**: Current memory usage and availability
- **Disk Usage**: Disk space usage and file system information
- **Network Usage**: Network interface statistics and throughput

#### Process List Widget

[](#process-list-widget)

- **Top Processes**: List of processes by resource usage
- **Process Details**: PID, user, command, and resource consumption
- **Process Management**: Quick process information and status
- **Resource Monitoring**: Monitor specific process resource usage

#### Service Status Widget

[](#service-status-widget)

- **Service Health**: Monitor system service status
- **Service Uptime**: Track service uptime and availability
- **Service Metrics**: Service performance and health indicators
- **Service Alerts**: Notifications for service issues

#### Network Status Widget

[](#network-status-widget)

- **Interface Status**: Network interface information and status
- **Connection Monitoring**: Active network connections
- **Traffic Statistics**: Network traffic and bandwidth usage
- **Network Health**: Network connectivity and performance

#### Performance Metrics Widget

[](#performance-metrics-widget)

- **Historical Data**: Performance trends over time
- **Performance Charts**: Visual representation of system metrics
- **Performance Analysis**: Analyze system performance patterns
- **Capacity Planning**: Use data for capacity planning

### Widget Customization

[](#widget-customization)

- **Size Adjustment**: Resize widgets to fit your dashboard layout
- **Refresh Intervals**: Configure how often widgets update
- **Display Options**: Choose what information to display
- **Color Schemes**: Customize widget appearance
- **Chart Types**: Select different chart visualization types

Troubleshooting
---------------

[](#troubleshooting)

### Common Issues

[](#common-issues)

- **Widgets not showing**: Check if widgets are enabled in configuration
- **Data not updating**: Verify refresh intervals and system permissions
- **Performance issues**: Check cache settings and data point limits
- **Permission errors**: Ensure proper system access permissions

### Debug Steps

[](#debug-steps)

1. Check the plugin configuration:

```
php artisan config:show system-widget
```

2. Verify routes are registered:

```
php artisan route:list | grep system-widget
```

3. Check system permissions:

```
# Verify the web server user has system access
whoami
groups
```

4. Test system monitoring:

```
# Test if basic system commands work
php artisan tinker
shell_exec('uptime');
shell_exec('free -h');
```

5. Clear caches:

```
php artisan optimize:clear
```

6. Check logs for errors:

```
tail -f storage/logs/laravel.log
```

### Widget-Specific Issues

[](#widget-specific-issues)

#### System Status Widget

[](#system-status-widget-1)

- **Uptime not showing**: Check system uptime command availability
- **Load average missing**: Verify load average command access
- **System info errors**: Check system information commands

#### Resource Usage Widget

[](#resource-usage-widget-1)

- **CPU data missing**: Verify CPU monitoring commands
- **Memory data errors**: Check memory monitoring utilities
- **Disk usage issues**: Verify disk space commands

#### Process List Widget

[](#process-list-widget-1)

- **Process list empty**: Check process listing permissions
- **High refresh impact**: Adjust refresh intervals for better performance
- **Data accuracy**: Verify process monitoring commands

Security Considerations
-----------------------

[](#security-considerations)

### Access Control

[](#access-control)

- **Role-based permissions**: Restrict widget access to authorized users only
- **System information**: Limit exposure of sensitive system information
- **User isolation**: Ensure users can only see appropriate system data
- **Audit logging**: Track widget access and usage

### Best Practices

[](#best-practices)

- Never expose system widgets to public users
- Regularly review and update access permissions
- Monitor widget performance and resource usage
- Implement proper user authentication and authorization
- Use HTTPS for secure access
- Regular security audits of widget access

### Data Privacy

[](#data-privacy)

- **System information**: Be careful with system details exposure
- **Performance data**: Consider data retention and privacy policies
- **User access**: Limit access to system monitoring data
- **Data encryption**: Consider encrypting sensitive system data

Performance Optimization
------------------------

[](#performance-optimization)

### System Requirements

[](#system-requirements)

- **CPU**: Minimal CPU overhead for widget operations
- **Memory**: Adequate RAM for widget data and caching
- **Storage**: Fast storage for widget data and charts
- **Network**: Stable network for real-time updates

### Optimization Tips

[](#optimization-tips)

- Enable caching for widget data
- Use appropriate refresh intervals
- Limit data points for historical charts
- Monitor widget performance impact
- Implement lazy loading for heavy widgets

### Caching Strategy

[](#caching-strategy)

- **Data caching**: Cache system information to reduce system calls
- **Chart caching**: Cache chart data for better performance
- **Widget caching**: Cache widget rendering for faster display
- **Cache invalidation**: Proper cache invalidation strategies

Uninstall
---------

[](#uninstall)

### 1. Remove Plugin Registration

[](#1-remove-plugin-registration)

Remove the plugin from your panel provider:

```
// remove ->plugin(\Filaforge\SystemWidget\SystemWidgetPlugin::make())
```

### 2. Roll Back Migrations (Optional)

[](#2-roll-back-migrations-optional)

```
php artisan migrate:rollback
# or roll back specific published files if needed
```

### 3. Remove Published Assets (Optional)

[](#3-remove-published-assets-optional)

```
rm -f config/system-widget.php
rm -rf resources/views/vendor/system-widget
```

### 4. Remove Package and Clear Caches

[](#4-remove-package-and-clear-caches)

```
composer remove filaforge/system-widget
php artisan optimize:clear
```

### 5. Clean Up Environment Variables

[](#5-clean-up-environment-variables)

Remove these from your `.env` file:

```
SYSTEM_WIDGET_ENABLED=true
SYSTEM_WIDGET_HEIGHT=medium
SYSTEM_WIDGET_SHOW_CHARTS=true
SYSTEM_WIDGET_CHART_TYPE=line
SYSTEM_WIDGET_COLOR_SCHEME=auto
SYSTEM_WIDGET_CACHE_ENABLED=true
SYSTEM_WIDGET_CACHE_TTL=300
SYSTEM_WIDGET_MAX_DATA_POINTS=100
```

### 6. Clean Up Widget Data

[](#6-clean-up-widget-data)

After uninstalling, consider:

- Removing stored widget data and charts
- Cleaning up any cached widget information
- Removing any custom widget configurations
- Updating dashboard layouts if needed

Support
-------

[](#support)

- **Documentation**: [GitHub Repository](https://github.com/filaforge/system-widget)
- **Issues**: [GitHub Issues](https://github.com/filaforge/system-widget/issues)
- **Discussions**: [GitHub Discussions](https://github.com/filaforge/system-widget/discussions)

Contributing
------------

[](#contributing)

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

License
-------

[](#license)

This plugin is open-sourced software licensed under the [MIT license](LICENSE).

---

**Made with ❤️ by the Filaforge Team**

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance58

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

272d ago

Major Versions

0.1.2 → v1.0.02025-08-19

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7ccd0e302c517e0c6bc2b4ef05008e5beb1621bf5a64b17b82cdceb19566389?d=identicon)[filaforge](/maintainers/filaforge)

---

Top Contributors

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

---

Tags

laravelplatformfilament

### Embed Badge

![Health badge](/badges/filaforge-filament-system-widget/health.svg)

```
[![Health](https://phpackages.com/badges/filaforge-filament-system-widget/health.svg)](https://phpackages.com/packages/filaforge-filament-system-widget)
```

###  Alternatives

[spatie/laravel-activitylog

A very simple activity logger to monitor the users of your website or application

5.8k45.4M309](/packages/spatie-laravel-activitylog)[spatie/laravel-health

Monitor the health of a Laravel application

86910.0M83](/packages/spatie-laravel-health)[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[keepsuit/laravel-opentelemetry

OpenTelemetry integration for laravel

142347.8k](/packages/keepsuit-laravel-opentelemetry)[dotswan/filament-laravel-pulse

82137.2k1](/packages/dotswan-filament-laravel-pulse)[tapp/filament-authentication-log

Filament authentication log plugin.

51143.5k3](/packages/tapp-filament-authentication-log)

PHPackages © 2026

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