Automatic instrumentation

If you’re using Laravel or Lumen, Honeybadger provides automatic instrumentation to capture events from your apps. By default, we’ll record:

• Log events
• View renders
• Email dispatches
• Job dispatches
• Notification dispatches
• Database queries
• Redis commands
• Incoming requests

See the Laravel event reference for every event the package emits, with field schemas and types.

You can customise this with the events option in your config/honeybadger.php:

    'events' => [
        'enabled' => true,

        'automatic' => [
            Events\DatabaseQueryExecuted::class,
            Events\DatabaseTransactionStarted::class,
            Events\DatabaseTransactionCommitted::class,
            Events\DatabaseTransactionRolledBack::class,
            Events\CacheHit::class,
            Events\CacheMiss::class,
            Events\JobQueued::class,
            Events\MailSending::class,
            Events\MailSent::class,
            Events\MessageLogged::class,
            Events\NotificationSending::class,
            Events\NotificationSent::class,
            Events\NotificationFailed::class,
            Events\RedisCommandExecuted::class,
            Events\RouteMatched::class,
            Events\ViewRendered::class,
        ],
    ],

The events.automatic key contains the list of the events Honeybadger tracks by default. You can disable a specific event by removing or commenting out the appropriate line.

Managing event volume

If some events are noisy or you’d like to reduce quota consumption:

• Filtering events — inspect, modify, or drop events with a callback.
• Sampling events — send only a percentage of events.

Sending your own events

Automatic instrumentation covers the framework events the package knows about. To send your own application events, see Sending custom events.