Sentry Enhanced Tracing Laravel Package

Added

• Symfony Messenger queue monitoring: automatic queue.publish span on dispatch and queue.process transaction on workers.
• SentryTraceStamp / SentryUserStamp: traceparent+baggage and user context propagation across Messenger hops.
• Metadata enrichment: message id, destination, body size, retry count, receive latency mapped to Sentry queue fields.
• Auto-registration: listeners wired by default; user propagation toggle via sentry_enhanced_tracing.messenger.propagate_user.
• Documentation & example: Messenger queue section in docs and examples/messenger-queue-monitoring.php.

Changed

• composer.json: declare symfony/messenger as a runtime dependency.

Tests

• Added unit tests for Messenger metadata extractor and trace stamp.

Added

• TraceSentryController Attribute: New PHP 8+ attribute for explicit controller tracing
• Controller-specific tracing: Precise measurement of controller execution time
• API Platform controller support: Automatic detection and tracing of __invoke() controllers
• Attribute-based configuration: Custom operation names, descriptions, and tags per controller
• Precise timing measurement: Excludes event listeners, measures only controller business logic
• Active span management: Automatic child span capture for database queries, cache operations, etc.
• Exception handling: Robust cleanup and error tracking for traced controllers
• Controller metadata: Rich span data including controller name, type, and execution status

Features

• SentryApiPlatformControllerTracer: New event listener for controller-specific tracing
• TraceSentryController attribute: Configurable per-controller or per-method tracing
• Extreme priority listeners: Uses -99999/100000 priorities for precise timing
• Automatic child span capture: Database queries, cache operations become controller children
• Controller execution isolation: Measures only business logic, excludes framework overhead
• Custom operation naming: Configurable span names and descriptions
• Flexible tagging system: Add custom metadata to controller spans
• Multi-event cleanup: Handles view, response, and exception events for span completion

Examples

• traced-controller-usage.php: Comprehensive examples of attribute usage patterns
• Multiple controller patterns: Support for both invokable and action method controllers
• Attribute configuration: Examples of custom operation names, descriptions, and tags

Technical Implementation

• Reflection-based attribute detection: Supports both class and method-level attributes
• Sentry Hub integration: Proper active span management for child capture
• Performance optimization: Extreme event priorities for precise measurement
• Memory-efficient: Minimal overhead with proper resource cleanup
• Exception-safe: Robust error handling with proper span finalization

Documentation

• Usage examples: Complete controller tracing patterns
• Configuration reference: All attribute options and parameters
• Performance impact: Detailed explanation of timing precision
• Best practices: Guidelines for optimal controller tracing

Added

• 🎉 Initial stable release of Sentry Enhanced Tracing Bundle
• SentryListenerPhasesTracer: Core listener phase tracking with automatic child span capture
• SentryUserContextListener: Enhanced user context and request metadata capture with JWT integration
• ChangeSentryListenerPriorityPass: Optimized Sentry listener priority management
• EnhancedUserInterface: Rich user data interface for better Sentry context
• JWT Authentication Integration: Automatic user capture after JWT authentication
• Automatic child span capture: Database queries, cache operations, template rendering
• Performance categorization: Fast/normal/slow/very_slow classification
• Rich breadcrumbs: Detailed execution metrics and performance data
• Zero-configuration setup: Works out of the box with minimal setup
• Symfony 6.x and 7.x support: Compatible with latest Symfony versions
• PHP 8.1+ support: Modern PHP version requirements

Features

• Hierarchical span organization in Sentry dashboard
• Automatic DBAL query tracing under event phases
• Cache operation monitoring (Redis, APCu, etc.)
• Template rendering performance tracking
• HTTP client request monitoring
• Memory usage and execution time metrics
• Exception context enrichment
• JWT authentication hooks with lexik_jwt_authentication.on_jwt_authenticated
• Enhanced user data capture (firstname, lastname, email, UUID)
• Security-aware PII handling
• Configurable performance thresholds
• High-priority listener execution (99999-99995)

Developer Experience

• Code Quality Tools: PHPStan (level 8), Psalm (level 1), PHPCS with PSR-12
• Automated Quality Assurance: Composer scripts for phpstan, phpcs, psalm, and qa
• Strict Type Checking: Full PHP 8.1+ type coverage
• Professional Documentation: Comprehensive examples and configuration guides
• CI/CD Integration: GitHub Actions workflows for automated testing
• Multiple PHP versions support: Tested on PHP 8.1, 8.2, 8.3

Dependencies

• LexikJWTAuthenticationBundle: Required for JWT authentication integration
• Symfony Security Bundle: For user context management
• Sentry Symfony Bundle: Core Sentry integration
• Modern PHP ecosystem: Compatible with latest Symfony and PHP versions

Documentation

• Comprehensive README with usage examples
• JWT Integration Guide with LexikJWTAuthenticationBundle
• Enhanced User Interface implementation examples
• Configuration reference with all available options
• CI/CD documentation for GitHub Actions
• Installation and setup guides
• Performance optimization recommendations

Technical Architecture

• PSR-4 autoloading with proper namespacing
• Symfony Bundle architecture with dependency injection
• Event listener attributes for modern Symfony integration
• Compiler pass optimization for performance
• Service configuration with proper priorities
• Interface-based design for extensibility
• MIT License for open-source compatibility

Quality Assurance

• PHPStan Level 8: Strictest static analysis
• Psalm Level 1: Advanced type checking
• PHPCS PSR-12: Coding standards compliance
• Slevomat Coding Standard: Additional quality rules
• Automated testing: GitHub Actions CI pipeline
• Security scanning: Dependency vulnerability checks

Added

• Initial development version
• Basic proof of concept
• Core listener implementation
• Sentry integration testing

• Added: New features
• Changed: Changes in existing functionality
• Deprecated: Soon-to-be removed features
• Removed: Removed features
• Fixed: Bug fixes
• Security: Security improvements