PHPackages                             way2ecommerce/ticpan-agent - 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 &amp; Monitoring](/categories/logging)
4. /
5. way2ecommerce/ticpan-agent

ActiveMagento2-module[Logging &amp; Monitoring](/categories/logging)

way2ecommerce/ticpan-agent
==========================

Ticpan health monitoring agent for Magento 2

1.3.1(1mo ago)06proprietaryPHPPHP &gt;=7.4

Since May 14Pushed 1mo agoCompare

[ Source](https://github.com/way2ecommerce/ticpan-agent)[ Packagist](https://packagist.org/packages/way2ecommerce/ticpan-agent)[ RSS](/packages/way2ecommerce-ticpan-agent/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (8)Versions (18)Used By (0)

W2e\_Ticpan — Magento 2 Agent
=============================

[](#w2e_ticpan--magento-2-agent)

Módulo agente para [Ticpan](https://ticpan.app) — plataforma de monitorización de salud para tiendas Magento 2.

Recopila métricas de seguridad, rendimiento, SEO, calidad de código e infraestructura, las firma con HMAC-SHA256 y las envía al cloud Ticpan cada hora. El resultado es una puntuación de salud continua visible desde el dashboard de ticpan.app.

---

Requisitos
----------

[](#requisitos)

RequisitoVersión mínimaPHP7.4Magento Open Source / Adobe Commerce2.3.x / 2.4.xMódulo agente1.0.0---

Instalación
-----------

[](#instalación)

### Vía Composer (Magento 2.4.x con PHP 8.x — recomendado)

[](#vía-composer-magento-24x-con-php-8x--recomendado)

```
composer require way2ecommerce/ticpan-agent
bin/magento module:enable W2e_Ticpan
bin/magento setup:upgrade
bin/magento cache:flush
```

### Sin Composer (Magento 2.3.x / PHP 7.4 o entornos sin acceso a Packagist)

[](#sin-composer-magento-23x--php-74-o-entornos-sin-acceso-a-packagist)

```
# 1. Clonar el tag directamente en app/code
rm -rf app/code/W2e/Ticpan
git clone --branch 1.3.0 --depth 1 https://github.com/way2ecommerce/ticpan-agent app/code/W2e/Ticpan

# 2. Mover el código de src/ a la raíz del módulo
cp -r app/code/W2e/Ticpan/src/* app/code/W2e/Ticpan/
rm -rf app/code/W2e/Ticpan/src app/code/W2e/Ticpan/.git

# 3. Habilitar y actualizar
bin/magento module:enable W2e_Ticpan
bin/magento setup:upgrade
bin/magento cache:flush
```

---

Configuración
-------------

[](#configuración)

1. Ve a **Stores → Configuration → W2e Commerce → Ticpan Agent**.
2. Rellena los campos:

CampoDescripción**Habilitado**Activa o desactiva el agente**Endpoint API**URL del endpoint de ingestión (por defecto `https://ticpan.app/api/v1/report`)**Store ID**UUID de tu tienda — lo encuentras en ticpan.app tras el onboarding**Secret Key**Clave secreta HMAC — generada durante el onboarding en ticpan.app**Timeout HTTP**Segundos máximos de espera por respuesta (por defecto: 30)3. Guarda la configuración y limpia caché:

```
bin/magento cache:flush
```

---

Envío manual (sin esperar al cron)
----------------------------------

[](#envío-manual-sin-esperar-al-cron)

Útil para verificar que la conexión funciona después de configurar el módulo:

```
bin/magento ticpan:report:send
```

Comprueba el resultado en `var/log/system.log`:

```
W2e_Ticpan: report sent successfully (HTTP 202).

```

Si hay un error de configuración o de firma aparecerá en el mismo log.

---

Cron
----

[](#cron)

El módulo registra el job `ticpan_agent_heartbeat` en el grupo `default` de Magento, con ejecución **cada hora** (`0 * * * *`). Ticpan espera al menos un reporte cada 24 horas; si no llega ninguno, la tienda pasa a estado **"Expirado"** en el dashboard.

Verifica que el cron de Magento está activo:

```
bin/magento cron:run
# o revisa cron_schedule:
# SELECT job_code, status, finished_at FROM cron_schedule WHERE job_code = 'ticpan_agent_heartbeat' ORDER BY finished_at DESC LIMIT 5;
```

---

Datos recopilados
-----------------

[](#datos-recopilados)

El agente recopila **únicamente métricas técnicas** del servidor. Nunca se envían datos de clientes, pedidos, precios ni contenido de catálogo en texto plano.

PilarQué recopila**Rendimiento**Modo Magento, cachés, Redis, OPCache, Elasticsearch, indexers, static content**Seguridad**URL admin, 2FA, política de contraseñas, CAPTCHA, permisos de ficheros**OPS**Estado del cron, message queues, uso de disco, backup reciente**Código**`composer.lock`, excepciones PHP (conteo), errores JS (conteo), cumplimiento PSR-12Las reglas que requieren acceso externo (TLS, DNS, PageSpeed, headers HTTP) las evalúa directamente el cloud Ticpan sin necesidad del agente.

---

Seguridad
---------

[](#seguridad)

Cada payload se firma con **HMAC-SHA256** usando la clave secreta configurada:

```
X-Ticpan-Signature: sha256=
X-Ticpan-Timestamp:
X-Ticpan-Store-Id:

```

El cloud rechaza peticiones con timestamp fuera de una ventana de ±5 minutos y peticiones duplicadas (anti-replay). La clave secreta se almacena cifrada en `core_config_data` mediante el sistema de cifrado nativo de Magento.

---

Logs
----

[](#logs)

Todas las trazas del módulo van a `var/log/system.log` con el prefijo `W2e_Ticpan:`.

```
grep "W2e_Ticpan" var/log/system.log
```

---

Compatibilidad con Adobe Commerce Cloud
---------------------------------------

[](#compatibilidad-con-adobe-commerce-cloud)

El módulo detecta automáticamente si está instalado en Adobe Commerce Cloud (presencia de `magento/magento-cloud-metapackage` en `composer.lock`) e incluye el flag `is_cloud_edition: true` en el payload. El cloud Ticpan ajusta la evaluación de ciertas reglas que no aplican en entornos Cloud (permisos de ficheros, detección de static content deploy).

---

Soporte
-------

[](#soporte)

- Dashboard y onboarding: [ticpan.app](https://ticpan.app)
- Issues: [github.com/way2ecommerce/ticpan-agent/issues](https://github.com/way2ecommerce/ticpan-agent/issues)

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance91

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

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 ~1 days

Total

17

Last Release

46d ago

PHP version history (2 changes)1.0.0PHP ^8.1

1.3.0PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/16ceb8a93e2cc95eef51b7f256b5dd2255c1e15dd693c49287f6cba0a2c762dd?d=identicon)[way2ecommerce](/maintainers/way2ecommerce)

### Embed Badge

![Health badge](/badges/way2ecommerce-ticpan-agent/health.svg)

```
[![Health](https://phpackages.com/badges/way2ecommerce-ticpan-agent/health.svg)](https://phpackages.com/packages/way2ecommerce-ticpan-agent)
```

###  Alternatives

[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.4M1](/packages/fastly-magento2)[mollie/magento2

Mollie Payment Module for Magento 2

1131.9M16](/packages/mollie-magento2)[run-as-root/magento2-prometheus-exporter

Magento2 Prometheus Exporter

68357.9k](/packages/run-as-root-magento2-prometheus-exporter)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1011.8k26](/packages/loki-magento2-components)[fredden/magento2-module-javascript-error-reporting

A Magento 2 module which captures JavaScript errors for later review by website administrators

3139.8k](/packages/fredden-magento2-module-javascript-error-reporting)[mage-os/module-inventory-reservations-grid

Add a grid with the list of inventory reservations.

1615.9k](/packages/mage-os-module-inventory-reservations-grid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
