Laravel event reference

View Markdown

Every event the Honeybadger Laravel package sends to Insights when events are enabled: handled requests, database queries and transactions, cache hits and misses, queued and processed jobs, mail, notifications, Redis commands, route matches, and view renders. Each entry lists the event's fields with their types, and links to its raw JSON Schema.

18 events emitted by honeybadger-laravel.

Blade

view.rendered

A Blade view was rendered.

Field	Type	Description
`event_type`	string	Allowed value: `view.rendered`.
`name`	string	View name, e.g. "users.show".
`path`	string	Filesystem path to the view file.
`duration`	number	Duration in microseconds. The client sends a value with an ms suffix, such as "5.123ms". The ingestion pipeline converts it to microseconds.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "view.rendered",
  "name": "users.show",
  "path": "/var/www/html/resources/views/users/show.blade.php",
  "duration": 3500,
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

Cache

cache.hit

A cache key was found (hit).

Field	Type	Description
`event_type`	string	Allowed value: `cache.hit`.
`key`	string	Cache key that was hit.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "cache.hit",
  "key": "users:123",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

cache.miss

A cache key was not found (miss).

Field	Type	Description
`event_type`	string	Allowed value: `cache.miss`.
`key`	string	Cache key that was missed.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "cache.miss",
  "key": "users:123",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

Database

db.executed

A Laravel database query. SQL literals are replaced with ?.

Field	Type	Description
`event_type`	string	Allowed value: `db.executed`.
`connectionName`	string	Database connection name, e.g. "mysql", "pgsql".
`sql`	string	Sanitized SQL with literals replaced by ?.
`duration`	number	Duration in microseconds. The client sends a value with an ms suffix, such as "5.123ms". The ingestion pipeline converts it to microseconds.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "db.executed",
  "connectionName": "mysql",
  "sql": "select * from `users` where `id` = ? limit ?",
  "duration": 2340,
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

db.transaction.committed

A database transaction was committed.

Field	Type	Description
`event_type`	string	Allowed value: `db.transaction.committed`.
`connectionName`	string	Database connection name.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "db.transaction.committed",
  "connectionName": "mysql",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

db.transaction.rolledback

A database transaction was rolled back.

Field	Type	Description
`event_type`	string	Allowed value: `db.transaction.rolledback`.
`connectionName`	string	Database connection name.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "db.transaction.rolledback",
  "connectionName": "mysql",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

db.transaction.started

A database transaction was started.

Field	Type	Description
`event_type`	string	Allowed value: `db.transaction.started`.
`connectionName`	string	Database connection name.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "db.transaction.started",
  "connectionName": "mysql",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

HTTP client

response.received

Laravel's HTTP client received a response.

Field	Type	Description
`event_type`	string	Allowed value: `response.received`.
`uri`	string	URL of the outbound request.
`statusCode`	integer	HTTP response status code.
`duration`	number	Duration in microseconds. The client sends a value with an ms suffix, such as "5.123ms". The ingestion pipeline converts it to microseconds.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "response.received",
  "uri": "https://api.example.com/v1/payments",
  "statusCode": 200,
  "duration": 87000,
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

Mail

mail.sending

A mail message is about to be sent.

Field	Type	Description
`event_type`	string	Allowed value: `mail.sending`.
`to`	string \| null	Comma-separated recipient addresses. Null when none are set.
`subject`	string \| null	Email subject. Null when not set.
`cc`	string \| null	Comma-separated CC addresses.
`bcc`	string \| null	Comma-separated BCC addresses.
`replyTo`	string \| null	Comma-separated reply-to addresses.
`queue`	string \| null	Queue name if the mail was queued.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "mail.sending",
  "to": "user@example.com",
  "subject": "Welcome to Example App",
  "cc": "manager@example.com",
  "bcc": "audit@example.com",
  "replyTo": "support@example.com",
  "queue": "default",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

mail.sent

A mail message was sent.

Field	Type	Description
`event_type`	string	Allowed value: `mail.sent`.
`to`	string \| null	Comma-separated recipient addresses. Null when none are set.
`subject`	string \| null	Email subject. Null when not set.
`cc`	string \| null	Comma-separated CC addresses.
`bcc`	string \| null	Comma-separated BCC addresses.
`replyTo`	string \| null	Comma-separated reply-to addresses.
`queue`	string \| null	Queue name if the mail was queued.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "mail.sent",
  "to": "user@example.com",
  "subject": "Welcome to Example App",
  "cc": "manager@example.com",
  "bcc": "audit@example.com",
  "replyTo": "support@example.com",
  "queue": "default",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

Notifications

notification.failed

A notification failed to send.

Field	Type	Description
`event_type`	string	Allowed value: `notification.failed`.
`notification`	string	Notification class name.
`channel`	string	Channel that failed.
`notifiable`	string	Notifiable class name.
`queue`	string \| null	Queue name if queued.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "notification.failed",
  "notification": "App\\Notifications\\InvoicePaid",
  "channel": "mail",
  "notifiable": "App\\Models\\User",
  "queue": "default",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

notification.sending

A notification is about to be sent.

Field	Type	Description
`event_type`	string	Allowed value: `notification.sending`.
`notification`	string	Notification class name.
`channel`	string	Channel the notification is sent through, e.g. "mail", "slack".
`notifiable`	string	Notifiable class name (the recipient model).
`queue`	string \| null	Queue name if the notification was queued.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "notification.sending",
  "notification": "App\\Notifications\\InvoicePaid",
  "channel": "mail",
  "notifiable": "App\\Models\\User",
  "queue": "default",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

notification.sent

A notification was sent.

Field	Type	Description
`event_type`	string	Allowed value: `notification.sent`.
`notification`	string	Notification class name.
`channel`	string	Channel used.
`notifiable`	string	Notifiable class name.
`queue`	string \| null	Queue name if queued.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "notification.sent",
  "notification": "App\\Notifications\\InvoicePaid",
  "channel": "mail",
  "notifiable": "App\\Models\\User",
  "queue": "default",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

Queue

job.processed

A Laravel queue job finished processing.

Field	Type	Description
`event_type`	string	Allowed value: `job.processed`.
`connectionName`	string	Queue connection name, e.g. "redis", "database".
`job`	string	Resolved job class name.
`id`	string	Job ID.
`attempts`	integer	Number of attempts made.
`hasFailed`	boolean	Whether the job was marked as failed.
`isReleased`	boolean	Whether the job was released back to the queue.
`isDeleted`	boolean	Whether the job was deleted from the queue.
`maxTries`	integer \| null	Maximum retry attempts allowed.
`maxExceptions`	integer \| null	Maximum exceptions before the job is failed.
`timeout`	integer \| null	Job timeout in seconds.
`retryUntil`	integer \| null	Timestamp after which the job should not be retried.
`duration`	number	Duration in microseconds. The client sends a value with an ms suffix, such as "5.123ms". The ingestion pipeline converts it to microseconds.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "job.processed",
  "connectionName": "redis",
  "job": "App\\Jobs\\SendWelcomeEmail",
  "id": "9c2e1f7a-3b4d-4e5f-8a6b-1c2d3e4f5a6b",
  "attempts": 1,
  "hasFailed": false,
  "isReleased": false,
  "isDeleted": true,
  "maxTries": 3,
  "maxExceptions": 3,
  "timeout": 60,
  "retryUntil": 1781272800,
  "duration": 312000,
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

job.queued

A Laravel job was pushed onto a queue. Requires Laravel 8.24+.

Field	Type	Description
`event_type`	string	Allowed value: `job.queued`.
`connectionName`	string	Queue connection name.
`job`	string	Job class name.
`id`	string	Job ID.
`queue`	string \| null	Queue name, if available.
`delay`	integer \| null	Delay in seconds before the job becomes available.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "job.queued",
  "connectionName": "redis",
  "job": "App\\Jobs\\SendWelcomeEmail",
  "id": "9c2e1f7a-3b4d-4e5f-8a6b-1c2d3e4f5a6b",
  "queue": "default",
  "delay": 30,
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

Redis

redis.executed

A Redis command was executed.

Field	Type	Description
`event_type`	string	Allowed value: `redis.executed`.
`connectionName`	string	Redis connection name.
`command`	string	Formatted Redis command with parameters.
`duration`	number	Duration in microseconds. The client sends a value with an ms suffix, such as "5.123ms". The ingestion pipeline converts it to microseconds.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "redis.executed",
  "connectionName": "default",
  "command": "get users:123",
  "duration": 450,
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

Request

request.handled

A Laravel controller handled an HTTP request.

Field	Type	Description
`event_type`	string	Allowed value: `request.handled`.
`uri`	string	Full request URL.
`method`	string	HTTP method, e.g. "GET", "POST".
`statusCode`	integer	HTTP response status code.
`duration`	number	Duration in microseconds. The client sends a value with an ms suffix, such as "5.123ms". The ingestion pipeline converts it to microseconds.
`controller`	string \| null	Controller class name. Null for closure routes or when no route was matched.
`action`	string \| null	Controller action method name. Null when no route was matched.
`routeName`	string \| null	Name of the matched route. Null when the route is unnamed or no route was matched.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "request.handled",
  "uri": "https://app.example.com/users/123",
  "method": "GET",
  "statusCode": 200,
  "duration": 124000,
  "controller": "App\\Http\\Controllers\\UserController",
  "action": "show",
  "routeName": "users.show",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}

Routing

route.matched

Laravel matched a route before running the controller.

Field	Type	Description
`event_type`	string	Allowed value: `route.matched`.
`uri`	string	Route URI pattern, e.g. "users/{id}".
`methods`	string	Comma-separated HTTP methods the route accepts.
`handler`	string	Controller@method string or closure class name.
`name`	string \| null	Named route, if defined.
`requestId`	string	Correlation ID for the request, set by the AssignRequestId middleware via Laravel's shared log context. The value comes from the Request-Id or X-Request-Id request header, or is a generated UUID. Present only when that middleware is enabled.

Example

{
  "event_type": "route.matched",
  "uri": "users/{id}",
  "methods": "GET,HEAD",
  "handler": "App\\Http\\Controllers\\UserController@show",
  "name": "users.show",
  "requestId": "f3b2c1d0-4e5a-4b6c-8d7e-9f0a1b2c3d4e"
}