Weave Code
Code Weaver
Helps Laravel developers discover, compare, and choose open-source packages. See popularity, security, maintainers, and scores at a glance to make better decisions.
Feedback
Share your thoughts, report bugs, or suggest improvements.
Subject
Message

Sentry Enhanced Tracing Laravel Package

amarc-sudo/sentry-enhanced-tracing

View on GitHub
Deep Wiki
Context7
1.1.0

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

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
1.0.0

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
0.1.0

Added

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

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

How can I help you explore Laravel packages today?

Conversation history is not saved when not logged in.
Prompt
Add packages to context
No packages found.
daikazu/eloquent-salesforce-objects
unseen-codes/chat
romalytar/yammi-jobs-monitoring-laravel
kisame76/filament-db-table-state
nqxcode/laravel-lucene-search
dpfx/laravel-livewire-wizards
workos/workos-php-laravel
sofa/laravel-global-scope
nawasara/auth-primitives
adhocrat-io/arkhe-main
make-dev/orca-harpoon
itsemon245/lamet
baks-dev/dashboard
amoifr/pickle-panther-bundle
make-dev/orca
dmstr/symfony-system-resources-bundle
dmstr/symfony-job-queue-bundle
dmstr/openapi-json-schema-bundle
dmstr/keycloak-security-bundle
dmstr/doctrine-audit-log-bundle