Flare by Spatie
    • Error Tracking
    • Performance Monitoring
  • Pricing
  • Docs
  • Insights
  • Changelog
  • Back to Flare
  • Sign in
  • Try Flare for free
  • Error Tracking
  • Performance Monitoring
  • Pricing
  • Docs
  • Insights
  • Changelog
    • Back to Flare
    • Try Flare for free
    • Sign in
Flare Flare Laravel Laravel PHP PHP JavaScript JavaScript Protocol Protocol
  • General
  • Introduction
  • Resources
  • Events
  • Errors
  • Payload
  • Attributes
  • Sourcemaps
  • Traces
  • Payload
  • Lifecycle
  • Aggregations

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
Resources Payload
  • On this page
  • Span Types
  • Span Event Types

Catch errors and fix slowdowns with Flare, the full-stack application monitoring platform for Laravel, PHP & JavaScript.

  • Platform
  • Error Tracking
  • Performance Monitoring
  • Pricing
  • Support
  • Resources
  • Insights
  • Newsletter
  • Changelog
  • Documentation
  • Affiliate program
  • uptime status badge Service status
  • Terms of use
  • DPA
  • Privacy & cookie Policy
Flare