PHPackages stacktracer/stacktracer-symfony - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. stacktracer/stacktracer-symfony ActiveSymfony-bundle[Logging & Monitoring](/categories/logging) stacktracer/stacktracer-symfony =============================== Lightweight error tracking and tracing SDK for Symfony applications. Capture exceptions, request traces, and performance data. v1.9.0(5mo ago)015MITPHPPHP >=8.1 Since Jan 18Pushed 5mo agoCompare [ Source](https://github.com/sufyana35/stacktracer-symfony)[ Packagist](https://packagist.org/packages/stacktracer/stacktracer-symfony)[ Docs](https://github.com/stacktracer/stacktracer-symfony)[ RSS](/packages/stacktracer-stacktracer-symfony/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (9)Versions (17)Used By (0) Stacktracer Symfony Bundle ========================== [](#stacktracer-symfony-bundle) Lightweight error tracking and tracing SDK for Symfony applications with **OpenTelemetry-compatible distributed tracing**. Capture exceptions, request traces, spans, breadcrumbs, logs, and performance data - all unified and linked together. Features -------- [](#features) - 🔗 **Unified Tracing** - Spans, breadcrumbs, logs, and stack traces linked by trace/span IDs - 🌐 **Distributed Tracing** - W3C Trace Context (traceparent) header support - 🔍 **OTEL Compatible** - OpenTelemetry-style spans with semantic conventions - 🔐 **Fingerprinting** - Hash-based deduplication for cost optimization - 📊 **Monolog Integration** - Automatic log capture linked to spans - ⚡ **Performance** - Batching, compression, and sampling - 🧩 **Symfony Integrations** - Doctrine, Messenger, Mailer, Security, Forms, Twig, Cache, Console Feature Tiers ------------- [](#feature-tiers) FeatureTierDefaultExceptions & Stack Traces**Free**✅ EnabledLogs**Free**✅ EnabledBreadcrumbs**Free**✅ EnabledRequest/Response Data**Free**✅ EnabledOTEL Spans**Paid**❌ DisabledTo enable OTEL spans (paid feature): ``` stacktracer: capture: spans: true ``` Installation ------------ [](#installation) ``` composer require stacktracer/stacktracer-symfony ``` Quick Setup ----------- [](#quick-setup) ### 1. Add environment variables [](#1-add-environment-variables) Add to your `.env` file: ``` STACKTRACER_ENDPOINT=https://api.stacktracer.io/v1/traces STACKTRACER_API_KEY=your-api-key-here STACKTRACER_SERVICE_NAME=my-service STACKTRACER_SERVICE_VERSION=1.0.0 ``` ### 2. Create configuration file [](#2-create-configuration-file) Create `config/packages/stacktracer.yaml`: ``` stacktracer: transport: endpoint: '%env(STACKTRACER_ENDPOINT)%' api_key: '%env(STACKTRACER_API_KEY)%' service: name: '%env(STACKTRACER_SERVICE_NAME)%' version: '%env(STACKTRACER_SERVICE_VERSION)%' ``` That's it! The bundle will automatically: - Capture all unhandled exceptions with fingerprinting - Track request performance with OTEL spans - Capture Monolog logs linked to spans - Propagate trace context for distributed tracing - Send traces to your Stacktracer endpoint Configuration Options --------------------- [](#configuration-options) ``` stacktracer: enabled: true # Enable/disable globally transport: endpoint: '%env(STACKTRACER_ENDPOINT)%' # Required api_key: '%env(STACKTRACER_API_KEY)%' # Required batch_size: 50 # Traces per batch flush_interval_ms: 5000 # Max wait before flush max_queue_size: 500 # Queue size limit timeout: 5 # HTTP timeout (seconds) compress: true # Gzip compression max_retries: 3 # Retry attempts exclude_patterns: # Paths to ignore - '#^/_profiler#' - '#^/_wdt#' capture: request: true # Track requests exception: true # Track exceptions exception_context_lines: 5 # Code lines around error stacktrace_context_lines: 5 # Code lines per frame spans: false # 💰 OTEL spans (paid feature, disabled by default) performance: sample_rate: 1.0 # 0.1 = 10% sampling max_stack_frames: 50 # Stack depth limit capture_code_context: true # Include code snippets filter_vendor_frames: true # Collapse vendor frames capture_request_headers: true sensitive_keys: # Keys to redact - password - token - secret # OTEL service identification service: name: '%env(STACKTRACER_SERVICE_NAME)%' version: '%env(STACKTRACER_SERVICE_VERSION)%' # Monolog integration logging: enabled: true # Capture logs level: debug # Minimum level capture_context: true # Include log context exclude_channels: # Channels to ignore - event - doctrine ``` Manual Usage ------------ [](#manual-usage) Inject the service and use it directly: ``` use Stacktracer\SymfonyBundle\Service\TracingService; use Stacktracer\SymfonyBundle\Model\Trace; use Stacktracer\SymfonyBundle\Model\Span; class MyController { public function __construct( private TracingService $stacktracer ) {} public function someAction() { // Add breadcrumbs for debugging (linked to current span) $this->stacktracer->addBreadcrumb('user', 'User clicked checkout'); // Create a span for a unit of work $this->stacktracer->withSpan('process-order', function(Span $span) { $span->setAttribute('order.id', $orderId); // Nested span for database query $this->stacktracer->withSpan('db.query', function($dbSpan) { $dbSpan->setAttribute('db.statement', 'SELECT * FROM orders'); // ... database work }, Span::KIND_CLIENT); // ... process order }); try { // Your code } catch (\Exception $e) { // Capture exception (auto-linked to current span) $this->stacktracer->captureException($e, [ 'order_id' => $orderId, ]); } // Capture a custom message $this->stacktracer->captureMessage( 'Order completed', Trace::LEVEL_INFO, ['order_id' => $orderId] ); } } ``` Feature Flags & Experiments ------------------------------- [](#feature-flags--experiments) Monitor errors as you roll out features or run A/B tests. Feature flags are linked to errors, helping identify if a feature introduced issues. ``` use Stacktracer\SymfonyBundle\Model\FeatureFlag; class MyController { public function __construct( private TracingService $stacktracer ) {} public function checkout() { // Declare a single feature flag with variant $this->stacktracer->addFeatureFlag('Checkout button color', 'Blue'); $this->stacktracer->addFeatureFlag('New checkout flow'); // Declare multiple feature flags at once $this->stacktracer->addFeatureFlags([ new FeatureFlag('Special offer', 'Free Coffee'), new FeatureFlag('Premium shipping'), ]); // Remove flags when features are deactivated $this->stacktracer->clearFeatureFlag('Checkout button color'); // Clear all flags $this->stacktracer->clearFeatureFlags(); } } ``` ### LaunchDarkly Integration [](#launchdarkly-integration) ``` $featureEnabled = $launchDarklyClient->variation('bool-flag-key', $user, false); if ($featureEnabled) { $this->stacktracer->addFeatureFlag('bool-flag-key'); } else { $this->stacktracer->clearFeatureFlag('bool-flag-key'); } // String variant $variant = $launchDarklyClient->variation('button-color', $user, 'default'); $this->stacktracer->addFeatureFlag('button-color', $variant); ``` ### Split Integration [](#split-integration) ``` // Use an impression listener to automatically track experiments class StacktracerImpressionListener implements \SplitIO\Sdk\ImpressionListener { public function __construct(private TracingService $stacktracer) {} public function logImpression($data) { $this->stacktracer->addFeatureFlag( $data['impression']['feature'], $data['impression']['treatment'] ); } } ``` Distributed Tracing ------------------- [](#distributed-tracing) The bundle automatically propagates trace context via W3C `traceparent` header: ``` // Outgoing HTTP request - include trace context $client->request('GET', '/api/users', [ 'headers' => [ 'traceparent' => $this->stacktracer->getTraceparent(), ], ]); ``` Incoming requests with `traceparent` headers are automatically linked to the parent trace. Symfony Integrations -------------------- [](#symfony-integrations) All integrations are **enabled by default** and auto-detect component availability. Configure in `stacktracer.yaml`: ``` stacktracer: integrations: doctrine: enabled: true slow_query_threshold: 100 # ms http_client: enabled: true propagate_context: true # W3C traceparent messenger: enabled: true cache: enabled: true console: enabled: true form: enabled: true security: enabled: true mailer: enabled: true twig: enabled: true slow_threshold: 50 # ms ``` ### Available Integrations [](#available-integrations) IntegrationComponentWhat's Tracked**Doctrine DBAL**`doctrine/dbal`SQL queries, slow query detection (`db.*`)**HTTP Client**`symfony/http-client`Outgoing requests, trace propagation (`http.*`)**Messenger**`symfony/messenger`Async jobs, retries, failures (`messaging.*`, `job.*`)**Cache**`symfony/cache`Cache hits/misses, operations (`cache.*`)**Console**`symfony/console`CLI commands, exit codes, memory (`cli.*`)**Form**`symfony/form`Validation errors, failed submissions (`form.*`)**Security**`symfony/security`Login, logout, access denied (`security.*`)**Mailer**`symfony/mailer`Email sending, delivery failures (`mail.*`)**Twig**`twig/twig`Template renders, errors (`template.*`)### Example: Form Validation Errors [](#example-form-validation-errors) Form validation errors are automatically captured as breadcrumbs: ``` // When a form fails validation, you'll see breadcrumbs like: // [warning] Form validation failed // - form.name: "contact" // - form.error_count: 2 // - form.errors: [{"field": "email", "message": "Invalid email"}] ``` ### Example: Security Events [](#example-security-events) Authentication events are tracked automatically: ``` // Login failures appear as breadcrumbs + spans: // [warning] Login attempt failed // - security.event: "login_failure" // - security.attempted_user: "john@example.com" // - security.failure_reason: "Invalid credentials" ``` ### Example: Mailer Tracking [](#example-mailer-tracking) Email sending is tracked with delivery status: ``` // Email events appear as breadcrumbs + spans: // [info] Email sent successfully // - mail.to: "user@example.com" // - mail.subject: "Welcome to our platform" // - mail.duration_ms: 234.5 ``` Data Model ---------- [](#data-model) ### Unified Linking [](#unified-linking) All data is linked together for easy frontend navigation: ``` Trace ├── trace_id (OTEL 128-bit) ├── spans[] │ ├── span_id (OTEL 64-bit) │ ├── parent_span_id │ ├── breadcrumbs[] (linked by span_id) │ ├── logs[] (linked by span_id) │ └── stack_trace[] (with fingerprints) ├── fingerprint (for deduplication) └── group_key (for aggregation) ``` ### Fingerprinting [](#fingerprinting) Stack traces and errors are fingerprinted for: - **Deduplication** - Identical errors grouped together - **Cost Optimization** - Store fingerprint, not full stack on repeats - **Pattern Detection** - Find similar error patterns ``` // Fingerprints are computed automatically $trace->getFingerprint(); // Unique error signature $trace->getGroupKey(); // Grouping key for similar errors ``` API Reference ------------- [](#api-reference) ### TracingService [](#tracingservice) MethodDescription`captureException($e, $context)`Capture an exception`captureMessage($msg, $level, $context)`Capture a custom message`addBreadcrumb($cat, $msg, $data, $level)`Add debugging breadcrumb`startSpan($name, $kind)`Start a new span`endSpan($span)`End a span`withSpan($name, $callback, $kind)`Execute within a span`getCurrentSpan()`Get active span`getTraceparent()`Get W3C traceparent header`setIncomingContext($traceparent)`Set context from incoming header`log($message, $level, $context)`Add a log entry`setTag($key, $value)`Set global tag`setContext($key, $value)`Set global context`flush()`Force send queued traces### Span Kinds (OTEL) [](#span-kinds-otel) - `Span::KIND_INTERNAL` - Internal operation (default) - `Span::KIND_SERVER` - Server handling request - `Span::KIND_CLIENT` - Client making request - `Span::KIND_PRODUCER` - Message producer - `Span::KIND_CONSUMER` - Message consumer ### Trace Levels [](#trace-levels) - `Trace::LEVEL_DEBUG` - `Trace::LEVEL_INFO` - `Trace::LEVEL_WARNING` - `Trace::LEVEL_ERROR` - `Trace::LEVEL_FATAL` Requirements ------------ [](#requirements) - PHP 8.1+ - Symfony 6.4, 7.x, or 8.x - ext-curl - ext-json License ------- [](#license) MIT ### Health Score 36 — LowBetter than 79% of packages Maintenance72 Regular maintenance activity Popularity6 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 16 Last Release 164d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/53792424?v=4)[sufyana35](/maintainers/sufyana35)[@sufyana35](https://github.com/sufyana35) --- Top Contributors [![sufyana35](https://avatars.githubusercontent.com/u/53792424?v=4)](https://github.com/sufyana35 "sufyana35 (35 commits)") --- Tags symfonybundlemonitoringdebuggingexceptionsapmtracingobservabilityerror-tracking ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/stacktracer-stacktracer-symfony/health.svg) ``` [![Health](https://phpackages.com/badges/stacktracer-stacktracer-symfony/health.svg)](https://phpackages.com/packages/stacktracer-stacktracer-symfony) ``` ### Alternatives [easycorp/easyadmin-bundle Admin generator for Symfony applications 4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[flow-php/flow PHP ETL - Extract Transform Load - Data processing framework 85036.3k](/packages/flow-php-flow)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 585.6M568](/packages/shopware-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)