talaria / laravel
Laravel adapter for Talaria — exceptions, request/DB/queue/HTTP/Artisan tracing, Octane, Horizon, and Livewire
Requires
- php: ^8.1
- illuminate/support: ^10.0 || ^11.0 || ^12.0
- talaria/talaria: ^3.0
Requires (Dev)
- orchestra/testbench: ^8.0 || ^9.0 || ^10.0
- phpunit/phpunit: ^10.5 || ^11.0
Suggests
- laravel/horizon: Queue worker spans with Horizon-specific attributes
- laravel/octane: Flush and reset Talaria between requests on long-lived workers
- livewire/livewire: Component-name child spans under the HTTP transaction
Provides
None
Conflicts
None
Replaces
None
README
Laravel 10 / 11 / 12 adapter for Talaria.
Docs: Laravel guide · Project configuration
Install
PHP 8.1+ and Laravel 10, 11, or 12.
composer require talaria/laravel:^3.0
Set a secret key. Leave TALARIA_URL empty to use https://ingest-<cell>.newtalaria.com from that key:
TALARIA_API_KEY=tal_sk_prod_nz1_… TALARIA_BROWSER_API_KEY=tal_pk_prod_nz1_… TALARIA_RELEASE=1.4.2
TALARIA_RELEASE is optional. In GitHub Actions or GitLab the SDK sends <ref>@<shortsha> when it is unset. See Releases.
Do not call Talaria::init() yourself. Tracing and analytics follow Project settings. A malformed key fails fast. An empty key leaves the client disabled.
HTML responses on the web middleware group load @newtalaria/browser from jsDelivr (TALARIA_BROWSER_SDK_VERSION, default 0.6.0). Replay, heatmaps, and web vitals start only when the project allows them. Set TALARIA_BROWSER=false to skip the script. The injected key is browser_api_key (TALARIA_BROWSER_API_KEY) and must be a tal_pk_ key. The server tal_sk_ key is not injected.
License
MIT