Search by

antlerslabs / runes-laravel

eXeis-ixt

Laravel SDK for Runes error tracking

Package info

github.com/AntlersLabs/runes-sdk

Homepage

pkg:composer/antlerslabs/runes-laravel

Statistics

Installs: 3

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.1.0 2026-11-16 06:44 UTC

This package is auto-updated.

Last update: 2026-11-16 06:47:46 UTC


README

Laravel SDK for Runes error tracking.

It reports unhandled exceptions, queue job failures, request context, users, breadcrumbs and releases to your Runes project.

Requirements

  • PHP 8.2+
  • Laravel 11, 12 or 13

Installation

composer require antlerslabs/runes-laravel

When developing against the Runes monorepo, add a path repository to the consumer application first:

{
    "repositories": [
        {
            "type": "path",
            "url": "../runes/packages/runes-laravel",
            "options": {
                "symlink": true
            }
        }
    ]
}

Then install:

composer require antlerslabs/runes-laravel:@dev

Configure

Add the DSN from your Runes project settings to .env:

RUNES_DSN=https://PUBLIC_KEY@runes.astronxs.com/PROJECT_ID
RUNES_ENVIRONMENT=production
RUNES_RELEASE=v1.0.0
RUNES_SAMPLE_RATE=1.0
RUNES_SEND_DEFAULT_PII=false

Clear the config cache after changing the environment:

php artisan config:clear

The SDK registers itself through Laravel package discovery. No provider registration is required.

Optional config

Publish the config file to customise sampling, ignored exceptions and PII:

php artisan vendor:publish --tag=runes-config

Manual reporting

The Runes facade is available automatically:

use Runes\Laravel\Facades\Runes;

Runes::captureException($exception);

Runes::captureMessage('Checkout failed', 'warning', [
    'order_id' => $order->id,
]);

What is captured

  • Unhandled exceptions via Laravel's exception handler
  • Queue job exceptions
  • Request URL and method
  • Authenticated user ID
  • Recent log breadcrumbs
  • Environment, release, PHP and Laravel versions

Request headers are scrubbed for credentials and session data. User email, name, request bodies and query strings are excluded unless RUNES_SEND_DEFAULT_PII=true.

Verify the connection

php artisan tinker --execute 'report(new RuntimeException("Runes connection test"));'

Then check the project's Issues page in Runes.

Enable RUNES_DEBUG=true to log SDK delivery failures.

License

MIT