The OpenTelemetry Symfony Bundle adds production-ready observability to any Symfony application with a singleDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/tracewayapp/opentelemetry-symfony-bundle/llms.txt
Use this file to discover all available pages before exploring further.
composer require. Every HTTP request, console command, outgoing HTTP call, Messenger job, database query, cache operation, mailer send, and Twig render is traced automatically. No C extension required — it runs on every managed Symfony host.
Installation
Install via Composer and register the bundle in under a minute.
Quickstart
Set four environment variables and start tracing immediately.
Automatic Instrumentation
See every component that gets traced out of the box.
Configuration Reference
Explore every YAML option and its default value.
What gets traced
The bundle instruments the full Symfony request lifecycle automatically — no annotations, no attributes, no changes to your application code.HTTP Requests
SERVER spans with route templates, status codes, client IP, and exceptions.
Console Commands
SERVER spans with command name, arguments, exit code, and exceptions.
HttpClient
CLIENT spans with W3C context propagation and OTLP endpoint auto-exclusion.
Messenger
PRODUCER and CONSUMER spans with context propagation across async boundaries.
Doctrine DBAL
CLIENT spans with parameterised SQL, transactions, and db system detection.
Mailer
PRODUCER and CLIENT spans with recipient count and message ID.
Scheduler
CONSUMER spans per scheduled task with trigger and next-run metadata.
Cache
INTERNAL spans for get (hit/miss), delete, and invalidateTags per pool.
Twig
INTERNAL spans per template render including nested includes.
Explore the docs
Manual Tracing
Use
TracingInterface to wrap arbitrary code in named spans.Metrics
Enable opt-in OTel metrics and record custom counters and histograms.
Log Correlation
Inject trace IDs into every Monolog record and export logs via OTLP.
AWS X-Ray
Configure native X-Ray propagation and epoch-prefixed trace IDs.
Doctor Command
Run
traceway:doctor to diagnose configuration and connectivity issues.Performance
Understand overhead, sampling strategies, and exporter best practices.