beehexacorp/module-hexasync-metrics

HexaSync Metrics Dashboard - Monitor system health and sync issues

1.1.0 2026-05-13 09:03 UTC

Requires

• php: ~8.1 || ~8.2 || ~8.3
• magento/framework: >=102

OSL-3.0, AFL-3.0

README

Admin dashboard and report pages for system health and HexaSync status.

Calculator structure

• Model/Calculator/OrderMetricsCalculator.php
  • Order-related metrics.
• Model/Calculator/ProductMetricsCalculator.php
  • Product/inventory/pricing metrics.
• Model/Calculator/SyncMetricsCalculator.php
  • Sync diagnostics from beehexa_hexasync_log.
• Model/MetricsCalculator.php
  • Backward-compatible facade that delegates to the calculators above.

Dashboard enhancements

• Threshold color states per metric card: ok (green), warning (orange), critical (red).
• Drill-down links from cards to anchored report sections.
• Trend badges for 7d and 30d change on each card.
• Trend direction indicators: ↑ increasing (red), ↓ decreasing (green), → no change (gray).
• Mini sparkline bars (normalized 30-day trend visualization).
• Daily snapshot persistence table: beehexa_hexasync_metric_snapshot.
• Daily cron snapshot capture + automatic retention cleanup (400 days).

Threshold configuration

Admin path: Stores > Configuration > General > HexaSync Metrics > Dashboard Thresholds

Scopes:

• Default (global)
• Website (per website override)
• Store (disabled to avoid clutter)

All metrics have separate warn and critical thresholds.

Included metrics

Orders

• Orders not completed
• Orders not synced
• Orders not completed older than 3 months

Products

• Products with negative qty
• Products with duplicate SKU
• Products with negative price
• Products with oversold risk

Sync (beehexa_hexasync_log)

• Errors in last 24h
• Pending / failed tasks
• Tasks with retry > 3
• Success rate
• Pending tasks older than 2h and 24h
• Log volume in last 24h
• Missing task ID logs in last 24h
• Task status breakdown
• Top error messages
• Top failed profiles
• Top failed action types
• Top failed task names
• Retry distribution (0, 1-2, 3-5, 6+)
• Recent failed tasks

Admin paths

• HexaSync Metrics > Dashboard
• HexaSync Metrics > Order Reports
• HexaSync Metrics > Product Reports
• HexaSync Metrics > Sync Reports

Install and enable

php bin/magento module:enable Beehexa_HexaSyncMetrics
php bin/magento setup:upgrade
php bin/magento cache:flush

Snapshot operations

Manual capture command:

php bin/magento beehexa:metrics:snapshot:capture
php bin/magento beehexa:metrics:snapshot:capture --date=2026-04-20

Daily cron schedule: 05:00 every day (etc/crontab.xml)

Quick verification

php bin/magento cache:clean
php bin/magento setup:di:compile