EventFlow Observability Proposal

Sentry-like Error Tracking & APM for State Machines

Version: Draft 0.1 Date: December 2024 Status: To Be Explored

---

Overview

This proposal will explore integrating EventFlow with application performance monitoring (APM) and error tracking services like:

• Sentry - Error tracking, performance monitoring
• Laravel Telescope / Pulse - Laravel-native debugging
• Datadog - Full-stack observability
• New Relic - APM and distributed tracing

Why This Proposal?

EventFlow Analytics (see ANALYTICS_PROPOSAL) focuses on business metrics - funnels, conversion rates, guard effectiveness.

This proposal focuses on operational observability:

• Error tracking with state machine context
• Distributed tracing across machines
• Performance profiling of event handlers
• Exception grouping by state/event

Key Questions to Explore

1. Integration approach: Native SDK vs adapter pattern?
2. Context enrichment: How to add state/event context to errors?
3. Trace correlation: How to link events across machines?
4. Overlap with Analytics: Where does observability end and analytics begin?
5. Existing tool users: How to avoid duplicate functionality?

Related Proposals

• Analytics Proposal - Business metrics (complementary)
• Event Queue Proposal - Queue observability

---

This proposal is a placeholder for future exploration. It will be expanded based on community interest and use cases.