Download the PHP package hamzi/corewatch without Composer

On this page you can find all versions of the php package hamzi/corewatch. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of hamzi/corewatch

Informations about the package corewatch

Laravel CoreWatch 🛡️

Embedded DevOps dashboard for Laravel — monitor, debug, and operate your server without leaving your app

Latest Stable Version Build Status Total Downloads License PHP Version

Quick Start · Why CoreWatch? · Developer API · Architecture · Filament · Troubleshooting

[!IMPORTANT] CoreWatch is a zero-dependency, self-contained server monitoring utility built for production Laravel systems. No Netdata, no Grafana agent, no external daemon — just composer require and you have a full DevOps terminal inside your admin panel.

🤔 Why CoreWatch?

Problem CoreWatch Solution
"I need server metrics but don't want another daemon" Reads /proc directly — zero external processes
"Log files are 5GB and crash my log viewer" O(1) memory backward-seeking parser streams any file size
"I'm afraid of RCE in admin panels" Whitelisted command keys only — no raw shell input
"I use Filament/Nova and need embedded monitoring" Livewire component + modular Blade partials
"I need alerts when CPU/RAM spikes" Scheduled sentinel with Slack, Telegram, or custom events
"Load balancer needs a health endpoint" GET /corewatch/api/health returns 200/503

CoreWatch vs. Alternatives

Feature CoreWatch Netdata Laravel Telescope Grafana Agent
Zero external daemon ✅ ❌ ✅ ❌
Server metrics (CPU/RAM/Disk) ✅ ✅ ❌ ✅
Log file streaming ✅ ❌ ❌ ❌
Safe ops panel ✅ ❌ ❌ ❌
Laravel-native install ✅ ❌ ✅ ❌
Filament/Livewire embed ✅ ❌ ❌ ❌
Built-in alerting ✅ ✅ ❌ ✅

⚡ Quick Start (30 seconds)

Open /corewatch in your browser. That's it.

For production, add auth middleware in config/corewatch.php and schedule health checks:

🗺️ System Architecture Flowchart

The following diagram illustrates how CoreWatch isolates data collection, streams log buffers, routes controller requests, and schedules alerting triggers:

🏗️ Package Architecture (Clean Architecture)

CoreWatch follows layered architecture with clear separation of concerns:

Layer Responsibility Example
Contracts Define abstractions SystemMetricsCollectorInterface
Domain Pure business logic HealthThresholdEvaluator
Application Orchestrate use cases GetServerMetricsAction
Infrastructure External I/O LogFileRepository, CpuMetricsCollector
Http HTTP boundary DashboardController (thin)

🧱 Modular @include Partial Architecture

CoreWatch separates all diagnostics into elegant, self-contained monospace tables inside resources/views/partials/. This modular structure allows clients to easily publish views and include specific tables anywhere inside their custom dashboards:

Partial Blade View Path Diagnostic Target Layout Display Style Customization Purpose
partials.cpu CPU Cores & Load averages Monospace UNIX Table Monitor core load thresholds (1M, 5M, 15M)
partials.ram Physical Memory (RAM) Allocation Monospace Memory Table Track active, free, and cached allocation bytes
partials.disk Disk Storage Saturated Volumes Saturated Space Table Monitor root storage partition size limits
partials.processes Active CPU Top Linux Processes Live CLI System Table Identify high CPU usage processes (PID, User)
partials.database Database Engine & Schema size Monospace DB Status Table Track table counts and database file sizes
partials.app-checks Operational Application Integrity Status Indicator List Verify Cache, Queue, and Security modes
partials.specifications OS Kernel & Laravel specifications Static Specs Table Quick access to PHP, OS, and server version info
partials.services Whitelisted system task controls Command Action Table Safe execution of authorized terminal commands
partials.logs Live chunked stream terminal view Cyberpunk Log Console View and filter real-time logs with pagination

⚡ Key Highlights

  1. Stealthy & Dynamic UI: Self-contained Blade views styled with a premium Cyberpunk DevOps dark theme. Uses lightweight Tailwind CSS & AlpineJS for dynamic reactivity without bundler dependencies.
  2. Zero-overhead Log Viewer: An advanced, memory-efficient backward-seeking chunked file parser that streams Laravel/Nginx/Apache logs without memory exhaustion even on multi-gigabyte files.
  3. Advanced System Diagnostics: Native /proc filesystem parsing coupled with fast system command fallbacks to deliver instant CPU, RAM, Disk, and system uptime metrics.
  4. Pre-Whitelisted Services Controller: Safe administrative triggers (e.g. queue restart, redis flush, cache clearing) mapping to strict command keys preventing arbitrary RCE vulnerabilities.
  5. Top Active CPU Processes: Live sorted process statistics terminal displaying CPU load, RAM allocation, PID, user, and running commands on Linux hosts.
  6. Database Telemetry Widget: Direct schema capacity details, connection indicators, and tables count monitoring for MySQL, PostgreSQL, and SQLite database connection engines.
  7. App Integrity Checks: Automated operational verification for Cache drivers, Artisan Queue connections, Environment status, and Security debug mode states.
  8. Livewire Embed Support: Built-in dynamic Livewire component (livewire:corewatch-dashboard) for drag-and-drop embedding inside administrative panels like Filament and Laravel Nova.
  9. Continuous Sentinel Daemon: Scheduled console monitor (corewatch:check-health) that alerts your DevOps channels (Slack & Telegram) when resource thresholds are breached.
  10. Developer Facade API: CoreWatch::metrics(), CoreWatch::health(), and ThresholdBreached events for custom integrations.
  11. One-Command Install: php artisan corewatch:install publishes config and prints your production checklist.
  12. Health Probe Endpoint: GET /corewatch/api/health for uptime monitors, load balancers, and Kubernetes liveness probes.

🛠️ Installation & Setup

Production Install (Packagist)

Publish Views (Optional — for customization)

Local Development (Path Repository)

🔌 Flexible Dashboard Integration Options

CoreWatch is designed to fit seamlessly wherever your administration operations are managed:

[!TIP] Make sure to wrap any custom page elements that use these modular tables inside the parent AlpineJS data controller: <div x-data="corewatchDashboard()">...</div>.

Option A: Standalone Routed View

Once active, navigate directly to /corewatch to view the comprehensive Cyberpunk DevOps terminal.

Option B: Modular Table Includes

Publish the views and embed specific partial views inside your existing administrative panels:

Option C: Blade Custom Component Embeds

Embed the full dashboard seamlessly:

Option D: Livewire Drag-and-Drop

Embed the Livewire component in Filament dashboards or custom panels:

⚙️ Threshold Sentinel alerts Alerting

Enable real-time warnings on Slack or Telegram by configuring your host .env:

Register heartbeat and health checks in routes/console.php:

👨‍💻 Developer API (Programmatic Access)

CoreWatch exposes a Facade and Manager for use in your own code, jobs, and custom admin panels:

Health Endpoint (Uptime Monitors / K8s Probes)

Returns 200 when healthy, 503 when thresholds are breached. Configure in .env:

Prometheus (Grafana / Monitoring)

Arabic Localization

Publish translations: php artisan vendor:publish --tag=corewatch-lang

Custom Alert Channels (Events)

Hook into threshold breaches in your AppServiceProvider:

Guide Description
Architecture Layer diagram, data flow, and extension guide
Filament Integration Embed in Filament admin panels
Troubleshooting Common issues and fixes
Deployment Production checklist
Contributing Development workflow and coding standards
Security Vulnerability reporting policy

🔒 Security Practices & Fallbacks

  1. RCE Protection: CoreWatch never accepts raw input strings to execute shell commands. It maps requests to rigid keys registered in config/corewatch.php and blocks any unauthorized requests.
  2. Memory Safety: The Log Parser uses direct fseek backward seeking to stream logs in 64KB blocks, maintaining a strict $O(1)$ memory consumption profile regardless of log file size.
  3. Graceful Fallbacks: If commands like exec or proc_open are disabled in php.ini, the package falls back to parsing native /proc direct files and displays interactive notifications.

📄 License

The MIT License (MIT). Please see License File for more information.

All versions of corewatch with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2|^8.3|^8.4
laravel/framework Version ^11.0|^12.0|^13.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package hamzi/corewatch contains the following files

Loading the files please wait ...