PHPackages                             vitaliyboyko/magento-seq - 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. [Debugging & Profiling](/categories/debugging)
4. /
5. vitaliyboyko/magento-seq

ActiveMagento2-module[Debugging & Profiling](/categories/debugging)

vitaliyboyko/magento-seq
========================

Magento 2 local-development Seq instrumentation module

2026.1.2(1mo ago)241proprietaryPHPPHP ^8.1 || ^8.2 || ^8.3 || ^8.4

Since Apr 19Pushed 1mo agoCompare

[ Source](https://github.com/VitaliyBoyko/magento-seq)[ Packagist](https://packagist.org/packages/vitaliyboyko/magento-seq)[ RSS](/packages/vitaliyboyko-magento-seq/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (3)Dependencies (5)Versions (4)Used By (0)

Magento Seq
===========

[](#magento-seq)

`magento-seq` is a Magento 2 module for local development only.

Do not install this in production. It is meant for developer machines where you want Magento logs and ad hoc instrumentation to flow into Seq without patching the project codebase.

What is Seq
-----------

[](#what-is-seq)

Seq is a structured log and event server built for fast debugging. Instead of digging through flat text files, you send events with properties and then filter, search, and correlate them in a UI that is much better suited for tracing application behavior.

For local development, that is especially useful because you can inspect request flow, custom instrumentation, and Magento logs in one place with timestamps, levels, and payload fields intact.

Why Seq is useful for LLM instrumentation
-----------------------------------------

[](#why-seq-is-useful-for-llm-instrumentation)

LLM workflows are much easier to debug when prompts, responses, timings, model names, token counts, tool calls, and request context are captured as structured events instead of free-form text logs.

Seq is a good fit for that style of instrumentation because it lets you quickly answer questions like:

- which prompt version caused a bad response
- where latency increased in a multi-step pipeline
- which tool call or API dependency failed
- what input or session context led to a hallucination or malformed output

That makes Seq a practical local observability tool when you are iterating on AI features and need a fast feedback loop during debugging.

   ### Support the Project

[](#support-the-project)

If this module is useful in your local Magento workflow, consider buying the contributor a coffee:

 [```
    ( (
     ) )
  ........
  |      |]
  \      /
   `----'
 Buy Me a Coffee
```

 ](https://buymeacoffee.com/vitalii_b)   What it does
------------

[](#what-it-does)

- mirrors Magento Monolog records to Seq
- exposes a backend instrumentation service for custom events
- exposes a frontend helper as `window.devSeq`
- exposes an anonymous REST API endpoint for storefront event collection
- provides admin config for Seq host / URL and optional password / API key

Good companion plugin for IntelliJ IDEs
---------------------------------------

[](#good-companion-plugin-for-intellij-ides)

If you use JetBrains IDEs, [`Seq MCP`](https://plugins.jetbrains.com/plugin/31358-seq-mcp) is a strong fit to use together with this module.

This Magento module is responsible for getting Magento logs and custom instrumentation into Seq. The JetBrains plugin complements that by exposing Seq-focused tools inside the IDE through JetBrains' built-in MCP server, so an AI assistant connected to your IDE can inspect the Seq data produced by this module while you work on the project.

Together, they make a practical local workflow for Magento AI debugging: Magento emits structured events to Seq, and the IDE-side MCP integration makes those events easier to explore from within the development environment.

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

[](#installation)

Install the module:

```
composer require --dev vitaliyboyko/magento-seq
```

Then enable it in Magento:

```
bin/magento module:enable VitaliiBoiko_Seq
bin/magento setup:upgrade
bin/magento cache:flush
```

Admin config
------------

[](#admin-config)

After install, configure the module in:

`Stores -> Configuration -> Advanced -> Seq (Local Dev)`

Fields:

- `Enabled`
- `Seq Host / URL`
- `Password / API Key`

If the password field is filled, the module sends it as an `X-Seq-ApiKey` header.

If you enter only the Seq host, the module automatically sends to `/api/events/raw?clef`.

The config field is validated on save. It accepts either a plain Seq host such as `http://seq:80`, or the exact raw CLEF endpoint. Magento also performs a live HTTP check against the Seq server during save and shows an admin error if the server is unreachable.

Backend usage
-------------

[](#backend-usage)

Inject `VitaliiBoiko\Seq\Api\InstrumentationInterface` and call `log()`:

```