Download the PHP package moe-mizrak/laravel-log-reader without Composer
On this page you can find all versions of the php package moe-mizrak/laravel-log-reader. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download moe-mizrak/laravel-log-reader
More information about moe-mizrak/laravel-log-reader
Files in moe-mizrak/laravel-log-reader
Package laravel-log-reader
Short Description Lightweight Laravel package for reading, searching, and filtering logs from both file and database sources.
License MIT
Homepage https://github.com/moe-mizrak/laravel-log-reader
Informations about the package laravel-log-reader
Laravel Log Reader
Lightweight Laravel package for searching and filtering logs from both file and database sources.
This package provides the core log reading functionality used by the Laravel MCP Log (MCP tool for Laravel log analysing with AI.).
Installation
You can install the package (that you created with this template) via composer:
You can publish and run the migrations with:
Usage
You can use the package to read, search, and filter logs from both file and database sources.
If your logs are stored in files (laravel.log), in the config file (laravel-log-reader.php) set the driver to file as:
And set the log file path as:
And also you can set a limit, chunk size as:
Service provider automatically resolves the correct log reader (FileLogReader) and you can use it as:
If your logs are stored in database (log_entries table), in the config file (laravel-log-reader.php) set the driver to db as:
Set the connection and table name as:
And set the database columns mapping and searchable columns as:
And also you can set a limit, chunk size as:
And you can use it as:
Note: You can chain the
search,filter, andchunkmethods in any order before callingexecute. Thesearchmethod performs a search on searchable fields (like message, context, etc.) based on the provided query (in config we havesearchable_columnsso that it can be customized).
TODO
- [ ] Add a
log_insightsmigration/table which will be a normalized, summarized, and searchable table.- It unifies different log mechanisms into a single canonical format, enabling faster lookups over large data.
- A background task should sync new log data periodically, basically everyday it summarizes the previous day's logs and inserts them into
log_insights.- Be aware that summarization may lose some details (e.g., exact errors or stack traces).
- [ ] Add support for cloud log readers (AWS CloudWatch, Azure Monitor, Google Cloud Logging).
- [ ] Add streaming responses, either as a parameter to search/filter methods or as a new method like
searchStreamusing cursors, yields, or$builder->lazy($chunkSize).- [ ] Use a cheap/free model to summarize large log files before search/filter (experimental approach).
- [ ] Refine
LOG_PATTERNinFileLogReaderto handle more real-world log formats.- [ ] Move
user_id,request_id, andip_addressinto dedicated columns instead of using theextrafield.
Contributing
Your contributions are welcome! If you'd like to improve this project, simply create a pull request with your changes. Your efforts help enhance its functionality and documentation.
If you find this project useful, please consider ⭐ it to show your support!
Authors
This project is created and maintained by Moe Mizrak.
License
Laravel Package Template is an open-sourced software licensed under the MIT license.