PHP download

Download the PHP package magewatch/module-agent without Composer

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

Table of contents
Download magewatch/module-agent
More information about magewatch/module-agent
Files in magewatch/module-agent

Vendor magewatch
Package module-agent
Short Description Read-only monitoring agent for Magento 2 that collects health metrics and pushes them to the MageWatch SaaS API.
License OSL-3.0
Homepage https://magewatch.io/docs/install

Keywords cron monitoring magento saas indexer magento2 magewatch

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?

Informations about the package module-agent

MageWatch Agent for Magento 2

Read-only monitoring agent for Magento 2.4.x (Open Source or Adobe Commerce). A lightweight heartbeat runs every minute (paid) to confirm the store is alive; every five minutes it collects health metrics — indexers, cron, queues, order aggregates, log signals, system resources, and security hygiene — and pushes JSON to MageWatch over HTTPS.

Packagist: magewatch/module-agent

What it is

The MageWatch agent runs inside your Magento store. It does not modify catalog, sales, or customer data. It reports operational signals so your agency dashboard can alert you when indexers stall, crons miss runs, queues back up, orders drop unexpectedly, or logs spike — before your client notices.

What it does NOT do

Never writes to catalog, sales, or customer tables — collectors are read-only.
No customer PII — order data is hourly aggregates only (counts and revenue buckets), not individual orders or buyer details.
No remote code execution — the agent only pushes JSON over HTTPS to your MageWatch ingest endpoint. There is no inbound control channel.
Open source — every collector is plain PHP under Model/Collector/. Inspect the code before you install on production.

Install

From your Magento project root:

Then in Magento admin: Stores → Configuration → MageWatch → Agent — paste the site token from your MageWatch dashboard and set the ingest URL (production: https://magewatch.io/api/v1/ingest).

Full step-by-step guide: magewatch.io/docs/install

Architecture and payload schema: docs/AGENT.md (maintainers).

Requirements

Magento 2.4.x (tested on 2.4.6+)
PHP 8.1, 8.2, or 8.3
Outbound HTTPS to your MageWatch API host (e.g. api.magewatch.io or your self-hosted ingest URL)
Magento cron running (agent uses the magewatch cron group)

Useful commands

Frontend monitoring (RUM)

From v1.1.0, the agent can inject a tiny storefront script (paid MageWatch plans) that reports JS errors, funnel activity counters, and Web Vitals to MageWatch. The script loads from https://magewatch.io/rum/v1.js — logic lives on the SaaS so fixes do not require module releases.

Toggle: Stores → Configuration → MageWatch → Agent → Frontend monitoring (RUM) (default ON).
Keys: rum_public_key is synced automatically via remote config — never paste it manually.
What it collects: sanitized JS error messages, add-to-cart/checkout/success counters, LCP/CLS/INP — no cookies, no PII, no session IDs.
Disable: set Frontend monitoring to No — removes injection without uninstalling the agent.

Security collector (v1.2.0)

The agent whitelists legitimate Magento pub/ PHP files and compares content hashes against vendor/magento/magento2-base when available. pub/cron.php and other core files no longer false-positive as unexpected PHP; modified core files emit core_pub_php_modified. Deploy fingerprints (static_version, composer_lock_hash) are included in heartbeats for SaaS deploy correlation.

See CHANGELOG.md for release history.

Uninstall

Data & privacy

What the agent collects, how long MageWatch retains it, and DPA terms for agencies:

magewatch.io/data

License

OSL-3.0 — see LICENSE.

All versions of module-agent with dependencies

PHP Build Version

Package Version

Version 1.2.16 Release 16. Jul 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of module-agent from vendor magewatch

Requires php Version ~8.1.0||~8.2.0||~8.3.0||~8.4.0
magento/framework Version *
magento/module-backend Version *
magento/module-config Version *
magento/module-cron Version *
magento/module-indexer Version *
magento/module-sales Version *
magento/module-store Version *

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 magewatch/module-agent contains the following files

Loading the files please wait ...