plunkettscott/laravel-otel

Instant OpenTelemetry instrumentation for Laravel applications.

OpenTelemetry for Laravel

This package provides an OpenTelemetry integration for Laravel applications. It is based on the OpenTelemetry PHP project and provides instrumentation for a number of Laravel components.

Important Note

This package currently relies on a beta release of the OpenTelemetry PHP project.

We will keep the OpenTelemetry PHP dependency up-to-date as new releases are made available. However, we cannot guarantee that this package will work with future versions of OpenTelemetry PHP without breaking changes.

Watchers

This package is currently in development and contains the following Watchers:

• Incoming HTTP Requests
• HTTP Client Requests
• Database Queries
• Redis Commands
• Queued Jobs
• Events
• Event Listeners
• Cache Commands
• View Rendering (Exploring Capabilities)
• Exceptions
• Log Messages
• Scheduled Tasks

Requirements

• PHP 8.2+
• Laravel 10.0+

Installation

You can install the package via composer:

composer require plunkettscott/laravel-otel

Usage

1. Install the package

composer require plunkettscott/laravel-otel

2. Execute the otel:install command

php artisan otel:install

3. Configure the methods in app/Providers/OtelServiceProvider.php to suit your needs

4. Configure the watchers in config/otel.php to suit your needs. See the documentation for more information.

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email oss (at) scottplunkett.com instead of using the issue tracker.

Credits

• Scott Plunkett
• All Contributors

License

The MIT License (MIT). Please see License File for more information.

laravel-otel's Issues

documentation link doesn't work

i try to reach the docs links for the package but it doesn't work
which is
https://oss.plunkett.dev/laravel-otel

Deprecation notice in str_starts_with from trace middleware

Enabling the trace middleware on an unnamed route leads to the deprecation notice: str_starts_with(): Passing null to parameter #1 ($haystack) of type string is deprecated in ...\vendor\laravel\framework\src\Illuminate\Support\Str.php on line 1095"