Events
Events is the umbrella term for both spans (operations with a duration) and span events (point-in-time occurrences within a span). For the payload structure of events, see the errors payload and traces payload pages.
Span Types
HTTP
php_request
The incoming HTTP request being handled by the application.
| Attribute | Type | Description |
|---|---|---|
url.full |
string | Full request URL |
url.scheme |
string | URL scheme (http/https) |
url.path |
string | URL path |
url.query |
string | URL query string |
http.request.method |
string | HTTP method |
http.route |
string | Matched route |
http.request.headers |
object | Request headers |
http.request.cookies |
object | Request cookies |
http.request.session |
object | Session data |
http.request.body.contents |
object | Request body |
http.request.body.size |
int | Request body size |
http.request.files |
object | Uploaded files |
http.request.referrer |
string | Referrer URL |
client.address |
string | Client IP address |
user_agent.original |
string | User agent string |
server.address |
string | Server address |
server.port |
int | Server port |
For errors, these attributes go directly in the root attributes object rather than in the events array.
php_response
The HTTP response sent back to the client.
| Attribute | Type | Description |
|---|---|---|
http.response.status_code |
int | Response status code |
http.response.body.size |
int | Response body size |
http.response.headers |
object | Response headers |
For errors, these attributes go directly in the root attributes object rather than in the events array.
php_http_request
An outgoing HTTP request made by the application to an external service.
| Attribute | Type | Description |
|---|---|---|
url.full |
string | Request URL |
url.scheme |
string | URL scheme |
url.path |
string | URL path |
url.query |
string | URL query string |
url.fragment |
string | URL fragment |
http.request.method |
string | HTTP method |
http.request.body.size |
int | Request body size |
http.request.headers |
object | Request headers |
http.response.status_code |
int | Response status code |
http.response.body.size |
int | Response body size |
http.response.headers |
object | Response headers |
server.address |
string | Server address |
server.port |
int | Server port |
error.type |
string | Error type on connection failure |
Database
php_query
A single database query.
| Attribute | Type | Description |
|---|---|---|
db.system |
string | Database system (e.g. mysql, pgsql) |
db.name |
string | Database name |
db.statement |
string | SQL statement |
db.sql.bindings |
array | Query bindings |
db.operation.name |
string | Operation name |
laravel.db.connection |
string | Laravel connection name |
php_transaction
A database transaction wrapping one or more queries.
| Attribute | Type | Description |
|---|---|---|
db.system |
string | Database system |
db.name |
string | Database name |
db.transaction.status |
string | Transaction status (committed, rolled_back) |
laravel.db.connection |
string | Laravel connection name |
redis_command
A single Redis command.
| Attribute | Type | Description |
|---|---|---|
db.system |
string | Always redis |
db.namespace |
string | Redis database namespace |
db.operation.name |
string | Redis command name |
db.query.parameters |
array | Command parameters |
network.peer.address |
string | Server address |
network.peer.port |
int | Server port |
Application Lifecycle
These spans represent the phases of the application lifecycle and carry no specific attributes. See Lifecycle for more details.
| Type | Description |
|---|---|
php_application |
Root span wrapping the entire application lifecycle |
php_application_registration |
Service provider registration phase |
php_application_boot |
Service provider boot phase |
php_application_terminating |
Termination callbacks after the response is sent |
Request Lifecycle
php_routing
The route matching phase where the framework resolves the incoming request to a route.
| Attribute | Type | Description |
|---|---|---|
laravel.route.name |
string | Route name |
laravel.route.action |
string | Route action |
laravel.route.action_type |
string | Action type (controller, closure, view, redirect, unknown) |
laravel.route.parameters |
object | Route parameters |
laravel.route.middleware |
array | Route middleware |
For errors, these attributes go directly in the root attributes object rather than in the events array.
Middleware
Individual middleware execution. Global middleware runs on every request, while regular (route) middleware only runs on routes it is assigned to. Before middleware runs before the controller, after middleware runs after. The following middleware span types carry no specific attributes:
| Type | Description |
|---|---|
php_global_before_middleware |
Global before middleware (runs on every request, before the controller) |
php_before_middleware |
Route before middleware (runs before the controller) |
php_after_middleware |
Route after middleware (runs after the controller) |
php_global_after_middleware |
Global after middleware (runs on every request, after the controller) |
Jobs & Queues
laravel_job
A queued or synchronous job being processed.
| Attribute | Type | Description |
|---|---|---|
laravel.job.class |
string | Job class |
laravel.job.name |
string | Job display name |
laravel.job.uuid |
string | Job UUID |
laravel.job.success |
bool | Whether job succeeded |
laravel.job.attempts |
int | Number of attempts |
laravel.job.max_tries |
int | Maximum tries |
laravel.job.max_exceptions |
int | Maximum exceptions |
laravel.job.timeout |
int | Job timeout (seconds) |
laravel.job.fail_on_timeout |
bool | Fail on timeout |
laravel.job.backoff |
string/int | Backoff strategy |
laravel.job.retry_until |
int | Retry until timestamp |
laravel.job.delay |
string/int | Job delay |
laravel.job.after_commit |
bool | Dispatch after commit |
laravel.job.pushed_at |
int | Push timestamp |
laravel.job.tags |
array | Job tags |
laravel.job.properties |
object | Job properties |
laravel.job.batch_id |
string | Batch ID |
laravel.job.queue.connection_name |
string | Queue connection |
laravel.job.queue.name |
string | Queue name |
laravel.job.chain.queue.connection_name |
string | Chain queue connection |
laravel.job.chain.queue.name |
string | Chain queue name |
laravel.job.chain.jobs |
array | Chained job classes |
laravel.job.delete_when_missing_models |
bool | Delete when missing models |
laravel_queueing
The dispatching of a job onto the queue. Same attributes as laravel_job.
Livewire
laravel_livewire_component
The parent span wrapping the full Livewire component lifecycle. When individual phase spans (mounting, hydrating, etc.) are disabled in favor of a single span per component, the duration of each phase can be added as attributes using the livewire.component.phase.{phase} naming convention (e.g. livewire.component.phase.mounting, livewire.component.phase.hydrating) with the value in milliseconds.
| Attribute | Type | Description |
|---|---|---|
livewire.component.class |
string | Component class name |
livewire.component.name |
string | Component name |
view.name |
string | Blade view name |
laravel_livewire_component_premounting
Runs before the component's mount method is called.
| Attribute | Type | Description |
|---|---|---|
livewire.component.name |
string | Component name |
laravel_livewire_component_mounting
The component's mount method being executed.
| Attribute | Type | Description |
|---|---|---|
livewire.component.name |
string | Component name |
laravel_livewire_component_hydrating
Restoring the component's state from the client-side payload.
| Attribute | Type | Description |
|---|---|---|
livewire.component.name |
string | Component name |
laravel_livewire_component_call
A method call on the component triggered by a user action.
| Attribute | Type | Description |
|---|---|---|
livewire.component.name |
string | Component name |
livewire.component.call.method |
string | Method name |
livewire.component.call.params |
array | Method parameters |
livewire.component.phase |
string | Current lifecycle phase |
laravel_livewire_component_rendering
Rendering the component's Blade view.
| Attribute | Type | Description |
|---|---|---|
livewire.component.name |
string | Component name |
laravel_livewire_component_dehydrating
Serializing the component's state back to the client.
| Attribute | Type | Description |
|---|---|---|
livewire.component.name |
string | Component name |
Other
php_command
An Artisan or CLI command being executed.
| Attribute | Type | Description |
|---|---|---|
process.command |
string | Command name |
process.command_args |
array | Command arguments |
process.exit_code |
int/null | Exit code |
php_view
A Blade or other template view being rendered.
| Attribute | Type | Description |
|---|---|---|
view.name |
string | View name |
view.type |
string | View type (view, component, inline_component) |
view.file |
string | View file path |
view.data |
object | View data |
view.loop |
string | Loop position (e.g. 2/10) |
view.component.name |
string | Component name |
view.component.class |
string | Component class |
view.component.inline |
bool | Whether the component is inline |
php_filesystem
A filesystem operation (read, write, delete, etc.).
All filesystem spans include filesystem.operation. The attributes per operation are listed below.
Operations
| Operation | Input Attributes | Result Attributes |
|---|---|---|
path |
filesystem.path |
filesystem.full_path |
exists |
filesystem.path |
filesystem.exists |
get |
filesystem.path, filesystem.is_stream |
filesystem.contents.size |
put |
filesystem.path, filesystem.contents.size, filesystem.is_stream, filesystem.as_path |
filesystem.operation.success |
prepend |
filesystem.path, filesystem.contents.size |
filesystem.operation.success |
append |
filesystem.path, filesystem.contents.size |
filesystem.operation.success |
delete |
filesystem.paths |
filesystem.operation.success |
copy |
filesystem.from_path, filesystem.to_path |
filesystem.operation.success |
move |
filesystem.from_path, filesystem.to_path |
filesystem.operation.success |
size |
filesystem.path |
filesystem.contents.size |
files |
filesystem.path, filesystem.recursive |
filesystem.found_paths |
directories |
filesystem.path, filesystem.recursive |
filesystem.found_paths |
make_directory |
filesystem.path |
filesystem.operation.success |
delete_directory |
filesystem.path |
filesystem.operation.success |
url |
filesystem.path |
filesystem.url |
get_visibility |
filesystem.path |
filesystem.visibility |
set_visibility |
filesystem.path, filesystem.visibility |
filesystem.operation.success |
last_modified |
filesystem.path |
filesystem.last_modified |
checksum |
filesystem.path |
filesystem.checksum |
mime_type |
filesystem.path |
filesystem.mime_type |
temporary_url |
filesystem.path, filesystem.expiration |
filesystem.url |
temporary_upload_url |
filesystem.path, filesystem.expiration |
|
assert_exists |
filesystem.path |
|
assert_missing |
filesystem.path |
|
assert_directory_empty |
filesystem.path |
Attributes
| Attribute | Type | Description |
|---|---|---|
filesystem.operation |
string | Operation type |
filesystem.path |
string | File or directory path |
filesystem.paths |
array | Multiple file paths (for delete) |
filesystem.from_path |
string | Source path (for copy/move) |
filesystem.to_path |
string | Destination path (for copy/move) |
filesystem.contents.size |
int | Content size in bytes |
filesystem.recursive |
bool | Whether the operation is recursive |
filesystem.visibility |
string | File visibility |
filesystem.expiration |
string | Expiration time for temporary URLs |
filesystem.is_stream |
bool | Whether the operation uses a stream (readStream/writeStream) |
filesystem.as_path |
string | Target filename (putFileAs) |
filesystem.full_path |
string | Resolved full path |
filesystem.exists |
bool | Whether the file exists |
filesystem.operation.success |
bool | Whether the operation succeeded |
filesystem.found_paths |
array | Paths found by listing operations |
filesystem.url |
string | Generated URL |
filesystem.last_modified |
int | Last modified timestamp |
filesystem.checksum |
string | File checksum |
filesystem.mime_type |
string | File MIME type |
php_notification
A notification being sent through a channel (mail, Slack, etc.).
| Attribute | Type | Description |
|---|---|---|
notification.id |
string | Notification ID |
notification.channel |
string | Notification channel |
notification.type |
string | Notification type |
notification.to |
string | Notification recipient |
Span Event Types
php_log
A log entry written by the application.
| Attribute | Type | Description |
|---|---|---|
log.message |
string | Log message |
log.level |
string | Log level (debug, info, notice, warning, error, critical, alert, emergency) |
log.context |
object | Log context data |
php_glow
A breadcrumb-style note added by the developer for debugging context.
| Attribute | Type | Description |
|---|---|---|
glow.name |
string | Glow name |
glow.level |
string | Glow level |
glow.context |
object | Glow context data |
php_dump
A variable dump captured during execution.
| Attribute | Type | Description |
|---|---|---|
dump.html |
string | HTML representation of the dumped value |
php_exception
An exception that occurred during a span.
| Attribute | Type | Description |
|---|---|---|
exception.message |
string | Exception message |
exception.type |
string | Exception class name |
exception.handled |
bool | Whether the exception was handled |
exception.id |
string | Exception identifier |
php_cache
A cache store operation.
| Attribute | Type | Description |
|---|---|---|
cache.operation |
string | Operation type (get, set, forget) |
cache.result |
string | Operation result (hit, miss, success, failure) |
cache.key |
string | Cache key |
cache.store |
string | Cache store name |
- On this page
- Span Types
- Span Event Types