OpenTelemetry integration for ReactEdge widgets and distributed commerce applications.
Widgets OpenTelemetry provides a lightweight observability layer for ReactEdge widgets, allowing widget lifecycle events, activities and distributed traces to be exported using the OpenTelemetry standard.
The project is designed to work alongside WidgetBridge but is not limited to Magento. Any platform capable of hosting ReactEdge widgets can benefit from the same instrumentation model.
- OpenTelemetry integration
- Widget lifecycle tracing
- Distributed tracing
- Structured widget activities
- Correlation ID propagation
- Custom spans and events
- OTLP exporter support
- Lightweight integration
Modern frontend architectures rarely execute entirely within a single application.
A widget may interact with:
- Magento or Mage-OS
- React SSR services
- Search services
- Recommendation engines
- AI services
- External APIs
Without end-to-end tracing it becomes difficult to understand widget behaviour, diagnose failures or measure performance across system boundaries.
Widgets OpenTelemetry provides a standard way to observe those interactions.
Install using Composer:
composer require reactedge/widgets-open-telemetryEnable the module:
bin/magento module:enable ReactEdge_WidgetsOpenTelemetry
bin/magento setup:upgrade
bin/magento cache:flush$operation = $activity->startOperation('widget.render');
$activity->addEvent($operation, 'contract.loaded');
$activity->endOperation($operation);If the OpenTelemetry exporter is unavailable, the operation gracefully degrades without affecting widget execution.
- Magento 2
- Mage-OS
- PHP 8.1+
- OpenTelemetry SDK
Widgets OpenTelemetry follows a few simple principles:
- Open standards
- Optional observability
- Minimal coupling
- Graceful degradation
- Vendor neutrality
Observability should enhance applications, never become a deployment requirement.
- ReactEdge WidgetBridge
- ReactEdge Health Engine
- ReactEdge Image Optimizer
- Browser instrumentation
- Automatic HTTP instrumentation
- Metrics support
- Additional exporters
- Dashboard examples
- AI-assisted diagnostics
Contributions, ideas and feedback are welcome.
Please open an issue before submitting significant changes.
MIT