PHPackages mage-stack/module-logstash-wrapper - 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. mage-stack/module-logstash-wrapper ActiveMagento2-module[Logging & Monitoring](/categories/logging) mage-stack/module-logstash-wrapper ================================== Magento 2 module for Logstash wrapper 1.0.3(11mo ago)411[3 issues](https://github.com/attherateof/LogstashWrapper/issues)MITPHP Since May 5Pushed 11mo ago2 watchersCompare [ Source](https://github.com/attherateof/LogstashWrapper)[ Packagist](https://packagist.org/packages/mage-stack/module-logstash-wrapper)[ Docs](https://github.com/attherateof/LogstashWrapper)[ RSS](/packages/mage-stack-module-logstash-wrapper/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (3)Dependencies (3)Versions (5)Used By (0) Mage2 Module: Mage Stack Logstash Wrapper ========================================= [](#mage2-module-mage-stack-logstash-wrapper) MageStack\_LogstashWrapper is a Magento 2 module designed to streamline the integration between Magento and Logstash. It enables developers and administrators to easily view and filter logs from OpenSearch (via Logstash) directly within the Magento admin panel. Requirements ------------ [](#requirements) - Magento 2.4.8 - PHP 8.4 - Opensearch - Logstash - MageStack Core module `composer require mage-stack/module-core` - MageStack Opensearch module `composer require mage-stack/module-opensearch` Module version -------------- [](#module-version) - 1.0.0 Main Functionalities -------------------- [](#main-functionalities) - Generate logstash configurartion depending upon your existing confiuration - Display log in admin grid - Filter and search logs from admin Installation ------------ [](#installation) 1. **Install the module via Composer**: To install this module, run the following command in your Magento root directory: - `composer require mage-stack/module-logstash-wrapper` 2. **Enable the module:**After installation, enable the module by running: - `php bin/magento module:enable MageStack_LogstashWrapper` 3. **Apply database updates:**Run the setup upgrade command to apply any database changes: - `php bin/magento setup:upgrade` 4. **Flush the Magento cache:**Finally, flush the cache: - `php bin/magento cache:flush` Usage ----- [](#usage) This module provides a complete logging solution for Magento 2, integrated with OpenSearch and enhanced with admin-side configurability and visibility. - **Admin Configuration for Log Levels**Configure which log levels (debug, info, notice, warning, error, critical, etc.) should be sent to OpenSearch directly from the Magento admin panel. This ensures only relevant logs are indexed, helping reduce noise and optimize storage. [![Logstash admin panel configuration](docs/assets/config.png)](docs/assets/config.png) - **Export Logstash Configuration**Easily export a ready-to-use Logstash configuration file tailored for your Magento instance. This helps in quick integration and reduces manual configuration errors while setting up the log pipeline to OpenSearch. ```` input { file { path => "/absolute/path/to/your/log/directory/**/*.log" start_position => "beginning" codec => multiline { pattern => "^\[.*\]" negate => true what => "previous" } } } filter { grok { match => { "message" => "\[%{TIMESTAMP_ISO8601:timestamp}\] %{WORD:channel}\.%{LOGLEVEL:level}: %{GREEDYDATA:raw_log}" } add_tag => ["grok_success"] remove_tag => ["_grokparsefailure"] } if !([level] in ["DEBUG", "INFO", "NOTICE", "WARNING", "ERROR", "CRITICAL", "ALERT", "EMERGENCY"]) { drop { } } date { match => ["timestamp", "ISO8601"] target => "@timestamp" } grok { match => { "raw_log" => [ "(?m)^(?.*?)\s(?\{.*?\})\s(?\{.*?\})$", "(?m)^(?.*?)\s(?\{.*?\})\s(\[\])$", "(?m)^(?.*?)\s(\[\])\s(?\{.*?\})$", "(?m)^(?.*?)\s(\[\])\s(\[\])$", "(?m)^(?.*?)$" ] } } if [context_json] { mutate { gsub => [ "context_json", "\n", " ", "context_json", "\r", " ", "context_json", "\s+", " " ] } ruby { code => " require 'json' ctx = event.get('context_json') if ctx && !ctx.empty? begin parsed = JSON.parse(ctx) event.set('context', parsed) event.remove('context_json') rescue JSON::ParserError event.set('context_string', ctx) event.remove('context') event.remove('context_json') end else event.set('context_string', 'No valid JSON') event.remove('context') event.remove('context_json') end " } } if [extra_json] { json { source => "extra_json" target => "extra" skip_on_invalid_json => true } } mutate { rename => { "clean_message" => "message" } remove_field => ["timestamp", "raw_log", "extra_json", "event"] } } output { opensearch { hosts => ["http://opensearch-host:port"] index => "log-index-prefix-%{+YYYY.MM.dd}" ssl => true ssl_certificate_verification => true } } ```` - **View Logs in OpenSearch Dashboard**Logs sent to OpenSearch can be viewed and analyzed in dashboards like Kibana or OpenSearch Dashboards. Gain insights with filters, charts, and visualizations to monitor issues or performance trends. [![Opensearch admin panel to view magento 2 logs](docs/assets/opensearch_dashboard.png)](docs/assets/opensearch_dashboard.png) - **Admin Panel Log Grid**A dedicated admin grid displays the collected logs inside Magento. This grid provides pagination, search, and sorting, giving developers and admins a centralized place to monitor logs without leaving the Magento backend. [![Magento 2 admin grid](docs/assets/admin_grid_log.png)](docs/assets/admin_grid_log.png) - **Advanced Search and Filtering**Search and filter logs within the Magento grid or OpenSearch using fields like: - **Log Path** – Identify the source file or module. - **Date Range** – View logs within a specific timeframe. - **Log Levels** – Filter by severity (e.g., error, debug). - **Keywords** – Search within the message body for quick debugging. [![Magento 2 admin grid filter](docs/assets/admin_filter.png)](docs/assets/admin_filter.png) Upcoming features ----------------- [](#upcoming-features) - **Detailed Log View**Click on a log entry in the admin grid to view full details including context, stack trace, extra metadata, and any structured data attached. - **Export Logs**Allow exporting selected log entries from the admin panel (in CSV, JSON, etc.) for sharing, auditing, or offline analysis. - **Enable or Disable Log Viewer**Add configuration options to enable or disable the log viewer module entirely, allowing more control over performance and visibility based on environment (e.g., production vs development). Contributing ------------ [](#contributing) If you would like to contribute to this module, feel free to fork the repository and create a pull request. Please make sure to follow the coding standards of Magento 2. Reporting Issues ---------------- [](#reporting-issues) If you encounter any issues or need support, please create an issue on the GitHub Issues page. We will review and address your concerns as soon as possible. License ------- [](#license) This module is licensed under the MIT License. Support ------- [](#support) If you find this module useful, consider supporting me By giving this module a star on github ### Health Score 24 — LowBetter than 32% of packages Maintenance36 Infrequent updates — may be unmaintained Popularity6 Limited adoption so far Community9 Small or concentrated contributor base Maturity40 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 ~18 days Total 3 Last Release 344d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/02295abcdcc4c2368f46444437137094c48d37b1693dfc9becb7e3666c17b747?d=identicon)[attherateof](/maintainers/attherateof) --- Top Contributors [![attherateof](https://avatars.githubusercontent.com/u/153972349?v=4)](https://github.com/attherateof "attherateof (11 commits)") ### Embed Badge ![Health badge](/badges/mage-stack-module-logstash-wrapper/health.svg) ``` [![Health](https://phpackages.com/badges/mage-stack-module-logstash-wrapper/health.svg)](https://phpackages.com/packages/mage-stack-module-logstash-wrapper) ``` ### Alternatives [justbetter/magento2-sentry Magento 2 Logger for Sentry 1851.5M3](/packages/justbetter-magento2-sentry)[graycore/magento2-stdlogging A Magento 2 module that changes all logging handlers to stdout 2382.6k](/packages/graycore-magento2-stdlogging)[itonomy/module-admin-activity A continuation of The Admin Activity extension by KiwiCommerce. This extension makes it easy to track all admin activity and revert the modification. 1270.4k](/packages/itonomy-module-admin-activity)[ampersand/magento2-log-correlation-id Magento 2 correlation id for requests and logs 279.9k](/packages/ampersand-magento2-log-correlation-id)[mage-os/module-admin-activity-log The Admin Activity extension makes it easy to track all admin activity with comprehensive audit logging. 261.4k](/packages/mage-os-module-admin-activity-log)[graycore/magento2-graphql-logger 106.6k](/packages/graycore-magento2-graphql-logger) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)