README

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.

Features

• OpenTelemetry integration
• Widget lifecycle tracing
• Distributed tracing
• Structured widget activities
• Correlation ID propagation
• Custom spans and events
• OTLP exporter support
• Lightweight integration

Why?

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.

Installation

Install using Composer:

composer require reactedge/widgets-open-telemetry

Enable the module:

bin/magento module:enable ReactEdge_WidgetsOpenTelemetry
bin/magento setup:upgrade
bin/magento cache:flush

Example

$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.

Compatibility

• Magento 2
• Mage-OS
• PHP 8.1+
• OpenTelemetry SDK

Philosophy

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.

Related projects

• ReactEdge WidgetBridge
• ReactEdge Health Engine
• ReactEdge Image Optimizer

Roadmap

• Browser instrumentation
• Automatic HTTP instrumentation
• Metrics support
• Additional exporters
• Dashboard examples
• AI-assisted diagnostics

Contributing

Contributions, ideas and feedback are welcome.

Please open an issue before submitting significant changes.

License

MIT